clarify

name	clarify
description	Adaptive requirements clarification with auto-depth routing. Shallow (Q&A) for simple tasks, Deep (exploration + DRAFT + PLAN) for complex ones. Escalates automatically when ambiguity persists.

/clarify

Chain

Previous	Current	Next
Session start	/clarify	EnterPlanMode() → /implement

Flow (전체 흐름 — 건너뛰기 금지)

1. Route     → 복잡도 판단 (LOW/HIGH)
2. Clarify   → Shallow (Q&A) 또는 Deep (탐색+인터뷰)
3. DRAFT     → .dev/specs/{name}/DRAFT.md 작성
4. Gate      → Alignment Gate (출력 필수 — 아래 참조)
5. PLAN      → .dev/specs/{name}/PLAN.md 작성
6. DECISIONS → .dev/DECISIONS.md 기록
7. Plan Mode → EnterPlanMode() → /implement 자동 실행

Step 4 (Gate)는 절대 건너뛰지 않는다.

---

Step 1: Route — 복잡도 판단

Signal	LOW	HIGH
Request length	Short and specific	Long or ambiguous
Impact scope	Single file/module	Cross-cutting, multiple services
Risk	Low (UI, text)	High (DB, auth, breaking API)
Existing patterns	Clearly exist	None or unfamiliar stack

• LOW → shallow/SHALLOW.md
• HIGH → deep/DEEP.md
• Ambiguous → Start Shallow, escalate if needed

---

Step 4: Alignment Gate (MUST — 출력 필수)

DRAFT 작성 후, PLAN 작성 전에 반드시 실행하고 결과를 출력:

Alignment Gate:
- 스코프: ✅/❌ {변경 대상 모듈/파일 요약}
- 용어: ✅/❌ {서비스 이름, 봇 이름, 개념 경계 합의 여부}
- SSOT: ✅/❌ {이 작업의 진실의 원천}
- 미확정: ✅/❌ {남은 불확실한 항목}

하나라도 ❌ → 사용자에게 질의. 모두 ✅ → PLAN 작성 진행.

---

Step 5-6: PLAN + DECISIONS

PLAN — .dev/specs/{name}/PLAN.md에 작성. 반드시 /implement 사용 명시.

DECISIONS.md — 새 기능/아키텍처 결정 시 기록:

## YYYY-MM-DD: {feature-name}
- **결정**: 무엇을 결정했는가
- **이유**: 왜 이 선택을 했는가
- **대안**: 고려했으나 선택하지 않은 옵션
- **참조**: .dev/specs/{feature-name}/PLAN.md

Branch Strategy (multi-module 시):

Change scope	Strategy
Single module	One feature branch
Multiple modules (dependent)	Chain by dependency
Multiple modules (independent)	Separate branches

---

Step 7: Auto-execute

On plan approval, call /implement immediately. Do not ask "Should I implement?".