Communitygithub.com

tundergod/easy-loop

Karpathy 스타일의 플래너/생성기/평가기 에이전트 루프를 저장소에서 실행하세요: 관리자가 테스트 가능한 계약을 협상한 후, 재개 가능한 백그라운드 러너를 구동합니다.

easy-loop란 무엇인가요?

Easy Loop는 복잡한 AI 에이전트 워크플로우를 관리하는 강력한 스킬입니다. 이 스킬은 두 가지 역할(매니저와 러너)을 분리하여 사용자와의 상호작용과 백그라운드 실행을 독립적으로 처리합니다. 매니저는 사용자와 계약을 협상하고 승인을 받은 후, 러너가 플래너-생성기-평가기 루프를 반복적으로 실행하여 계약 조건이 충족될 때까지 작업을 진행합니다. 모든 상태는 디스크에 저장되므로 세션 충돌이나 종료에도 복구가 가능하며, 이는 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있습니다. 또한 승인 게이트, 비용 제어 모델 티어, HTML 보고서 등 다양한 고급 기능을 제공하여 복잡한 소프트웨어 엔지니어링 작업을 체계적으로 관리할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add tundergod/easy-loop

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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, 그리고 실행 디렉토리의 파일 경로. 애플리케이션 코드는 계약의 허용 경로에 따라 저장소에서 편집되며, 루프 기록은 실행 디렉토리에 유지됩니다 — 저장소에는 다른 어떤 것도 기록되지 않습니다.

워크플로우

  1. 승인(Admission). references/role-manager.md에 따라 작업이 루프에 적합한지 확인합니다 (장기 실행, 다중 파일, 독립적 평가 필요, 승인 게이트 존재 또는 재개 필요). 그렇지 않으면 직접 수행하고 중단합니다. 작업이 루프에 적합하다고 확인되면 완료됩니다.

  2. 재개 vs 신규 감지. .easy-loop/runs/*/state.json (저장소 루트 기준)에서 status: running 또는 awaiting_approval을 스캔합니다. 기존 실행을 재개하는지 (최신 run-id 가져오기 → 6단계) 아니면 새로 시작하는지 (→ 2단계) 알게 되면 완료됩니다.

  3. 계약 협상. 사용자의 목표를 파악합니다. 플래너를 생성하여 contract.md (테스트 가능한 어설션 체크리스트, 10~30개 목표)를 스크래치 경로에 초안 작성하게 한 후, 평가기를 계획 모드로 생성하여 이를 비평하게 하고, 플래너가 한 번 더 수정하게 합니다 — 한 라운드 후 제시합니다. 사용자와 실행당 제한 사항(max_iterations, no_progress_rounds, contract_invalid_rounds, 금지 작업)을 합의하고 계약의 ## Limits에 기록합니다. 계약을 제시할 때, 모델 티어(## Models)는 기본적으로 꺼져 있으며 비용 제어를 위해 켤 수 있음을 알리고, 사용자가 원하면 역할별 티어를 기록합니다. 또한 원하는 보고서 형식(기본값은 마크다운 전용 report.md, 선택적으로 차트가 있는 HTML)을 물어보고 ## Report에 기록합니다. 평가기의 계획 모드 비판이 해결되고 사용자가 contract.md를 명시적으로 승인하면 완료됩니다.

  4. 실행 디렉토리 생성. references/loop-protocol.md에 따라 구성합니다: 검증을 한 번 실행하여 기준 결과를 캡처하고, spec.md (목표 + 승인 기준 + 해당 기준)를 작성하며, 승인된 contract.md를 복사하고, 초기 state.json (iteration: 1, phase: "generate", best_score: -1, status: "running")과 빈 log.jsonl을 기록합니다. 실행 디렉토리가 해당 레이아웃과 일치하고 state.json이 해당 초기 값을 보유하면 완료됩니다.

  5. 백그라운드에서 러너 실행. 에이전트 도구를 사용하여 run_in_background: true로 러너를 생성하고, 핸드오프 봉투(실행 경로, 계약 경로, 허용/금지 작업, 제한 사항 및 guideline.md + references/role-*.md에 대한 포인터)를 전달합니다. 하네스는 러너가 반환될 때 이 세션에 알립니다. 사용자에게 루프가 실행 중이며 완료 또는 에스컬레이션 시에만 반환될 것임을 알립니다. 완전한 봉투로 백그라운드 러너가 실행되면 완료됩니다.

  6. 러너 결과 라우팅. 완료 알림이 오면 state.json을 읽고 status에 따라 조치합니다:

    • done → 성공 보고 (계약 충족).
    • awaiting_approval → report.md에서 보류 중인 발견/작업을 표면화하고, 결정을 받아 기록한 후, 업데이트된 계약 또는 승인과 함께 재실행(4단계) 합니다. 에스컬레이션이 계약 수정 요청(CONTRACT_INVALID)인 경우, 먼저 2단계의 플래너 → 승인을 다시 실행합니다. 재실행되거나 사용자가 실행을 종료할 때까지 완료되지 않습니다.
    • failed → 차단 요소를 보고하고 진행 방법을 묻습니다. 사용자가 결과를 확인하고 실행이 재실행되거나 명시적으로 종료되면 완료됩니다.
  7. 재개된 실행에 재연결. 실행의 state.json을 읽습니다. awaiting_approval이면 → 5단계로 이동합니다. running이면 log.jsonl과 조정하고 references/loop-protocol.md에 따라 다음 단계에서 계속한 후, 러너를 재실행합니다(4단계). 루프가 다시 실행 중이거나 사용자에게 전달되면 완료됩니다.

에스컬레이션

러너는 자동으로 실행되며 references/loop-protocol.md의 트리거에 의해서만 인간을 위해 중단됩니다. 완료는 전체 승인 체크리스트에 대한 평가기 PASS입니다. 그 외의 경우는 사용자를 방해하지 않고 반복합니다.

승인 정책

승인 게이트 작업은 references/loop-protocol.md의 정식 목록입니다. 승인된 계약이 이를 면제하지 않습니다 — 러너가 관리자를 통해 에스컬레이션하는 인터럽트로 남아 있습니다.

관련 스킬