feat: add depth parameter for planning thoroughness

Adds depth setting (quick/standard/comprehensive) to control how many
phases and plans get created. Tasks per plan stays constant at 2-3.

- Quick: 3-5 phases, 1-3 plans each
- Standard: 5-8 phases, 3-5 plans each
- Comprehensive: 8-12 phases, 5-10 plans each

Depth increases plan COUNT, never plan SIZE. More plans = more
thoroughness with same quality per plan.

Files changed:
- new-project.md: depth question after mode
- config.json: depth field added
- create-roadmap.md: depth-aware phase guidance
- plan-phase.md: depth-aware plan splitting
- scope-estimation.md: depth calibration section
- create-milestone.md: removed hardcoded 3-6 limit
- new-milestone.md: removed hardcoded 3-6 limit
- roadmap.md template: depth-aware guidance

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
2026-01-04 18:31:59 -06:00
parent b04034267d
commit 484134e63c
8 changed files with 121 additions and 8 deletions

View File

@@ -81,7 +81,35 @@ Select (comma-separate for multiple):
</step>
<step name="identify_phases">
Derive phases from the actual work needed. The phase count emerges from the project—don't impose a number.
Derive phases from the actual work needed.
**Check depth setting:**
```bash
cat .planning/config.json 2>/dev/null | grep depth
```
<depth_guidance>
**Phase count targets by depth:**
| Depth | Target Phases | Plans/Phase | Tasks/Plan |
|-------|---------------|-------------|------------|
| Quick | 3-5 | 1-3 | 2-3 |
| Standard | 5-8 | 3-5 | 2-3 |
| Comprehensive | 8-12 | 5-10 | 2-3 |
**Tasks/plan is constant (2-3). Depth scales phases and plans, not task density.**
For comprehensive depth:
- Don't compress multiple features into single phases
- Each major capability gets its own phase
- "Too many phases" is NOT a concern—thoroughness is the goal
- If you're tempted to combine two things, make them separate phases instead
For quick depth:
- Combine related work aggressively
- Focus on critical path only
- Defer nice-to-haves to future milestones
</depth_guidance>
**Phase Numbering System:**