| name | BeforePlan |
| description | /plan 실행 전 사전 정보를 정리하는 스킬. 사용자와 실시간 대화로 PROMPT/PRD/SPEC 3개 문서를
docs/agents/output/plan/{타임스탬프}/ 에 작성한다. PRD/SPEC은 이후 /plan 모드에 전달된다.
트리거: /BeforePlan, "plan 준비", "사전 계획 문서", "PRD/SPEC 먼저 작성", "/plan 전 정리".
|
BeforePlan — /plan 사전 준비 스킬
목적
순수 /plan 모드에 진입하기 전에, 요구사항을 명확히 정리한 PRD/SPEC을 미리 만들어 둔다.
이렇게 하면 /plan 모드는 잘 정의된 입력 위에서 PLAN(구현 계획) 작성에 집중할 수 있다.
산출물 (3종)
| 문서 | 역할 | 편집 방식 |
|---|
| PROMPT | 사용자와의 대화 기록 (Q&A 로그) | append-only — 그대로 덧붙이기만, 요약/재해석/삭제 금지 |
| PRD | 요구사항 정제본 (성공기준·범위·제약) | 편집 가능 — 사용자 발언에 근거한 갱신은 자유. 발언 없이 임의 변경 금지 |
| SPEC | 기술 명세 (코드 탐색 기반) | 편집 가능 — 기술적 수정은 자율, 근거(파일:라인) 필수 |
- PROMPT는 기록용이며 /plan에 전달하지 않는다. PRD/SPEC만 /plan에 전달한다.
저장 위치 / 명명 규칙
- 폴더:
docs/agents/output/plan/{타임스탬프}/
- 타임스탬프 형식:
yyMMdd_HHmmss (예: 260604_121053)
- 생성 명령으로만 만든다 (추측·임의 입력 금지):
Get-Date -Format "yyMMdd_HHmmss" (PowerShell)
- 스킬 시작 시 1회 생성하여 3개 파일에 일관 적용
- 파일명: 타임스탬프 접두 —
{TS}_PROMPT.md, {TS}_PRD.md, {TS}_SPEC.md
- 예:
260604_121053_PROMPT.md
큰 흐름
1. 타임스탬프 생성 + 폴더 생성
2. 사용자와 대화 → PROMPT(로그)와 PRD(정제본)를 병행 기록
- 종료 게이트: PRD가 빈틈없음 (성공기준·범위·제약이 충분히 채워짐)
3. PRD 기반으로 코드를 직접 탐색하며 SPEC 작성
- 탐색 중 오류/모호 발견 시 아래 "분기 기준"에 따라 처리
4. 종료 조건 충족 시 3개 문서 확정 저장
4.5 PRD/SPEC 규격 검증 (① — PLAN 없음, 아래 "검증 단계(①)" 절)
- ps1 `-Stage prd_spec` → PASS면 plan_format_check `Stage=prd_spec`
- 이상 시 → 종료 조건 미충족으로 보고, 단계 2/3로 돌아가 수정 후 재검증
5. (① 검증 PASS 후) 사용자에게 /plan 실행 안내
- 생성한 `docs/agents/output/plan/{TS}/` 경로와 PRD/SPEC 파일명을 **명시 출력**한다.
- 이 `{TS}` 경로가 MakePlan(/plan)의 입력이며, 세션이 길어져 컨텍스트를 잃을 경우 사용자가 이 경로를 그대로 전달하면 된다고 안내한다.
분기 기준 (SPEC 작성 중 문제 발견 시)
| 상황 | 처리 | 비고 |
|---|
| 코드와 SPEC의 기술적 불일치 (사용자 질문 불필요) | SPEC만 수정 | PROMPT/PRD 변동 없음 |
| 답이 기술 수준인 질문 | 질문 → PROMPT 추가 → SPEC 수정 | PRD 변동 없음 |
| 답이 요구사항을 건드리는 질문 | 질문 → 답변(=근거) → PROMPT 추가 + PRD 수정 → SPEC 수정 | 답변이 곧 근거 |
- 판단 기준: "이게 요구사항(무엇/왜)을 바꾸나?" → 예: PRD 경로 / 아니오: SPEC 경로
- PRD 변경은 사용자 발언이 뒷받침될 때만 한다. 발언이 없으면(코드 탐색 발견 등) 먼저 질문해 답을 받고, 그 답을 근거로 반영한다. 별도 승인 절차는 두지 않는다 — 답변이 곧 승인이다.
종료 조건 (무한 루프 방지)
아래가 모두 충족되면 완료:
- PRD가 빈틈없음 (성공기준·범위·제약)
- SPEC에 코드로 미확인된 빈틈 없음 (모든 주장에 파일:라인 근거)
- 미답 질문 없음
- PRD/SPEC 규격 검증(①) PASS — 주관 판단("빈틈없음")에 더해 객관 게이트로 확인 (아래 "검증 단계(①)")
검증 단계 (①: PRD/SPEC, PLAN 미생성 시점)
3개 문서 저장 후, 사용자에게 안내하기 전에 PRD/SPEC 규격을 기계(ps1) + 에이전트(format_check)로 검증한다.
PLAN은 BeforePlan에서 만들지 않으므로 검증 대상이 아니다 → 항상 Stage=prd_spec.
powershell -ExecutionPolicy Bypass -File .claude/hooks/plan_artifact_check.ps1 -TS {TS} -Stage prd_spec 실행
- ps1이 PRD/SPEC의 존재·타임스탬프·라인 수를 검증하고
{TS}/_verification.txt를 생성한다.
- ps1 PASS면 plan_format_check SubAgent를
Stage=prd_spec로 호출 → PRD/SPEC 필수 섹션·충실도 검증.
- ps1 FAIL이면 2번(섹션 검증)을 건너뛰고 4번으로 간다(fail-fast).
- 둘 다 PASS → 종료 조건 충족. 사용자에게 /plan 안내(큰 흐름 5).
- FAIL → [보완 필요 항목]에 따라 PRD/SPEC을 수정(대화/코드 탐색)하고 1번부터 재검증한다.
- 무한 루프 방지: 동일 FAIL이 반복되면 사용자에게 보고 후 결정 대기.
문서별 상세 작성법 (해당 시점에 참조)
각 문서를 실제로 작성할 때 해당 guide를 읽어 규칙을 따른다.
- PROMPT 작성:
.claude/skills/BeforePlan/references/prompt_guide.md
- PRD 작성:
.claude/skills/BeforePlan/references/prd_guide.md
- SPEC 작성:
.claude/skills/BeforePlan/references/spec_guide.md
