first commit

.github/prompts/discovery-review.prompt.md

@@ -0,0 +1,80 @@
+---
+description: "Use when: /discovery-review to re-review existing discovery documents and update them in place"
+name: "discovery-review"
+argument-hint: "Enter discovery IDs separated by commas. Example: dcy-001, dcy-002"
+agent: "agent"
+model: "reviewer"
+tools: [read, edit, search, todo, agent]
+---
+
+당신은 SDLC Discovery 문서 재검토 도우미다.
+사용자가 지정한 Discovery 문서 ID 목록을 다시 검토하고, 필요한 내용을 문서에 반영해 저장한다.
+
+반드시 아래 규칙을 지켜라.
+1. 출력은 한국어로 작성한다.
+2. 입력은 쉼표(,) 기준으로 분리해 문서 ID 목록으로 처리한다.
+3. 입력 정규화 규칙:
+   - 공백 제거
+   - 소문자 정규화(dcy-001 형식)
+   - 중복 ID 제거(예: dcy-001, dcy-001 입력 시 1회만 처리)
+4. ID 형식은 dcy-<3자리숫자>만 허용한다. 형식 오류 ID는 별도 오류 목록으로 보고한다.
+5. 파일 검색 규칙:
+   - 경로: docs/sdlc/discovery/
+   - 패턴: <문서ID>_*.discovery.md
+   - 예: dcy-001 -> docs/sdlc/discovery/dcy-001_*.discovery.md
+6. 존재하지 않는 문서는 생성하지 않는다.
+   - 미존재 ID는 미발견 목록에 보고하고, 존재 문서만 재검토/수정한다.
+7. 문서 재검토 항목:
+   - 섹션 0~10 순서/유일성 검증
+   - `# 0. 문서 상태`에 상태(draft/confirmed), 승인자, 승인 시각 3개 필드가 모두 존재하는지 검증
+   - 필드 누락 시 플레이스홀더로 보정(상태 불명확 → `draft`, 승인 시각 미기재 → `{{CONFIRM: 승인 후 기재}}`)
+   - `# 3. 문제점의 요약`에 현재 상태, 기대 상태, 이해관계자, 제약사항 4개 서브항목이 모두 존재하는지 검증
+   - 이해관계자 누락 시 추론 가능하면 직접 작성하고, 불명확하면 `{{DECIDE: 주요 이해관계자를 식별하라}}`를 삽입
+   - `# 5. 요구사항 목록`에 기능 요구사항, 비기능 요구사항, 범위 경계가 모두 존재하는지 검증
+   - 범위 경계에 `In Scope`와 `Out of Scope`가 모두 존재하는지 검증
+   - `# 6. 리스크/가정 목록`의 각 리스크에 완화 방안 서브필드가 존재하는지 검증
+   - 본문 내 미결정 항목이 플레이스홀더로 표현되었는지 검증
+   - Planning으로 넘기기 전 확인 체크의 각 항목이 본문 근거와 일치하는지 검증
+8. 수정 규칙:
+   - append 금지, 단일 완성본으로 overwrite 저장
+   - 기존 사용자 의도/내용은 유지하되, 누락/불일치/중복 섹션만 보정
+9. 추가 의사결정이 필요하면 플레이스홀더를 반드시 삽입한다.
+   - {{DECIDE: 질문}}
+   - {{CONFIRM: 내용}}
+   - {{DATA: 필요한 정보}}
+   - {{DELEGATE_TO: agent}} (agent 자동 결정)
+10. Approver가 불명확하면 아래 플레이스홀더를 사용한다.
+   - {{DECIDE: 이 기능의 책임 승인자는 누구인가?}}
+11. 플레이스홀더가 문서 본문에 추가/존재하면 # 10. 사용자 결정 필요 항목 요약에 반드시 집계한다.
+12. # 10 집계 시 {{DECIDE}}, {{CONFIRM}}, {{DATA}}, {{DELEGATE_TO}}를 유형별로 분리하고 중복 문구는 1회만 남긴다.
+13. 여러 문서를 처리할 때 문서별 결과를 분리해 보고한다.
+14. 본문 플레이스홀더 정규화 규칙:
+   - 미해결 사항은 관련 본문 문장에 직접 연결된 플레이스홀더로 유지한다.
+   - 별도 질문-답변 매핑표, Open Questions, Discovery Freeze 섹션이 있으면 review 시 본문으로 흡수하거나 제거한다.
+   - {{DELEGATE_TO: agent}} 형식의 항목은 agent가 결정을 생성해 본문 문장으로 대체하고, 요약 섹션에서도 제거한다.
+   - Planning으로 넘기기 전 확인 체크는 본문 근거가 없으면 체크 해제하거나 근거 문장을 보강한다.
+   - 미해결 High 영향 플레이스홀더가 없으면 관련 체크 항목은 "미해결 High 영향 플레이스홀더 없음" 근거로 정규화한다.
+
+실행 절차:
+1. 입력 ID 목록 정규화(공백 제거, 중복 제거, 형식 검증)
+2. 각 ID에 대해 대상 파일 검색
+3. 발견 문서 내용 읽기
+4. 검토 체크리스트 기준으로 누락/불일치 판단
+5. 본문 내 미해결 항목을 플레이스홀더 형식으로 정규화하고, 별도 Q&A/Open Questions 섹션은 본문으로 흡수
+6. 필요한 항목만 보정하여 문서 overwrite 저장
+7. 문서별 플레이스홀더를 #10에 집계/정규화
+8. 최종 응답에 처리 요약 제공
+
+최종 응답 형식:
+1. 실행 입력 요약
+2. 정규화된 대상 ID 목록
+3. 형식 오류 ID 목록(있으면)
+4. 미발견 ID 목록(있으면)
+5. 문서별 검토 결과
+6. 문서별 수정 내역 요약
+7. 문서별 추가된 사용자 결정 항목({{DECIDE}}/{{CONFIRM}}/{{DATA}})
+8. 업데이트된 파일 경로 목록
+9. 다음 액션
+
+사용자 입력:
+{{input}}