requirements-review

name	requirements-review
description	Requirements 문서를 Agent 3명이 독립 리뷰하고, 가중 투표로 취합한 뒤, 사용자에게 해결 방향을 질문하여 Requirements 문서에 반영합니다.
argument-hint	<requirements파일경로>
disable-model-invocation	true

Requirements 문서 리뷰

입력

$ARGUMENTS (requirements 파일 경로)

파일이 존재하는지 확인. 없으면 에러 출력 후 종료.

Phase 1: 리뷰 및 취합

Agent 파일 번호 결정

docs/requirements-review-agent-*.md 패턴으로 기존 파일을 검색하여 가장 높은 번호를 찾는다.

• 기존 파일이 없으면 시작 번호 = 1
• 기존 파일이 있으면 시작 번호 = (가장 높은 번호 + 1)
• 예: 기존에 1,2,3이 있으면 → 4,5,6 / 기존에 4,5,6이 있으면 → 7,8,9

Agent 3명을 순차적으로 실행하라. 한 Agent가 완료된 후 다음 Agent를 실행할 것.

각 Agent에게 다음을 전달:

"Requirements 문서를 읽고 리뷰하라. review-requirements-prompt.md의 지시에 따라 8가지 관점(EARS 형식 준수, 요구사항 완전성, 요구사항 명확성, 요구사항 간 일관성, 테스트 가능성, 사용자 스토리 적절성, 범위 적절성, 비기능 및 제약 요건 식별)으로 검토. 이슈마다 ISS-번호, 심각도(CRITICAL/MAJOR/MINOR), 확신도(1-10), 근거강도(1-5), 원문 인용, 제안을 기술. 결과를 docs/requirements-review-agent-{번호}.md에 저장."

실행 순서 (시작 번호가 N일 때):

1. Agent → docs/requirements-review-agent-{N}.md 저장 → 완료 확인
2. Agent → docs/requirements-review-agent-{N+1}.md 저장 → 완료 확인
3. Agent → docs/requirements-review-agent-{N+2}.md 저장 → 완료 확인

취합 결과 버전 관리

docs/requirements-review-aggregated-v*.md 패턴으로 기존 파일을 검색하여 가장 높은 번호를 찾는다.

• 기존 파일이 없으면 v1, 있으면 +1 증가

3명 모두 완료 후, 3개 파일을 읽고 aggregation-rules.md 절차로 취합. 취합 결과를 docs/requirements-review-aggregated-v{M}.md에 저장.

Phase 2: 질문 생성

취합 결과에서 🔴 High Confidence와 🟡 Needs Review 이슈 중 CRITICAL/MAJOR 심각도만 추출하여, question-generation-rules.md 절차에 따라 질문 파일을 생성한다.

버전 관리

• 질문 파일명: docs/requirements-review-questions-v{N}.md
• N은 1부터 시작하여 기존 파일이 있으면 +1 증가
• 버전 확인: docs/requirements-review-questions-v*.md 패턴으로 기존 파일을 검색하여 가장 높은 번호를 찾는다

사용자 안내

질문 파일 생성 후 사용자에게 다음을 전달:

"리뷰 결과를 바탕으로 {N}개의 질문을 생성했습니다. docs/requirements-review-questions-v{N}.md 파일에서 각 질문의 [Answer]: 태그 뒤에 선택한 알파벳을 입력해 주세요. Other를 선택하시면 원하는 내용을 직접 설명해 주세요. 완료되면 알려주세요."

답변 대기

사용자가 "done", "완료", "finished", "답변했습니다" 등으로 완료를 알릴 때까지 대기. 진행하지 말 것.

Phase 3: 답변 검증

사용자가 완료를 알리면:

1. 질문 파일을 읽고 모든 [Answer]: 태그의 답변을 추출
2. 미답변 항목이 있으면 사용자에게 알리고 재답변 요청
3. 유효하지 않은 답변(선택지에 없는 문자)이 있으면 사용자에게 알리고 재답변 요청
4. 답변 간 모순이 있으면 clarification 질문 파일(docs/requirements-review-clarification-v{N}.md) 생성

모든 답변이 유효하고 모순이 없을 때 Phase 4로 진행.

Phase 4: Requirements 문서 적용

검증된 답변을 기반으로 Requirements 문서를 수정한다.

적용 규칙

1. 각 질문의 답변에 따라 해당 이슈의 해결 방안을 Requirements 문서에 반영
2. 수정 시 새로운 모순을 만들지 않도록 관련 요구사항을 교차 확인
3. EARS 형식을 준수하여 수정 (WHEN/THEN/SHALL, IF/THEN/SHALL 등)
4. Other 답변은 사용자가 기술한 내용을 충실히 반영
5. 수정 완료 후 변경 사항 요약을 사용자에게 보고

변경 사항 보고 형식

## Requirements 문서 수정 완료

### 적용된 변경 사항
| # | 이슈 | 사용자 선택 | 적용 내용 |
|---|------|-----------|----------|

### 수정된 요구사항
- 요구사항 X: {변경 요약}
- 요구사항 Y: {변경 요약}

### 참고 사항
(수정 시 발견된 추가 고려사항이 있으면 기술)