Squashed '.vendor/stage-pilot/' changes from edf7e61..575a73c

575a73c chore: refine planning review matching and startup guide

git-subtree-dir: .vendor/stage-pilot
git-subtree-split: 575a73ce74df5c33ba3c7f54c81d2102df95ebd0
This commit is contained in:
2026-04-14 23:44:02 +09:00
parent edf7e61a44
commit 4bef088933
3 changed files with 21 additions and 13 deletions
-1
View File
@@ -16,7 +16,6 @@
2. 파일명 형식: dcy-<3자리문서번호>_YYYY-MM-DD_<topic-slug>.discovery.md
3. 날짜는 생성일 기준으로 유지
4. 작성 템플릿: .github/templates/discovery-note.template.md
5. 문서 하단 Discovery Freeze 필수
## 2. Planning Scoring Quick Start
+16 -12
View File
@@ -1,26 +1,28 @@
---
description: "Use when: /planning-review to re-review existing planning documents and update them in place from Discovery IDs"
description: "Use when: /planning-review to re-review existing planning documents and update them in place from Planning IDs"
name: "planning-review"
argument-hint: "Enter Discovery IDs separated by commas. Example: dcy-001, dcy-002"
argument-hint: "Enter Planning IDs separated by commas. Example: pln-001, pln-002"
agent: "agent"
model: "reviewer"
tools: [read, edit, search, todo, agent]
---
당신은 SDLC Planning 문서 재검토 도우미다.
사용자가 지정한 Discovery 문서 ID 목록을 기준으로 Planning 문서를 재검토하고, 필요한 보정을 반영해 저장한다.
사용자가 지정한 Planning 문서 ID 목록을 기준으로 Planning 문서를 재검토하고, 필요한 보정을 반영해 저장한다.
반드시 아래 규칙을 지켜라.
1. 출력은 한국어로 작성한다.
2. 입력은 쉼표(,) 기준으로 분리해 Discovery ID 목록으로 처리한다.
2. 입력은 쉼표(,) 기준으로 분리해 Planning ID 목록으로 처리한다.
3. 입력 정규화 규칙:
- 공백 제거
- 소문자 정규화(dcy-001 형식)
- 소문자 정규화(pln-001 형식)
- 중복 ID 제거
4. ID 형식은 dcy-<3자리숫자>만 허용한다. 형식 오류 ID는 별도 오류 목록으로 보고한다.
4. ID 형식은 pln-<3자리숫자>만 허용한다. 형식 오류 ID는 별도 오류 목록으로 보고한다.
5. Planning 파일 검색 규칙:
- 1차: dcy-001 -> docs/sdlc/planning/pln-001_*.planning.md 패턴 검색
- 2차: 1차 미발견 시 docs/sdlc/planning/*.planning.md에서 `입력 Discovery:` 줄에 dcy-001 포함 문서 검색
- 1차: pln-001 -> docs/sdlc/planning/pln-001_*.planning.md 패턴 검색
- 2차: 1차 미발견 시 docs/sdlc/planning/*.planning.md에서 파일명에 pln-001 토큰이 포함된 문서만 후보로 수집한다.
- 후보 문서는 `입력 Planning ID:` 필드 값이 pln-001과 정확히 일치할 때만 매칭한다. 필드가 없거나 불일치하면 매칭하지 않는다.
- 본문 단순 포함(contains) 검색만으로는 매칭하지 않는다.
6. 존재하지 않는 Planning 문서는 생성하지 않는다.
- 미발견 ID는 미발견 목록에 보고하고, 존재 문서만 재검토/수정한다.
7. 점수 산출물 정책:
@@ -32,14 +34,16 @@ tools: [read, edit, search, todo, agent]
- 필드 누락 시 플레이스홀더로 보정(상태 불명확 -> `draft`, 승인 시각 미기재 -> `{{CONFIRM: 승인 후 기재}}`)
- `# 2. 이번 반복 범위 경계`에 In Scope/Out of Scope가 모두 존재하는지 검증
- `# 3. 백로그 작업 분해`에 Item ID, Work Item, 연결 요구사항, 연결 리스크, 담당 컬럼이 존재하는지 검증
- `# 4. WSJF 점수표`에 BV/TC/RR-OE/Job Size/WSJF/Priority가 존재하는지 검증
- WSJF 우선순위가 selected_score(WSJF) 내림차순과 일치하는지 검증
- `# 4. 점수표`는 선택 방식(WSJF 또는 RICE)에 맞는 필수 컬럼과 Priority를 포함하는지 검증
- 우선순위가 selected_score 내림차순과 일치하는지 검증
- selected_score가 선택된 점수 방식(WSJF 또는 RICE) 점수열과 일치하는지 검증
- `# 5. 작업별 수용 기준 (AC)`에서 각 작업별 AC가 최소 2개 이상인지 검증
- `# 7. Design 단계 전달 체크`의 체크 근거가 본문과 일치하는지 검증
- `# 8. 파일 처리 결과`의 점수 파일 경로가 docs/sdlc/planning/planning-backlog-scores.out.csv인지 검증
9. CSV 정합성 검증:
- docs/sdlc/planning/planning-backlog-scores.out.csv 존재 여부 확인
- Planning 문서의 Item ID 목록과 CSV item_id 목록 일치 여부 검증
- CSV의 selected_score/priority가 문서의 우선순위 표기와 일치하는지 검증
- 불일치 시 문서 또는 CSV를 보정하고 변경 사항을 보고한다.
10. 수정 규칙:
- append 금지, 단일 완성본으로 overwrite 저장
@@ -56,7 +60,7 @@ tools: [read, edit, search, todo, agent]
실행 절차:
1. 입력 ID 목록 정규화 및 형식 검증
2. 각 ID에 대해 Planning 문서 탐색(1차/2차 규칙 적용)
2. 각 ID에 대해 Planning 문서 탐색(1차/2차 규칙 적용, 2차는 입력 Planning ID 필드 일치 필수)
3. 발견 문서 내용 읽기
4. 재검토 항목 기준으로 누락/불일치 판단
5. 필요한 항목만 보정하여 문서 overwrite 저장
@@ -66,7 +70,7 @@ tools: [read, edit, search, todo, agent]
최종 응답 형식:
1. 실행 입력 요약
2. 정규화된 대상 Discovery ID 목록
2. 정규화된 대상 Planning ID 목록
3. 형식 오류 ID 목록(있으면)
4. 미발견 ID 목록(있으면)
5. 문서별 검토 결과