draft: Reorganize documentation and update prompts

2026-04-13 23:26:54 +09:00
parent 0fcde8b89b
commit e89690b1dd
7 changed files with 128 additions and 283 deletions
@@ -0,0 +1,50 @@
+---
+description: "Use when customizing REQ candidate discovery rules for /reopen-requirement-status command, including keyword dictionary, scoring, tie-breaks, and normalization policy."
+applyTo: ".github/prompts/reopen-requirement-status.prompt.md"
+---
+# Reopen Requirement Discovery Guidelines
+
+## 목적
+`/reopen-requirement-status` 입력에 REQ ID가 없을 때, 관련 REQ 후보를 일관된 기준으로 탐색하고 우선순위를 정한다.
+
+## 후보 탐색 우선순위
+1. 계약 키워드 일치
+- `API`, `endpoint`, `request`, `response`, `schema`, `field`, `CLI`, `command`, `option`, `UI`, `event`, `config`, `env`, `deploy`, `integration`
+2. 영향 영역 일치
+- 입력의 변경 대상 모듈/문서/테스트와 REQ의 `Impacted Area` 교집합
+3. 목적/행동 일치
+- 입력의 동사/의도(추가, 제거, 변경, 완화, 강화, 비활성화 등)와 REQ `Intent`/`Requirement`의 의미 유사도
+4. 상태 가중치
+- 현재 상태가 `Approved`, `Implemented`, `Deprecated`인 REQ 우선
+
+## 점수 및 신뢰도
+- 점수식: `키워드(0-5) + 영향영역(0-3) + 의미유사(0-2) + 상태가중치(0-1)`
+- 정렬: 총점 내림차순
+- 신뢰도:
+  - `High(7-11)`
+  - `Medium(4-6)`
+  - `Low(0-3)`
+
+## 도메인 키워드 사전 (커스터마이즈 가능)
+- Auth & Access: `auth`, `login`, `oauth`, `token`, `permission`, `rbac`, `role`, `scope`
+- Billing & Subscription: `billing`, `invoice`, `payment`, `subscription`, `plan`, `quota`, `credit`
+- Data & Migration: `schema`, `migration`, `backfill`, `etl`, `import`, `export`, `retention`
+- API & Contract: `api`, `endpoint`, `request`, `response`, `versioning`, `webhook`, `payload`
+- Runtime & Operations: `deploy`, `rollback`, `release`, `monitoring`, `alert`, `slo`, `incident`
+- Configuration: `config`, `env`, `feature flag`, `toggle`, `secret`, `parameter`
+- UX & Interface: `ui`, `ux`, `screen`, `form`, `flow`, `command`, `cli`, `option`
+- Testing & Quality: `test`, `e2e`, `regression`, `coverage`, `validation`, `acceptance`
+
+## 정규화 규칙
+- 사전에 없는 표현이 입력에 등장하면 의미가 유사한 사전 키워드로 1회 정규화해 근거에 표기한다.
+- 예: `권한` -> `permission`, `과금` -> `billing`
+
+## 동점 처리
+- 동일 점수 후보가 여러 개면 최신 Change Log 항목이 있는 REQ를 우선한다.
+- 여전히 동점이면 현재 active 상태(`Approved`/`Implemented`) REQ를 우선한다.
+- 추가 동점이면 REQ ID가 작은 항목을 우선한다.
+
+## 출력 권장
+- 후보는 최대 5개 제시
+- 각 후보에 `REQ ID`, `신뢰도`, `점수`, `근거 키워드`, `영향 영역`을 포함
+- 확정 전에는 `Immediate Questions`로 최종 대상 REQ 선택을 먼저 요청