Skip to content

[10/13] application-design 최종안에 제3자 AI 리뷰 + 반영 분석 프로세스 추가 #4

@bluejayA

Description

@bluejayA

현재 동작

application-design 완료 후 사용자 승인 게이트(#8)만 존재. 설계 품질에 대한 외부 검증 없이 code-generation으로 진행.

제안: DETAIL 모드 완료 후 제3자 리뷰 + 반영 분석

리뷰 실행 조건

  • DETAIL 모드 완료 후에만 실행 (LIST 모드에서는 스킵 — 컴포넌트 목록만으로는 리뷰 의미 없음)
  • Minimal depth에서는 DETAIL 호출 자체가 없으므로 자동으로 리뷰도 없음
  • 선택적 실행: 게이트 #8b에 리뷰 옵션 추가

리뷰 삽입 위치

application-design 게이트 #8b (DETAIL 승인)에 리뷰 옵션 추가:

A) 변경 요청 → DETAIL 재호출
B) 승인 → INCEPTION 완료
R) 리뷰 요청 → 제3자 리뷰 실행 후 결과와 함께 게이트 재표시

리뷰 관점 (리뷰어 프롬프트에 포함)

  1. 컴포넌트 책임 분리: 단일 책임 원칙 위반, God Object 패턴
  2. 의존성 방향: 순환 의존, 상위 레이어가 하위 레이어에 의존하는지
  3. 인터페이스 설계: 공개 API 표면적, 계약(contract)의 명확성
  4. 확장성: 새 기능 추가 시 수정 범위, Open-Closed 원칙
  5. 요구사항 매핑: requirements.md의 각 항목이 어떤 컴포넌트에 매핑되는지 누락 확인
  6. NFR 반영 여부: nfr-requirements.md가 있으면 비기능 요구사항이 설계에 반영되었는지

리뷰 결과 구조화 분석 (BL-003과 동일 구조)

## Design Review Analysis
| # | 피드백 요약 | 판정 | 반영 범위 | 근거 |
|---|-----------|------|----------|------|
| 1 | ... | Accept | 설계 수정 | ... |
| 2 | ... | Reject | - | ... |

리뷰 컨텍스트 자동 주입

  • devflow-docs/inception/application-design.md (리뷰 대상)
  • devflow-docs/inception/requirements.md
  • devflow-docs/inception/nfr-requirements.md (있으면)
  • devflow-docs/inception/workspace.md (tech stack 참고)

리뷰 후 흐름

  • Accept 항목이 있으면 → DETAIL 재호출하여 설계 수정 → 수정 후 게이트 #8b 재표시
  • 모두 Reject/Defer이면 → 바로 승인 진행 가능

관련

기대 효과

  • 다양한 관점의 피드백으로 설계 품질 향상
  • 코드 작성 전에 설계 결함 발견 (수정 비용 최소화)
  • BL-003과 일관된 리뷰 체계

영향 범위

  • inception-orchestrator (게이트 #8b에 리뷰 옵션 추가)
  • application-design 스킬 (리뷰 결과 반영 후 DETAIL 재호출)
  • 신규 리뷰어 프롬프트 (_shared/reviewers/design-review.md)
  • 산출물: devflow-docs/inception/design-review.md

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions