plan-generatorlisted
Install: claude install-skill GangJaeYu/harness_loop_full_korean
# 마스터 플랜 작성 (Layer 3)
## 이 스킬의 목적
마스터 플랜은 **"정해진 구조를 어떤 순서로, 어떤 단위로 만들 것인가"**에 대한 합의문이다.
PRD가 약속이고 TRD가 수단이고 아키텍처가 모양이라면, 플랜은 그것을 **실행 가능한 조각으로 자른 것**이다.
여기서 만든 것이 뒤에서 이렇게 쓰인다.
```
태스크 하나 (phase-02-task-03.md)
→ 하네스가 이 태스크를 무엇으로 검증할지 정한다 (Layer 4)
→ 루프가 이 파일 하나를 열어 한 세션 동안 구현한다 (Layer 5)
→ STATE.md 가 갱신되고 LOG.md 에 한 줄이 쌓인다 (Layer 5)
```
그래서 이 문서의 품질은 "계획이 그럴듯한가"가 아니라 세 가지로 판정된다.
1. **태스크 하나가 한 세션에서 끝나고 혼자 검증되는 크기인가**
2. **의존 관계가 정확해서 순서대로 따라가면 막히지 않는가**
3. **아직 정해지지 않은 것 위에 세워진 태스크가 `blocked` 로 드러나 있는가**
세 번째를 놓치면 루프가 그 태스크를 집어 들고, 요구사항이 모호한 채로 구현하고, 검증에서 세 번 실패하고 멈춘다.
**그때 드는 비용은 여기서 `blocked` 한 줄을 쓰는 비용의 수십 배다.**
### 여기서 하는 일과 하지 않는 일
| 하지 않는 것 | 어디서 하는가 |
|---|---|
| 요구사항을 새로 만들거나 우선순위를 바꾸는 것 | PRD (`prd-generator`) — 돌아가서 고친다 |
| 기술을 새로 고르거나 바꾸는 것 | TRD (`trd-generator`) — 돌아가서 고친다 |
| 구조를 정하는 것 (테이블·엔드포인트·화면·계층) | Layer 2 아키텍처 (`architecture-generator`) — 없으면 만들어 오지 말고 되돌려 보낸다 |
| lint·unit test·E2E·task validation의 **구체적 구성**과 실행 방법 | Layer 4 하네스 (`harness-setup`) |
| 루프의 실행 규칙, 실패 재시도 횟수, 워크트리 운용 | Layer 5 (`loop-setup`) |
| 실제 코드 작성, STATE.md·LOG.md의 **갱신** | Layer 5 개발 루프 (예외: 10단계 부분 갱신에서 `Task Status` 행 추가·`Next Action`·LOG 한 줄) |
| **날짜·기간·공수 추정 (몇 주, 몇 시간, 스프린트)** | 아무 데서도 하지 않는다 — 아래를 보라 |
**일정을 만들지 않는다.** 계획을 세우라는 말을 들으면 주차별 일정표를 쓰고 싶어진다. 그러나 이 플랜을 실행하는 것은
사람이 아니라 **한 태스크에 한 세션을 쓰는 에이전트**이고, 그 세션이 몇 분 걸릴지는 아무도 모른다.
문서에 적힌 "2주"는 아무것도 조정하지 못하면서 **틀렸을 때 실패처럼 보이는 숫자**만 남긴다.
순서와 의존은 정하되 시간은 적지 않는다. 진척은 STATE.md 와 LOG.md 가