portfolio-hub/.vendor/myagent-kit/base/.github/instructions/reopen-requirement-discovery.instructions.md

description, applyTo

description	applyTo
Use when customizing REQ candidate discovery rules for /reopen-requirement-status command, including keyword dictionary, scoring, tie-breaks, and normalization policy.	.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 선택을 먼저 요청