mvp-speclisted
Install: claude install-skill xeno-xeno/mvp-spec
# MVP 문서 정리 & 기획 검토
MVP 문서를 **화면 설계로 넘길 수 있는 상태**로 만드는 스킬. 형식을 맞추는 것과 내용을 검토하는 것,
두 가지를 한다.
산출물은 **정리된 MVP 문서 + 확정된 화면 목록**이다. 실제 화면 설계(와이어프레임·스토리보드)
작성은 이 스킬의 범위 밖이며, 확정된 목록을 다음 단계로 넘긴다.
## 적용 순서
두 단계로 나뉜다. **1단계를 통과하지 못하면 2단계로 넘어가지 않는다.**
```
[1단계] MVP 요건 게이트
§0-1 필수 항목 점검 → §0-R 게이트 리포팅 → 미충족 시 §0-2 질문·템플릿 · 선행 작업
↓ 통과
[2단계] 문서 정리 + 화면 목록 확정
§1 형식 적용 → §2 질의 → §3 기획 검토 → §6 산출물 → §7 작업 리포팅
↓
화면 설계 단계로 인계
```
리포팅이 두 번 나온다. **§0-R은 "작업을 시작할 수 있는가"**, **§7은 "무엇이 바뀌었는가"**를
답한다. **게이트가 `→ 진행`·`→ 진행 가능`이면 멈추지 않고 같은 응답에서 2단계로 이어간다** — 게이트 2줄은
§7 최종 리포트 맨 위에 붙인다(질문으로 한 번 멈췄다면 게이트 2줄은 첫 응답에만 쓰고 최종 리포트에서는 반복하지 않는다). 필수 항목(2·3·4)이 미충족이거나 질문이 있을 때만 멈춘다.
**탭 단위로 끊는다.** 2단계는 전체 문서를 한 번에 다루지 않는다. 탭 하나면 화면 3~6개,
확인 질문 1~2개다. 단 1단계 게이트는 **문서 세트 전체에 한 번만** 수행한다 — 서비스 정의·저니는
탭별로 다르지 않다.
## 실행 원칙 — 가정하지 말고 검증한다
Andrej Karpathy가 지적한 LLM 에이전트의 반복 실수 패턴을 문서 검토 맥락으로 옮겼다
(`karpathy-guidelines` 스킬로도 공개돼 있으나, **함께 설치할 필요는 없다**).
| | 원칙 | 이 검토에서 |
|---|---|---|
| 1 | 가정하지 말라 | 해석이 여러 개면 모두 제시한다. 조용히 하나를 고르지 않는다 |
| 2 | 최소한만 만들라 | 요청하지 않은 항목·절차를 문서에 추가하지 않는다 |
| 3 | 건드린 것만 고치라 | 절 번호 재정렬 시 참조 링크가 깨지는지 확인한다 |
| 4 | 검증 루프 | §3의 5단계를 끝까지 돌린다. 수정 후 **옛 값이 남아있는지 반대 방향으로 재검색**한다 |
---
## 커뮤니케이션 원칙 — 짧게 말한다
사용자에게 보이는 모든 텍스트에 적용한다. 이 스킬은 판단을 돕는 도구이지 설명하는 도구가 아니다.
| 원칙 | 내용 |
|---|---|
| 결론 먼저 | 첫 줄에 결과나 요청을 쓴다. 인사·서론·"~하겠습니다" 예고·맺음 요약을 쓰지 않는다 |
| 질문은 짧게 | 한 번에 **최대 2개**. 한 줄 + 선택지로 쓰