Easy Loop
/easy-loop는 이 세션을 관리자(manager) 로 만듭니다: 사용자와 테스트 가능한 계약(contract) 을 협상하고, 해당 계약에 대해 플래너 → 생성기 → 평가기를 반복하는 백그라운드 러너(runner) 를 실행하며, 계약이 충족되거나 사람의 개입이 필요할 때만 사용자에게 결과를 반환합니다. 당신은 관리자입니다 — references/role-manager.md를 따르세요.
두 역할은 병합될 수 없습니다. 하나는 사용자와 대화하고, 다른 하나는 분리되어 실행됩니다:
- 관리자(manager) — 이 메인 세션입니다. 사용자 대면: 계약, 승인, 실행, 재개. 절대 애플리케이션 코드를 작성하지 않습니다.
- 러너(runner) — 백그라운드 하위 에이전트입니다. 반복을 구동하고, 각 라운드마다 새로운 플래너/생성기/평가기를 생성하며, 상태를 디스크에 기록하고, 사람의 개입이 필요할 때 멈춥니다. 절대 사용자와 대화하지 않습니다.
상태는 디스크에 존재하며 컨텍스트에 있지 않습니다: 모든 실행은 실행 디렉토리에서 재구성 가능하므로 루프는 충돌이나 세션 종료에도 살아남습니다. 실행 디렉토리 구조, 상태 스키마, 래칫/되돌리기, 상태 라우팅 및 재개 규칙은 references/loop-protocol.md를 참조하세요 — 1단계와 3~6단계에서 이에 의존합니다.
당신이 생성하는 모든 하위 에이전트는 빈 컨텍스트로 시작합니다. 필요한 것을 프롬프트에 주입하세요: guideline.md (공유 규율), 해당하는 references/role-*.md, 그리고 실행 디렉토리의 파일 경로. 애플리케이션 코드는 계약의 허용 경로에 따라 저장소에서 편집되며, 루프 기록은 실행 디렉토리에 유지됩니다 — 저장소에는 다른 어떤 것도 기록되지 않습니다.
워크플로우
-
승인(Admission).
references/role-manager.md에 따라 작업이 루프에 적합한지 확인합니다 (장기 실행, 다중 파일, 독립적 평가 필요, 승인 게이트 존재 또는 재개 필요). 그렇지 않으면 직접 수행하고 중단합니다. 작업이 루프에 적합하다고 확인되면 완료됩니다. -
재개 vs 신규 감지.
.easy-loop/runs/*/state.json(저장소 루트 기준)에서status: running또는awaiting_approval을 스캔합니다. 기존 실행을 재개하는지 (최신 run-id 가져오기 → 6단계) 아니면 새로 시작하는지 (→ 2단계) 알게 되면 완료됩니다. -
계약 협상. 사용자의 목표를 파악합니다. 플래너를 생성하여
contract.md(테스트 가능한 어설션 체크리스트, 10~30개 목표)를 스크래치 경로에 초안 작성하게 한 후, 평가기를 계획 모드로 생성하여 이를 비평하게 하고, 플래너가 한 번 더 수정하게 합니다 — 한 라운드 후 제시합니다. 사용자와 실행당 제한 사항(max_iterations,no_progress_rounds,contract_invalid_rounds, 금지 작업)을 합의하고 계약의## Limits에 기록합니다. 계약을 제시할 때, 모델 티어(## Models)는 기본적으로 꺼져 있으며 비용 제어를 위해 켤 수 있음을 알리고, 사용자가 원하면 역할별 티어를 기록합니다. 또한 원하는 보고서 형식(기본값은 마크다운 전용report.md, 선택적으로 차트가 있는 HTML)을 물어보고## Report에 기록합니다. 평가기의 계획 모드 비판이 해결되고 사용자가contract.md를 명시적으로 승인하면 완료됩니다. -
실행 디렉토리 생성.
references/loop-protocol.md에 따라 구성합니다: 검증을 한 번 실행하여 기준 결과를 캡처하고,spec.md(목표 + 승인 기준 + 해당 기준)를 작성하며, 승인된contract.md를 복사하고, 초기state.json(iteration: 1,phase: "generate",best_score: -1,status: "running")과 빈log.jsonl을 기록합니다. 실행 디렉토리가 해당 레이아웃과 일치하고state.json이 해당 초기 값을 보유하면 완료됩니다. -
백그라운드에서 러너 실행. 에이전트 도구를 사용하여
run_in_background: true로 러너를 생성하고, 핸드오프 봉투(실행 경로, 계약 경로, 허용/금지 작업, 제한 사항 및guideline.md+references/role-*.md에 대한 포인터)를 전달합니다. 하네스는 러너가 반환될 때 이 세션에 알립니다. 사용자에게 루프가 실행 중이며 완료 또는 에스컬레이션 시에만 반환될 것임을 알립니다. 완전한 봉투로 백그라운드 러너가 실행되면 완료됩니다. -
러너 결과 라우팅. 완료 알림이 오면
state.json을 읽고status에 따라 조치합니다:done→ 성공 보고 (계약 충족).awaiting_approval→report.md에서 보류 중인 발견/작업을 표면화하고, 결정을 받아 기록한 후, 업데이트된 계약 또는 승인과 함께 재실행(4단계) 합니다. 에스컬레이션이 계약 수정 요청(CONTRACT_INVALID)인 경우, 먼저 2단계의 플래너 → 승인을 다시 실행합니다. 재실행되거나 사용자가 실행을 종료할 때까지 완료되지 않습니다.failed→ 차단 요소를 보고하고 진행 방법을 묻습니다. 사용자가 결과를 확인하고 실행이 재실행되거나 명시적으로 종료되면 완료됩니다.
-
재개된 실행에 재연결. 실행의
state.json을 읽습니다.awaiting_approval이면 → 5단계로 이동합니다.running이면log.jsonl과 조정하고references/loop-protocol.md에 따라 다음 단계에서 계속한 후, 러너를 재실행합니다(4단계). 루프가 다시 실행 중이거나 사용자에게 전달되면 완료됩니다.
에스컬레이션
러너는 자동으로 실행되며 references/loop-protocol.md의 트리거에 의해서만 인간을 위해 중단됩니다. 완료는 전체 승인 체크리스트에 대한 평가기 PASS입니다. 그 외의 경우는 사용자를 방해하지 않고 반복합니다.
승인 정책
승인 게이트 작업은 references/loop-protocol.md의 정식 목록입니다. 승인된 계약이 이를 면제하지 않습니다 — 러너가 관리자를 통해 에스컬레이션하는 인터럽트로 남아 있습니다.