/codeloop — AI 자율 개발 루프 제어

인자로 start, stop, status 중 하나를 받는다. 인자 없으면 status로 동작한다.

start

루프를 시작한다. codeloop.yaml이 프로젝트 루트에 있어야 한다.

실행 절차

1. codeloop.yaml 존재 확인
   • 없으면: "codeloop.yaml not found — run /codeloop-init first." 출력 후 중단
2. codeloop.yaml에서 설정 읽기:
   • prompt: PROMPT.md 경로
   • model: Claude 모델 (opus/sonnet/haiku)
   • gates: 완료 조건 목록
   • project.name: 프로젝트 이름
3. PROMPT.md 읽기
4. .claude/codeloop.state.md 상태 파일 생성:

   ---
   active: true
   iteration: 0
   started_at: "{현재 ISO 8601 시각}"
   config: "codeloop.yaml"
   ---
   
   {PROMPT.md 전문}
   

5. 사용자에게 안내 메시지 출력:

   🚀 codeloop 루프 시작
   ─────────────────────────
   프로젝트: {project.name}
   모델: {model}
   게이트: {gates 목록}
   프롬프트: {prompt 경로}
   ─────────────────────────
   ⚠️  --dangerously-skip-permissions 모드로 실행됩니다.
   중지하려면: /codeloop stop
   

6. 사용자에게 안내:

   ⚠️  루프 실행은 별도 터미널에서 ./start.sh 로 실행하세요.
   이 세션에서는 루프가 유지되지 않습니다.
   

   사용자가 이 세션에서 직접 실행을 원하면:

   claude --dangerously-skip-permissions --model {model} -p "$(cat .claude/codeloop.state.md)"
   

중요

• Stop Hook이 매 세션 종료 시 자동으로 usage-gate → gates → dashboard를 실행
• 상태 파일이 존재하는 한 루프가 계속됨
• 모든 게이트가 통과되면 Stop Hook이 상태 파일을 삭제하여 루프 종료

stop

루프를 즉시 종료한다.

실행 절차

1. .claude/codeloop.state.md 삭제
2. 출력:

   ⏹️  codeloop 루프 종료
   

3. 상태 파일이 없으면:

   ℹ️  실행 중인 루프가 없습니다.
   

status

현재 루프 상태를 표시한다.

실행 절차

1. .claude/codeloop.state.md 존재 확인
   • 없으면: "ℹ️ 실행 중인 루프가 없습니다." 출력
2. .claude/loc-status.md 읽기 (대시보드)
3. 상태 요약 출력:

   📊 Codeloop Status
   ─────────────────────────
   프로젝트: {project.name}
   반복: #{iteration}
   Phase: {phase}
   LOC: {current} / {target} ({progress}%)
   API 사용량: 5hr {five_hr}% · Weekly {weekly}%
   게이트: {gate 상태 목록}
   ─────────────────────────
   

4. 대시보드 파일이 없으면 LOC Gate를 직접 실행하여 현재 LOC 표시