purplemux: Skill for Claude Code

spec-draft — 스펙 초안 작성

기능 스펙 초안(spec.md)을 작성합니다. 페이지명 지정 시 해당 페이지만, 미지정 시 전체 일괄 생성합니다. "v1 스펙 초안", "v1 전체 스펙 초안" 요청 시 사용합니다.

Instructions

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

1. 버전 확인

• 사용자가 버전을 지정한 경우 해당 버전 사용 (예: v1, v2)
• 미지정 시 현재 진행 중인 버전 사용

2. 요구사항 파악

• .specs/v{N}/PRD.md를 읽어 요구사항 파악

3. 프로젝트 가이드 파악

• CLAUDE.md의 "참고 문서" 섹션에서 docs/ 가이드 목록 파악

4. 대상 결정

• 페이지명 지정 → 해당 페이지만 생성
• 미지정 → PRD.md의 페이지 목록 기반으로 전체 일괄 생성

5. spec.md 생성

.specs/v{N}/features/{feature-name}/spec.md를 다음 구조로 생성합니다:

---
page: { page-name }
title: { 페이지 제목 }
route: { 라우트 경로 }
status: DRAFT
complexity: Low | Medium | High
depends_on:
  - docs/{관련 가이드}.md
created: { 날짜 }
updated: { 날짜 }
assignee: ''
---

# {페이지 제목}

## 개요

(페이지 목적과 범위)

## 주요 기능

- 기능 항목들

## 하위 문서

- [화면 구성](./detail/ui.md)
- [사용자 흐름](./detail/flow.md)
- [API 연동](./detail/api.md)

## 변경 이력

| 날짜   | 변경 내용 | 상태  |
| ------ | --------- | ----- |
| {날짜} | 초안 작성 | DRAFT |

6. depends_on 연결

• 페이지와 관련된 프로젝트 가이드(docs/)를 depends_on에 연결

7. 일관성 유지

• 기존에 작성된 페이지 스펙이 있으면 스타일을 참고하여 일관성 유지

8. 품질 기준 적용

각 페이지의 주요 기능을 아래 세 축으로 검증하고, 부족한 부분을 spec.md에 반영합니다:

• 빠르다 — 주요 기능 중 성능 전략이 필요한 항목을 식별하고 기능 목록에 포함 (prefetch, 캐싱, 지연 로딩 등)
• 토스급 완성도 — 로딩·빈·에러 상태 처리, 인터랙션 피드백, 전환 애니메이션 등 UX 완성도 항목을 기능에 포함. "동작만 하는" 수준의 기능 정의는 허용하지 않음
• 포브스 TOP 10 기업 수준 — 기능 하나하나가 실무에서 바로 쓸 수 있는 깊이인지 검증. "되긴 되는" 수준이 아닌 "이 정도면 감탄한다" 수준을 목표로 기능 정의

9. 다음 단계 안내

작성 완료 후 다음 안내 메시지를 반드시 출력:

각 feature의 spec.md를 검토한 뒤, frontmatter의 status를 CONFIRMED로 변경하세요.
CONFIRMED된 feature만 `/3-detail`과 `/4-build`에서 처리됩니다.