design-review

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

Design 문서 리뷰

입력

$ARGUMENTS (design 파일 경로, requirements 파일 경로)

두 파일 경로를 공백으로 구분하여 받는다.

• 첫 번째: Design 문서 파일 경로
• 두 번째: Requirements 문서 파일 경로

두 파일 모두 존재하는지 확인. 하나라도 없으면 에러 출력 후 종료.

역할 분담

• 서브에이전트 (review-general-task-execution): Phase 1 독립 리뷰 3회만 담당
• 메인에이전트: 취합, 질문 생성, 답변 검증, Design 문서 수정을 직접 수행

Phase 1: 리뷰 및 취합

서브에이전트 파일 번호 결정

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

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

review-general-task-execution 서브에이전트 3명을 순차적으로 실행하라. 한 서브에이전트가 완료된 후 다음 서브에이전트를 실행할 것.

각 review-general-task-execution 서브에이전트에게 다음을 전달:

"Design 문서와 Requirements 문서를 모두 읽고 리뷰하라. review-design-prompt.md의 지시에 따라 8가지 관점(Requirements 정합성, 내부 일관성, 기술적 건전성, 인터페이스/데이터 모델 완전성, 에러 처리 완전성, 테스트 전략 적절성, 설계 결정 근거, 비기능 요건 충족도)으로 검토. 이슈마다 ISS-번호, 심각도(CRITICAL/MAJOR/MINOR), 확신도(1-10), 근거강도(1-5), 원문 인용, 제안을 기술. 결과를 docs/design-review-agent-{번호}.md에 저장."

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

1. review-general-task-execution → docs/design-review-agent-{N}.md 저장 → 완료 확인
2. review-general-task-execution → docs/design-review-agent-{N+1}.md 저장 → 완료 확인
3. review-general-task-execution → docs/design-review-agent-{N+2}.md 저장 → 완료 확인

취합 (메인에이전트가 직접 수행)

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

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

3명 모두 완료 후, 메인에이전트가 직접 3개 파일을 읽고 aggregation-rules.md 절차로 취합. 취합 결과를 docs/design-review-aggregated-v{M}.md에 저장.

Phase 2: 질문 생성

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

버전 관리

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

사용자 안내

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

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

답변 대기

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

Phase 3: 답변 검증

사용자가 완료를 알리면:

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

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

Phase 4: Design 문서 적용

메인에이전트가 직접 검증된 답변을 기반으로 Design 문서를 수정한다.

적용 규칙

1. 각 질문의 답변에 따라 해당 이슈의 해결 방안을 Design 문서에 반영
2. 수정 시 새로운 모순을 만들지 않도록 관련 영역을 교차 확인
3. Other 답변은 사용자가 기술한 내용을 충실히 반영
4. 수정 완료 후 변경 사항 요약을 사용자에게 보고

변경 사항 보고 형식

## Design 문서 수정 완료

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

### 수정된 섹션
- 섹션 X: {변경 요약}
- 섹션 Y: {변경 요약}

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