← ClaudeAtlas

plan-generatorlisted

docs/PRD.md·docs/TRD.md·docs/ARCHITECTURE/ 를 읽고 프로젝트 전체 마스터 플랜을 plan_setup/ 아래에 만든다. PLAN.md(전체 지도), phase-NN/phase-NN-<이름>.md(검증 가능한 단계), phase-NN-tasks/phase-NN-task-MM.md(YAML frontmatter를 가진 실제 작업 단위), STATE.md(지금 어디인가), LOG.md(무슨 일이 있었는가)를 생성하고, PRD 추적표의 '담당 태스크' 열을 채우며, 차단 미결·미해소 충돌에 걸린 태스크를 blocked 로 표시한다. 사용자가 "개발 계획 세워줘", "태스크 나눠줘", "플랜 짜줘", "phase 구성해줘", "뭐부터 만들지 정해줘", "작업 목록 만들어줘", "마스터 플랜 만들어줘"라고 하거나, 아키텍처 검토를 마치고 다음 단계로 넘어갈 때 반드시 이 스킬을 사용한다. 설계 문서는 있는데 무엇부터 구현할지가 문서로 없는 상태에서 코드를 짜기 시작하거나 하네스·개발 루프를 세우려 할 때도 이 스킬로 먼저 플랜을 고정한다. plan_setup/ 이 이미 있고 루프가 "수용 기준을 다시 써야 한다", "태스크를 추가해야 한다", "판정 불가"로 돌려보냈을 때도 이 스킬(10단계 부분 갱신)이다.
GangJaeYu/harness_loop_full_korean · ★ 2 · Testing & QA · score 75
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 가