---
name: verify-requirement
description: |
  plan-analyzer가 생성한 요구사항 명세와 실제 구현 코드를 자동 비교하여
  누락 기능, 스펙 불일치, 미구현 항목을 사전에 감지합니다.

  다음 상황에서 반드시 사용하세요:
  - "요구사항 대비 누락 기능 체크해줘", "기획서랑 구현 맞는지 확인해줘"
  - QA 전 스펙 불일치를 미리 잡고 싶을 때
  - 개발 완료 후 기획 의도와 일치하는지 검증할 때
---

# 요구사항 검증 (verify-requirement)

plan-analyzer 명세 ↔ 실제 구현 코드 자동 비교 → 누락/불일치 리포트 생성.

## 언제 사용하는가

- 개발 완료 후 QA 이전에 스펙 누락 여부를 확인할 때
- 기획자와 개발자 간 스펙 해석 차이를 사전에 해소할 때
- 릴리스 전 체크리스트를 자동화하고 싶을 때

## 입력

- `plan-analyzer` 산출물 (요구사항 명세 MD 파일)
- 검증 대상 디렉토리 또는 파일 목록
- (선택) 검증 범위: 화면 목록, API 엔드포인트, 컴포넌트 트리

---

## 작업 순서

### Phase 1: 요구사항 명세 파싱

1. plan-analyzer 산출물에서 아래 항목을 추출한다.
   - 화면(페이지) 목록과 라우팅 경로
   - 각 화면의 핵심 기능 목록
   - API 엔드포인트 목록
   - 컴포넌트 트리

2. 명세가 없는 경우 사용자에게 파일 경로를 요청한다.

### Phase 2: 구현 현황 파악

1. `pages/` 디렉토리를 스캔해 실제 라우팅 구현 현황을 파악한다.
2. `components/` 디렉토리에서 구현된 컴포넌트 목록을 수집한다.
3. `server/api/` 에서 구현된 엔드포인트를 파악한다.
4. 각 화면 파일에서 아래를 확인한다.
   - 기획서에 명시된 기능 구현 여부
   - 폼/버튼/모달 등 인터랙션 요소 구현 여부
   - 에러/로딩/빈 상태 처리 여부

### Phase 3: 비교 및 분류

발견된 차이를 3단계로 분류한다:

| 등급 | 기준 | 예시 |
|---|---|---|
| 🚨 Critical | 핵심 기능 미구현 | 결제 버튼 없음, 필수 API 미연동 |
| ⚠️ Warning | 일부 기능 누락 또는 스펙 불일치 | 에러 상태 처리 없음, 페이지네이션 미구현 |
| 💡 Info | 선택 기능 누락 또는 UX 개선 사항 | 로딩 스피너 없음, 빈 상태 메시지 없음 |

### Phase 4: 개선 방안 제시

각 Critical / Warning 항목에 대해 구체적인 구현 방향을 제안한다.

---

## 출력 형식

```
## 요구사항 검증 리포트

### 검증 범위
- 화면: N개 / 구현: N개 (일치율 NN%)
- API: N개 / 구현: N개 (일치율 NN%)
- 컴포넌트: N개 / 구현: N개 (일치율 NN%)

### 🚨 Critical (N건)
- [화면명] 기능 설명 — 구체적 해결 방안

### ⚠️ Warning (N건)
- [화면명] 기능 설명 — 구체적 해결 방안

### 💡 Info (N건)
- [화면명] 개선 사항

### ✅ 일치 항목
- [목록]
```