2026 년 첫 번째 AI 루프를 구축하는 방법

1npm i -g @randomlabs/slate

1cd /path/to/your/project
2slate

1# AGENTS.md
2
3## 이 코드베이스가 하는 일
4[프로젝트에 대한 한 문단 설명]
5
6## 아키텍처
7- src/api/ — Express API 라우트
8- src/services/ — 비즈니스 로직
9- src/db/ — 데이터베이스 모델 (PostgreSQL via Prisma)
10- tests/ — Jest 테스트 스위트
11
12## 주요 명령어
13- npm test — 전체 테스트 스위트 실행
14- npm run build — TypeScript 컴파일
15- npm run lint — ESLint 검사
16- npm run typecheck — tsc --noEmit
17
18## 규칙
19- 인간 승인 없이 src/billing/ 또는 src/auth/를 수정하지 마세요
20- 작업 완료 표시 전에 항상 테스트를 실행하세요
21- src/utils/errors.ts에 있는 기존 오류 처리 패턴을 사용하세요
22
23## 환경
24- .env.slate에 Slate가 필요한 모든 환경 변수가 있습니다

1/workspace add ./src
2/workspace add ./tests
3/workspace list

1@src/api/routes.ts 를 검토하고 개선 제안을 해주세요

1{
2  "$schema": "https://randomlabs.ai/config.json",
3  "permission": {
4    "*": "allow",
5    "bash": "ask"
6  },
7  "models": {
8    "main": { "default": "anthropic/claude-opus-4.6" },
9    "subagent": { "default": "anthropic/claude-sonnet-4.6" },
10    "search": { "default": "anthropic/claude-haiku-4.5" },
11    "reasoning": { "default": "openai/gpt-5.6" }
12  }
13}

1slate run "테스트 스위트를 실행하고 실패를 모두 수정하세요" --dangerously-skip-permissions --output-format stream-json

1내 전체 코드베이스의 아키텍처를 검토해주세요.
2ARCH.md를 생성하세요:
3- 현재 구조
4- 모듈 간 의존성
5- 개선할 점 3가지
6먼저 @src/ 를 확인한 다음 @tests/ 를 확인하세요

1Slate, 내 코드베이스에서 인증 흐름을 조사하고,
2OAuth2 지원 추가를 위한 계획을 세워주세요.
3@src/auth/ 와 @src/api/routes.ts 를 확인해야 합니다

1아니요, 새 인증 제공자 클래스를 추가하지 마세요.
2src/auth/api-key.ts 에 있는 기존 ApiKeyAuth와 동일한 패턴을 따르게 하세요

1mkdir -p .slate/skills/ci-triage
2touch .slate/skills/ci-triage/SKILL.md

1---
2name: "ci-triage"
3description: "CI 실패를 근본 원인별로 분류하고 쉬운 것에 대한 수정 초안을 작성합니다."
4---
5
6# CI 트라이어지 Skill
7
8## 내가 하는 일
9CI 실행이 실패하면:
101. 테스트 출력 읽기
112. 실패 분류: 환경 문제 / 불안정 테스트 / 실제 버그 / 의존성 업데이트 / 인프라
123. 버그 및 의존성 문제에 대한 수정 초안 작성
134. 환경 및 인프라 문제는 인간에게 에스컬레이션
14
15## 분류 규칙
16- env: 누락된 시크릿, 잘못된 환경 변수 → 인간에게 플래그
17- flake: 코드 변경 없이 재시도 시 통과 → 한 번 재시도 후 이슈 등록
18- bug: 최근 커밋과 관련된 결정적 실패 → 수정 초안 작성
19- dependency: 버전 업데이트와 관련된 실패 → 롤백 PR 초안 작성
20- infra: 타임아웃, OOM, 러너 문제 → 즉시 에스컬레이션
21
22## 수정 패턴
23- 인증 테스트 실패 → 먼저 src/auth/middleware.ts 확인
24- 데이터베이스 테스트 실패 → CI 환경에서 마이그레이션이 실행되었는지 확인
25- E2E 실패 → 최신 스냅샷에 대한 UI 선택자 확인
26
27## 절대 하지 않음
28- 실패하는 테스트 비활성화
29- 묻지 않고 CI 설정 수정
30- src/billing/ 또는 src/payments/ 건드리기
31
32## 상태
33매 실행 후 STATE.md 업데이트:
34- 확인한 파일
35- 수행한 분류
36- 연 PR
37- 에스컬레이션한 항목

1/skills

1@ci-triage 오늘 실패한 테스트를 트라이어지해주세요

1# 루프 상태 — CI 트라이어지
2
3## 마지막 실행
42026-06-28 03:30 UTC — 7개 실패 분류됨, 3개 수정 초안 작성됨, 4개 에스컬레이션됨
5
6## 진행 중
7- claude/fix-auth-token-refresh — 테스트 로컬 통과, CI 대기 중
8- claude/fix-flaky-payment-webhook — 재시도 패턴 적용됨, 모니터링 중
9
10## 완료됨
11- claude/bump-axios-1.7.4 → 병합됨 (CI 통과)
12- claude/lint-fix-pass-june-28 → 병합됨
13
14## 인간에게 에스컬레이션됨
15- src/billing/refund.ts — 테스트가 3가지 방식으로 실패, 근본 원인 불명확
16- ci/staging-runner — 인프라 타임아웃, 코드 문제 아님
17
18## 배운 점
19- 2026-06-27: PowerShell이 이 Windows 러너에서 TLS 1.2 문제 발생. bash 사용.
20- 2026-06-26: tests/e2e/checkout에 Stripe 웹훅 시크릿이 env에 필요함. 없으면 건너뜀.

1## 세션 시작
2항상 STATE.md를 먼저 읽으세요. 마지막 실행이 중단된 지점부터 이어받으세요.
3매 실행 종료 시 STATE.md에 수행한 내용과 다음에 할 일을 업데이트하세요.

1STATE.md를 읽어 이미 시도된 내용을 파악하세요.
2
3마지막 빌드에서 실패한 모든 테스트에 대해 CI 트라이어지 Skill을 실행하세요.
4
5각 실패에 대해:
6- ci-triage Skill 규칙을 사용하여 분류
7- 버그 및 의존성 문제에 대한 수정 초안 작성
8- 환경 및 인프라 문제 에스컬레이션
9
10수정 사항을 실행하세요. 테스트가 통과하는지 확인하세요.
11테스트가 통과하면 → PR을 엽니다.
12테스트가 여전히 실패하면 → STATE.md에 기록하고 중지합니다.
13
14이번 실행에서 완료된 모든 내용으로 STATE.md를 업데이트하세요.
15
16하드 스톱: 최대 8회 시도. 제한에 도달하면 현재 상태를 보고합니다.

1slate --queue loop.md

1slate run "$(cat loop.md)" --output-format stream-json --dangerously-skip-permissions

1name: CI 트라이어지 루프
2on:
3  workflow_run:
4    workflows: ["CI"]
5    types: [completed]
6
7jobs:
8  triage:
9    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
10    runs-on: ubuntu-latest
11    steps:
12      - uses: actions/checkout@v4
13
14      - name: Slate 설치
15        run: npm i -g @randomlabs/slate
16
17      - name: 트라이어지 루프 실행
18        env:
19          SLATE_API_KEY: ${{ secrets.SLATE_API_KEY }}
20        run: |
21          slate run "$(cat loop.md)" \
22            --output-format stream-json \
23            --dangerously-skip-permissions \
24            --workspace ./src \
25            --workspace ./tests

1{
2  "models": {
3    "main": { "default": "anthropic/claude-opus-4.6" },
4    "subagent": { "default": "anthropic/claude-sonnet-4.6" },
5    "search": { "default": "anthropic/claude-haiku-4.5" }
6  }
7}

1실패하는 인증 테스트를 수정해주세요.
2
31단계: 검색 에이전트가 src/auth/를 탐색하여 현재 구현을 이해하게 하세요.
42단계: 별도의 에이전트가 발견된 내용을 기반으로 수정을 구현하게 하세요.
53단계: 세 번째 에이전트가 원래 테스트 요구 사항에 대해 수정을 검증하게 하세요 —
6        이 에이전트는 구현을 보지 않아야 합니다.
74단계: 검증자가 승인할 때만 PR을 여세요.

1당신은 다중 세션 루프를 실행하고 있습니다.
2
3목표: 모든 Express 라우트를 새 ApiError 패턴으로 마이그레이션하세요.
4STATE.md에서 진행 상황을 추적하세요.
5
6각 세션 시작:
71. STATE.md 읽기
82. "남은 라우트"에서 첫 번째 미완료 항목 찾기
93. 해당 항목만 수행
10
11각 세션 종료:
121. 완료된 항목을 STATE.md의 "완료된 라우트"로 이동
132. "차단 항목"에 차단 요인 기록
143. "마지막 실행" 타임스탬프 업데이트
154. 깔끔하게 중지
16
17STATE.md 형식:
18---
19## 완료된 라우트
20- [x] /api/users (2026-06-27)
21- [x] /api/auth/login (2026-06-28)
22
23## 남은 라우트
24- [ ] /api/payments/checkout
25- [ ] /api/payments/refund
26- [ ] /api/admin/users
27
28## 차단 항목
29- /api/payments/refund — 인간 검토 필요 (결제 로직 관련)
30
31## 마지막 실행
322026-06-28 14:30 UTC
33---
34
35하드 규칙:
36- 인간 승인 없이 src/billing/ 건드리지 않음
37- 각 라우트 마이그레이션 후 항상 테스트 실행
38- 세션당 하나의 라우트만 완료 후 중지

1slate --continue "$(cat loop.md)"

1{
2  "command": {
3    "triage": {
4      "description": "CI 트라이어지 루프 실행",
5      "template": "STATE.md 읽기. 실패한 모든 테스트에 대해 ci-triage Skill 실행. 완료되면 STATE.md 업데이트.",
6      "agent": "build"
7    },
8    "review": {
9      "description": "파일의 정확성 검토",
10      "template": "@$ARGUMENTS 를 정확성, 엣지 케이스, 주변 코드와의 일관성에 대해 검토.",
11    },
12    "migrate": {
13      "description": "하나의 라우트를 ApiError 패턴으로 마이그레이션",
14      "template": "STATE.md 읽기. 다음 미완료 라우트를 ApiError 패턴으로 마이그레이션. 테스트 실행. STATE.md 업데이트."
15    }
16  }
17}

1/triage
2/review src/api/payments.ts
3/migrate

1# 트리거
2slate run "$(cat loop.md)" --dangerously-skip-permissions --output-format stream-json
3
4# 또는 GitHub Actions에서 — 위 6단계 참조

1# morning brief용 loop.md
2cat > morning-brief-loop.md << 'EOF'
3지난 24시간 동안의 다음 항목을 읽으세요:
4- git log --since="24 hours ago" --oneline
5- 초안 또는 검토 중인 공개 PR
6- 지난 24시간 동안 열리거나 업데이트된 GitHub 이슈
7
8아침 브리핑을 작성하세요:
9- 발생한 가장 중요한 일 3가지
10- 오늘 주의가 필요한 일 2가지
11- 누군가를 차단할 위험이 있는 일 1가지
12
13120단어 미만으로 유지하세요. #engineering Slack 채널에 게시하세요.
14EOF
15
16# cron으로 스케줄 실행
170 7 * * 1-5 slate run "$(cat morning-brief-loop.md)" --dangerously-skip-permissions

1cat > deps-loop.md << 'EOF'
2STATE.md 읽기.
3
4실행: npm outdated
5
6각 오래된 패키지에 대해:
71. 버전 업데이트가 메이저(호환성 깨짐)인지 마이너/패치(안전)인지 확인
82. 마이너/패치: 패키지 업데이트, npm test 실행
93. 테스트 통과: PR 열기
104. 테스트 실패: STATE.md에 "인간 검토 필요"로 기록
115. 메이저 업데이트: 항상 인간에게 에스컬레이션
12
13하드 규칙:
14- 단일 루프에서 5개 이상의 패키지 업데이트 금지
15- "피어 의존성" 섹션의 패키지 업데이트 금지
16- 각 업데이트 후 관련 테스트뿐만 아니라 전체 테스트 스위트 실행
17- 업데이트된 내용과 에스컬레이션된 내용으로 STATE.md 업데이트
18EOF
19
20# 매주 월요일 실행
210 9 * * 1 slate run "$(cat deps-loop.md)" --dangerously-skip-permissions

1중지 조건: tests/auth/ 의 모든 테스트 통과 AND lint가 0 반환.
2에이전트 자체 판단이 아닌 별도의 검사 실행을 사용하여 확인하세요.
3하드 리미트: 8회 반복. 제한 도달 시: 상태 보고 후 중지.

1# VISION.md — 매 세션 시작 시 읽기
2
3## 핵심 목표
4모든 Express 라우트를 ApiError 패턴으로 마이그레이션.
5
6## 하드 제약 조건 (절대 위반 금지)
7- 인간 승인 없이 src/billing/ 건드리지 않음
8- 실패하는 테스트 비활성화 금지
9- PR을 열기 전에 항상 전체 테스트 스위트 실행
10
11## 현재 우선순위
12src/api/payments/ 의 라우트 — 특별히 주의하여 처리

1검증자 에이전트는 구현 에이전트의 작업을 보면 안 됩니다.
2오직 다음만 볼 수 있습니다: 원래 테스트 요구 사항과 테스트 출력.
3테스트 통과 → 승인. 테스트 실패 → 거부. 그 외 의견 없음.

1완료 조건: npm test가 종료 코드 0을 반환 AND npm run lint가 종료 코드 0을 반환.
2"테스트가 괜찮아 보일 때"가 아닙니다. "대부분의 테스트가 통과할 때"가 아닙니다.
3두 명령어 모두 종료 코드 0. 그것이 유일한 완료 조건입니다.

1[Slate가 마이그레이션 작업 중...]
2
3당신: 아, 새 패턴이 userId가 null인 경우도 처리하는지 확인하세요
4[Tab — 큐에 넣음]
5
6[Slate가 현재 단계를 완료한 후, 큐에 넣은 메시지를 읽음]

1[Slate가 수정 구현을 반쯤 진행 중...]
2
3당신: 잠깐만요 — 이걸 위해 새 클래스를 추가하지 마세요. src/utils/errors.ts의 기존 BaseError를 사용하세요.
4[Enter — 즉시 방향 전환]
5
6Slate: 알겠습니다, BaseError를 사용하도록 전환합니다...

1!npm test          # 테스트 실행하고 출력을 Slate로 보내기
2!git diff HEAD     # 변경 사항 확인
3!git status        # 현재 상태 확인

1# 터미널 1 — 서버 시작
2slate serve --port 7777
3
4# 터미널 2 — TUI 연결
5slate attach http://localhost:7777 --dir /path/to/project

1□ npm i -g @randomlabs/slate 설치 완료
2□ AGENTS.md 생성됨 (프로젝트 개요, 명령어, 규칙 포함)
3□ slate.json 생성됨 (권한 및 모델 설정 포함)
4□ 단일 수동 실행 완료 및 안정성 확인됨
5□ 첫 번째 반복 작업에 대한 SKILL.md 작성됨
6□ STATE.md 생성됨 및 AGENTS.md에서 참조됨
7□ 명시적 중지 조건이 포함된 loop.md 작성됨
8□ 반복 횟수 하드 리미트 (시작 시 최대 8회)
9□ 검증자는 메이커와 동일한 에이전트가 아님
10□ 되돌릴 수 없는 작업(PR, 배포)에 대한 인간 검토 게이트