product-planner

name	product-planner
description	Use after /office-hours when the problem is defined but the plan and scope are not yet ready. Judges readiness through discovery, product, and engineering lenses. Returns a readiness verdict (ready / revise / park) + concrete gaps to close before implementation starts.

Product Planner

문제 정의는 끝났는데 (office-hours 이후) 아직 PRD / Plan 이 불안한 단계를 잠그는 skill.

언제 쓰는가

• /office-hours 이후 "이 문제는 풀 가치가 있다" 가 결정됨
• PRD.md 초안이 있지만 acceptance criteria 가 모호
• Plan.md 쓰기 전, 또는 쓴 뒤 "이 정도면 scope_lock 해도 될까?" 판단 필요
• 범위가 쉽게 커질 수 있는 기능 (예: 인증, 결제, 데이터 모델)

언제 쓰지 않는가

• 문제 정의 자체가 흔들림 → 먼저 /office-hours 로 돌아가기
• trivial tier (단일 파일, 2-3 줄 수정)
• 이미 runtime.json → gates.plan_reviewed == true

방식 (솔로 버전)

gstack/Manta 의 다면 렌즈를 솔로 환경에 맞게 3개로 단순화:

1. Discovery lens — "사용자 문제가 정말 이거 맞나?"

• PRD 가 주장하는 사용자 시나리오가 실제로 1명 이상에게 관찰 됐는가?
• 사용자가 지금 어떻게 우회 하고 있나? (수동 / 다른 도구 / 포기)
• 당신이 "사용자" 라면, 이 기능 대신 다른 것 을 만들어달라고 했을 가능성은?

2. Product lens — "이게 10x 인가, 1.1x 인가?"

• Acceptance criteria 가 측정 가능 한 숫자/상태로 적혀 있나?
• "OK" / "대충 좋음" 같은 애매 기준이 있으면 reject
• 이 기능이 사용자 워크플로에서 몇 단계를 줄이거나 새로 가능하게 하나?
• 1.1x 수준이면 → park verdict (지금 안 해도 됨)

3. Engineering lens — "지금 상태로 구현 시작하면 뭐가 터지나?"

• In-scope / Out-of-scope 파일이 Plan.md 에 명시 됐나?
• Milestone 이 독립 검증 가능 한 단위로 쪼개졌나?
• Rollback 계획이 있나 (한 milestone 실패 시 되돌릴 방법)?
• Tier 분류 (size_check.py 기준) 와 Plan 의 self-assessment 가 일치하나?
• high-risk 경로 (auth/security/payment/migration) 포함되면 명시?

출력 형식

# Product Planner Verdict — <date>

## Readiness: ready | revise | park

## Discovery lens
- 사용자 관찰 증거: <구체>
- 현재 우회법: <구체>
- Gaps: <있으면 list, 없으면 "none">

## Product lens
- 10x claim: <왜 10x 인지 또는 "1.1x, park 권장">
- Acceptance criteria 구체성: high / medium / low
- Gaps: <list>

## Engineering lens
- In/Out scope 명시: yes / no
- Milestone 쪼개기: good / weak
- Rollback 계획: yes / no / n/a
- Tier 정확성: <match / mismatch>
- Gaps: <list>

## Close-before-scope-lock list

구현 시작 전에 반드시 해결할 것:
1. ...
2. ...

## Next gate
- If ready → `runtime_gate.py lock-scope` + `runtime_gate.py review-plan`
- If revise → 위 close list 를 PRD.md / Plan.md 에 반영 후 재평가
- If park → Documentation.md 에 "parked: <reason>" 기록 후 다른 작업으로

가드레일

• "충분해 보인다" 금지 — lens 3개 모두 구체 근거 또는 gap 명시
• park verdict 는 포기가 아니라 "지금 아님" — Documentation.md 에 이유 기록
• 솔로 환경에서는 이 skill 이 /office-hours 와 /plan-eng-review 사이의 자연스러운 연결고리

먼저 읽을 것

• Prompt.md, PRD.md, (있으면) Plan.md 초안
• ETHOS.md — 무너지지 않는 철학
• CLAUDE.md — 운영 헌법
• templates/PRD.md, templates/Plan.md — 양식 기준