issue-loop

/issue-loop

/spec → /implement-issue → /review-pr을 매번 세션을 열어 돌리는 대신, 루프 드라이버가 GitHub 상태를 읽고 각 걸음을 새 서브에이전트에 위임해 자동 반복한다. 원본의 원칙 유지: ① 이슈 1개 = 세션 1개, ② 리뷰는 구현과 다른 세션 (둘 다 걸음별 독립 서브에이전트로 자동 충족), ③ 설계 분해안·UI 시안 승인과 risk:high 머지는 언제나 사람 — 일반 머지는 기본 모드에선 사람이 결정하고 루프가 실행, 무인 모드에선 강화 리뷰가 대신한다.

Usage

/issue-loop                      # 이어하기: GitHub 상태를 읽고 루프 시작/재개
/issue-loop "<기능 설명>"         # 설계부터: spec(분해안·UI 시안 승인은 사람) → 이슈 등록 → 루프
/issue-loop <상위 이슈 번호>       # 특정 기능([Feature] 이슈)으로 범위 제한
/issue-loop --label <태그>        # 내가 붙인 태그가 있는 이슈만 (ai-task와 AND) — 범위 내 전부 완료가 목표
/issue-loop --once               # 한 걸음만 진행하고 종료
/issue-loop --status             # 상태판 + 다음 계획만 출력 (dispatch 없음)
/issue-loop --max N              # 걸음 수 안전상한 (기본: max(20, 범위 내 이슈 수 × 4))
/issue-loop --unattended         # 완전 무인: agent:auto 이슈만 · 질문 대신 건너뜀 · 강화 리뷰 통과 PR 자동 머지
/issue-loop --economy            # 한도 절약: 구현을 전부 sonnet으로 (리뷰·설계는 opus 유지)
/issue-loop --usage-guard N      # 사용량 추정치가 N% 넘으면 걸음 경계에서 우아하게 중단 (기본 90, ccusage 필요)

0. 사전 확인 (매 실행 첫 단계)

1. git rev-parse --show-toplevel이 현재 디렉토리와 같은지 — 아니면 대상 저장소 루트로 이동을 안내하고 중단
2. gh auth status 통과 여부
3. .claude/commands/implement-issue.md·.claude/commands/review-pr.md 존재 여부 — 없으면 issue-template install.sh 실행을 안내하고 중단 (서브에이전트가 이 파일들을 계약서로 읽는다)
4. --label <태그>가 주어졌으면: gh label list에 그 태그가 존재하는지, 그 태그가 붙은 열린 ai-task 이슈가 1개 이상인지 확인 — 없으면 오타 가능성을 알리고 중단 (조용히 빈 루프를 돌지 않는다)
5. 판정 라벨 존재 보장: review:approved·review:rejected·needs-respec는 루프의 상태 원본이다 — gh label list에 없으면 즉시 생성한다 (gh label create <이름> --color <색> 2>/dev/null || true). 없는 채로 돌면 판정 라벨이 안 붙어 같은 PR을 무한 재리뷰한다
6. 브랜치 보호 확인 (1인 개발 감지): gh api "repos/{owner}/{repo}/branches/<기본브랜치>/protection/required_pull_request_reviews" --jq .required_approving_review_count 2>/dev/null — 값이 1 이상이면, 자기 PR을 자기가 승인할 수 없으므로 1인 리포에선 라벨 승인만으로 gh pr merge가 거부된다고 루프 시작 전에 경고한다 (보호 규칙 완화 / 머지는 사람이 GitHub에서 직접 — 중 택일 안내). 조회 실패(보호 없음 404·권한 부족)는 조용히 건너뛴다
7. 저널 디렉토리 준비: mkdir -p .claude/issue-loop 하고, .gitignore에 .claude/issue-loop/가 없으면 추가 (저널은 로컬 상태 — 커밋 금지). 반대로 .design/과 docs/design/은 커밋 대상이다 — 이슈가 참조하는 계약물이므로 gitignore에 넣지 않는다
8. 저널 마지막에 ⏸ INTERRUPTED 블록이 있으면 그 내용을 사용자에게 요약해 보여주고 이어서 진행 (상태 원본은 GitHub이므로 저널은 참고 컨텍스트일 뿐 — 재개는 항상 GitHub 상태 재수집으로 시작한다)