# 하네스 + 루프 풀스택 — 스킬 색인

> 플러그인으로 설치했다면 이 파일은 필요 없다. 저장소를 서브모듈이나 clone으로 프로젝트에 넣어 쓸 때의 색인이다.

Claude Code와 Codex에서 요구를 구체화하고 구현·검증까지 자율 진행하는 한국어 스킬 13개다.
사용자 명시 지시가 스킬보다 우선한다.
| 요청 | 읽을 스킬 | 주요 산출물 |
|---|---|---|
| 아이디어 구체화 | skills/idea-brainstorm/SKILL.md | docs/IDEA.md |
| 요구와 완료 기준·시각 디자인 확정 | skills/prd-generator/SKILL.md | docs/PRD.md · 화면 제품의 디자인 정본 |
| 기술 결정 | skills/trd-generator/SKILL.md | docs/TRD.md |
| 구조·흐름 | skills/architecture-generator/SKILL.md | docs/ARCHITECTURE/ |
| 기능 단위 계획 | skills/plan-generator/SKILL.md | plan_setup/ |
| 검증·로컬 환경 준비/갱신 | skills/harness-setup/SKILL.md · skills/harness-update/SKILL.md | harness_setup/ |
| 자율 실행 준비/운용 조정 | skills/loop-setup/SKILL.md · skills/loop-update/SKILL.md | loop_setup/LOOP.md |
| 기존 코드 문서화 | skills/code-to-docs/SKILL.md | 선택 범위의 현행 문서 |
| 행위 보존 리팩토링 | skills/refactor-plan/SKILL.md | 필요한 변경 계획 |
| 기능 추가 | skills/feature-add/SKILL.md | 영향 있는 요구·설계·계획 |
| 버그 수정 | skills/bug-fix/SKILL.md | 수정·회귀 검사·기록 |

선택한 스킬을 읽는다. 관련 없는 스킬과 참고 문서를 한꺼번에 읽지 않는다.
IDEA → PRD → TRD → Architecture → Plan → Harness → Loop 순으로 필요한 결정을 구체화한다.
IDEA·PRD·TRD는 구체성과 사용자 맞춤을 위해 필요한 만큼 사용자에게 묻는다. 한 번에 몇 개씩 선택지·이유·추천안을 붙여 여러 차례 주고받고, 사용자 결정을 가정으로 채워 확정하지 않는다.
Loop 실행 전까지 각 단계는 마칠 때마다 결과(요약·결정·가정·남은 결정)를 보고하고 다음 단계로 이어 진행할지 확인한다. 사용자가 자기 말로 단계별 확인 생략을 지시할 때만 생략하며, '끝까지'·사전 권한·예산 합의나 에이전트가 권해 받은 선택은 근거가 아니다. 빠진 앞 단계는 해당 스킬로 가장 앞 단계부터 진행한다. Loop 시작 후에는 합의 안에서 자율 진행한다.
뒤 단계에서 결정이 바뀌면 영향받는 앞 문서(IDEA 포함)의 해당 부분만 갱신하고 근거를 남긴다. 범위·수용 기준 변경은 사용자에게 묻는다.
화면 제품은 PRD 이후 본격적인 화면 구현·관련 Loop 전에 실제 미리보기를 제시해 사용자에게 디자인 최종 결정을 받는다.
승인 근거·버전·범위·시각 품질 기준은 docs/DESIGN.md 또는 기존 동등 문서에 보존하며 확인된 승인 범위와 시각 보존 수정은 재승인하지 않는다.
이미 정해진 것은 재사용하고 작은 프로젝트는 문서를 간결하게 쓴다.
문서화·버그 수정에 전체 파이프라인을 강제하지 않는다.

Loop 전에 환경·프로젝트를 조사하고 목적·권한·예산·금지 사항·실패 처리 원칙을 합의한다.
실행 환경(Orca / 일반 / Others)은 사용자가 고른다. 사용자가 고른 기존 선택은 이어받고, 없으면 설치 여부를 실제로 확인해 추천과 함께 Loop 전에 묻는다. PRD 합의 항목은 출처를 `(사용자)`·`(에이전트 기본값)`·`(미정)`으로 표시한다. '답이 없으면 기본값으로 하겠다'는 식으로 확인을 생략하지 않고, 답하지 않은 항목은 `(미정)`으로 둔다. 필요한 도구·권한·독립 검증 경로를 미리 준비한다.
제품 Loop는 네 게이트 순서와 별도 세션 task_validation을 유지한다. 독립 작업은 자원·충돌 조건 안에서 병렬로 진행한다.
같은 방식의 수정 3회 안에 풀리지 않으면 자율 분석·새 전략으로 전환하며 누적 이력과 전체 예산을 초기화하지 않는다.
Loop 이후 합의 안에서 질문·수동 조작 없이 구현·검증·복구·최종 보고까지 진행한다.
새 세션은 loop_setup/LOOP.md와 plan_setup/STATE.md에서 합의와 재개 지점을 이어받는다.
부모(조정) 세션이 끊기면 자동으로 이어 가지 않고 멈춘다. Loop 전에 역할별 기본 모델과 사용량 한도 도달 시 처리를 합의한다.
중요한 전환·분석·검증과 채택 증거를 저장해 원 대화 없이 실제 변경과 대조해 재개한다.
권한을 우회하거나 검증 기준을 몰래 낮추지 않는다.
복구 불가능하면 변경·증거·재개 지점을 보존한 미완료 결과를 낸다. 질문 대기로 끝내지 않는다.