purplemux: Skill for Claude Code

spec-verify — 스펙 대비 구현 검증

feature에 대해 스펙 문서와 실제 코드를 비교하여 누락/불일치를 찾아냅니다. 누락된 항목이 있으면 바로 코드를 보완합니다. "v1 visit-planning 검증해줘" 요청 시 사용합니다.

Instructions

다음 단계를 순서대로 수행하세요.

1. 인자 확인

• 첫 번째 인자: 버전 (예: v1, v2)
• 두 번째 인자: feature명 (예: visit-planning)
• feature명이 없으면 "feature명을 지정해주세요. 예: /5-verify v1 visit-planning" 안내 후 종료

2. CLAUDE.md 로드

• CLAUDE.md를 읽어 기술 스택, 코드 규칙, 참고 문서 링크 파악

3. 스펙 문서 전체 로드

다음 4개 스펙 문서를 모두 읽습니다:

• .specs/v{N}/features/{feature-name}/spec.md — 페이지 개요, 주요 기능
• .specs/v{N}/features/{feature-name}/detail/ui.md — 화면 구성, 컴포넌트 매핑
• .specs/v{N}/features/{feature-name}/detail/flow.md — 사용자 흐름, 상태 전이
• .specs/v{N}/features/{feature-name}/detail/api.md — API 연동, 쿼리/뮤테이션

4. 이전 빌드/검증 결과 로드

• .specs/v{N}/features/{feature-name}/result/ 디렉토리를 glob 패턴 *.md로 탐색하여 존재하는 모든 결과 파일을 읽습니다:

  • build.md — 빌드 시 생성/수정/삭제된 파일 목록
  • verify-*.md — 이전 검증 라운드별 결과 (verify-1.md, verify-2.md, …)

• 이전 결과에서 다음 정보를 파악합니다:

  • 이미 보완 완료된 항목 → 재검증 시 통과 확인만 하고 중복 수정하지 않음
  • 미보완 항목과 사유 (예: 별도 feature 필요, 인프라 수준 작업) → 동일 사유의 항목은 이번 라운드에서도 미보완으로 유지
  • 보완 전후 수치 변화 → 개선 추이 파악

• result 디렉토리가 없거나 파일이 없으면 (첫 검증) 이 단계를 건너뜁니다.

5. 구현 코드 전체 탐색

• 프로젝트 루트 하위에서 해당 feature와 관련된 모든 파일을 탐색
• 라우트, 페이지 컴포넌트, 하위 컴포넌트, 훅, API 연동, 타입 정의 등 전체 파악

6. 스펙 vs 구현 대조 검증

아래 체크리스트를 기준으로 스펙 문서와 실제 코드를 항목 단위로 대조합니다:

spec.md 대조

• 주요 기능 목록의 각 항목이 코드에 구현되어 있는가
• 라우트 경로가 spec에 정의된 대로인가

ui.md 대조

• 레이아웃 구조가 명세와 일치하는가
• 테이블 컬럼 / 카드 구성이 명세대로인가
• 폼 필드(필드명, 컴포넌트 타입, 필수 여부, 검증 규칙)가 일치하는가
• 로딩 상태(스켈레톤/스피너)가 구현되어 있는가
• 빈 상태(안내 메시지 + 액션)가 구현되어 있는가
• 에러 상태(재시도 옵션)가 구현되어 있는가
• 인터랙션 피드백(버튼 클릭, 폼 제출, 삭제 등)이 구현되어 있는가

flow.md 대조

• 기본 흐름의 각 단계가 코드에 반영되어 있는가
• 상태 전이(mermaid에 정의된 상태/트리거)가 구현되어 있는가
• 엣지 케이스 처리가 구현되어 있는가
• Optimistic UI가 명세된 곳에 적용되어 있는가

api.md 대조

• 명세된 조회 API(엔드포인트, 파라미터)가 코드에 연결되어 있는가
• 명세된 변경 API(엔드포인트, 부수효과)가 코드에 연결되어 있는가
• 필터/정렬 매핑이 명세대로 구현되어 있는가
• 캐시 전략이 명세대로 적용되어 있는가
• 페이지네이션이 명세대로 구현되어 있는가