diff --git a/commands/gsd/new-milestone.md b/commands/gsd/new-milestone.md index b4b40d8b6..64d8d6f71 100644 --- a/commands/gsd/new-milestone.md +++ b/commands/gsd/new-milestone.md @@ -32,7 +32,7 @@ Milestone name: $ARGUMENTS (optional - will prompt if not provided) 1. Load project context (STATE.md, ROADMAP.md, MILESTONES.md) 2. Calculate next milestone version and starting phase number 3. If milestone name provided in arguments, use it; otherwise prompt -4. Gather phases (3-6 recommended): +4. Gather phases (per depth setting: quick 3-5, standard 5-8, comprehensive 8-12): - If called from /gsd:discuss-milestone, use provided context - Otherwise, prompt for phase breakdown 5. Detect research needs for each phase @@ -48,7 +48,7 @@ Milestone name: $ARGUMENTS (optional - will prompt if not provided) - Next phase number calculated correctly (continues from previous milestone) -- 3-6 phases defined with clear names +- Phases defined per depth setting (quick: 3-5, standard: 5-8, comprehensive: 8-12) - Research flags assigned for each phase - ROADMAP.md updated with new milestone section - Phase directories created diff --git a/commands/gsd/new-project.md b/commands/gsd/new-project.md index 068c43b8c..308718a9f 100644 --- a/commands/gsd/new-project.md +++ b/commands/gsd/new-project.md @@ -230,7 +230,24 @@ Use AskUserQuestion: - "Interactive" — Confirm at each step - "YOLO" — Auto-approve, just execute -Create `.planning/config.json` with chosen mode using `templates/config.json` structure. + + + + +Ask planning depth preference: + +Use AskUserQuestion: + +- header: "Depth" +- question: "How thorough should planning be?" +- options: + - "Quick" — Ship fast, minimal phases/plans (3-5 phases, 1-3 plans each) + - "Standard" — Balanced scope and speed (5-8 phases, 3-5 plans each) + - "Comprehensive" — Thorough coverage, more phases/plans (8-12 phases, 5-10 plans each) + +**Depth controls quantity, not quality.** All depths use 2-3 tasks per plan. Depth determines how many plans get created—more depth means more plans, not bigger plans. + +Create `.planning/config.json` with chosen mode and depth using `templates/config.json` structure. diff --git a/get-shit-done/references/scope-estimation.md b/get-shit-done/references/scope-estimation.md index a5129ca66..472342fe2 100644 --- a/get-shit-done/references/scope-estimation.md +++ b/get-shit-done/references/scope-estimation.md @@ -102,6 +102,33 @@ Each: 30-40% context, peak quality, focused commits **3 tasks:** Simple ~45%, Medium ~75% (risky), Complex 120% (impossible) + +**Depth controls plan count, not plan size.** + +| Depth | 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 at 2-3. The 50% context rule applies universally. + +Depth determines thoroughness by creating more phases and more plans—never by cramming more into each plan. + +**Comprehensive depth example:** +Auth system at comprehensive depth = 8 plans (not 3 big ones): +- 01: DB models (2 tasks) +- 02: Password hashing (2 tasks) +- 03: JWT generation (2 tasks) +- 04: JWT validation middleware (2 tasks) +- 05: Login endpoint (2 tasks) +- 06: Register endpoint (2 tasks) +- 07: Protected route patterns (2 tasks) +- 08: Auth UI components (3 tasks) + +Each plan: fresh context, peak quality. More plans = more thoroughness, same quality per plan. + + **2-3 tasks, 50% context target:** - All tasks: Peak quality @@ -111,5 +138,7 @@ Each: 30-40% context, peak quality, focused commits **The principle:** Aggressive atomicity. More plans, smaller scope, consistent quality. **The rule:** If in doubt, split. Quality over consolidation. Always. + +**Depth rule:** Depth increases plan COUNT, never plan SIZE. diff --git a/get-shit-done/templates/config.json b/get-shit-done/templates/config.json index 3deca74db..37cf0b934 100644 --- a/get-shit-done/templates/config.json +++ b/get-shit-done/templates/config.json @@ -1,5 +1,6 @@ { "mode": "interactive", + "depth": "standard", "gates": { "confirm_project": true, "confirm_phases": true, diff --git a/get-shit-done/templates/roadmap.md b/get-shit-done/templates/roadmap.md index cd42e125e..6c547a34e 100644 --- a/get-shit-done/templates/roadmap.md +++ b/get-shit-done/templates/roadmap.md @@ -100,7 +100,7 @@ Phases execute in numeric order: 2 → 2.1 → 2.2 → 3 → 3.1 → 4 **Initial planning (v1.0):** -- 3-6 phases total (more = scope creep) +- Phase count depends on depth setting (quick: 3-5, standard: 5-8, comprehensive: 8-12) - Each phase delivers something coherent - Phases can have 1+ plans (split if >3 tasks or multiple subsystems) - Plans use naming: {phase}-{plan}-PLAN.md (e.g., 01-02-PLAN.md) diff --git a/get-shit-done/workflows/create-milestone.md b/get-shit-done/workflows/create-milestone.md index 5f7d1bb43..921552e62 100644 --- a/get-shit-done/workflows/create-milestone.md +++ b/get-shit-done/workflows/create-milestone.md @@ -71,7 +71,17 @@ grep -E "^### Phase [0-9]+" .planning/ROADMAP.md | tail -1 Next phase starts at: [last_phase + 1] -**Gather phases (3-6 recommended):** +**Check depth setting and gather phases accordingly:** + +```bash +cat .planning/config.json 2>/dev/null | grep depth +``` + +| Depth | Phases/Milestone | +|-------|------------------| +| Quick | 3-5 | +| Standard | 5-8 | +| Comprehensive | 8-12 | If context from discuss-milestone provided, use that scope. @@ -359,7 +369,7 @@ Numbers continue from previous milestone. Names describe content. - Don't restart phase numbering at 01 (continue sequence) - Don't add time estimates - Don't create Gantt charts -- Don't plan more than 6 phases per milestone (scope creep) +- Respect depth setting for phase count (quick: 3-5, standard: 5-8, comprehensive: 8-12) - Don't modify completed milestone sections Milestones are coherent chunks of work, not project management artifacts. @@ -368,7 +378,7 @@ Milestones are coherent chunks of work, not project management artifacts. Milestone creation is complete when: - [ ] Next phase number calculated correctly (continues from previous) -- [ ] 3-6 phases defined with clear names +- [ ] Phases defined per depth setting (quick: 3-5, standard: 5-8, comprehensive: 8-12) - [ ] Research flags assigned for each phase - [ ] ROADMAP.md updated with new milestone section - [ ] Phase directories created diff --git a/get-shit-done/workflows/create-roadmap.md b/get-shit-done/workflows/create-roadmap.md index 00bd95c71..b54ae3cee 100644 --- a/get-shit-done/workflows/create-roadmap.md +++ b/get-shit-done/workflows/create-roadmap.md @@ -81,7 +81,35 @@ Select (comma-separate for multiple): -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 +``` + + +**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 + **Phase Numbering System:** diff --git a/get-shit-done/workflows/plan-phase.md b/get-shit-done/workflows/plan-phase.md index a903f3554..9904a53ab 100644 --- a/get-shit-done/workflows/plan-phase.md +++ b/get-shit-done/workflows/plan-phase.md @@ -226,6 +226,34 @@ See ~/.claude/get-shit-done/references/checkpoints.md for checkpoint structure. After tasks, assess against quality degradation curve. +**Check depth setting:** +```bash +cat .planning/config.json 2>/dev/null | grep depth +``` + + +**Plan count targets by depth:** + +| Depth | Plans/Phase | Tasks/Plan | +|-------|-------------|------------| +| Quick | 1-3 | 2-3 | +| Standard | 3-5 | 2-3 | +| Comprehensive | 5-10 | 2-3 | + +**Tasks/plan is ALWAYS 2-3. Depth determines how many plans you create, not how big each plan is.** + +For comprehensive depth: +- Create MORE plans, not bigger ones +- If a phase has 15 tasks, that's 5-8 plans (not 3 plans with 5 tasks each) +- Don't compress to look efficient—thoroughness is the goal +- Each plan stays focused: 2-3 tasks, single concern + +For quick depth: +- Combine aggressively into fewer plans +- 1-3 plans per phase is fine +- Focus on critical path + + **ALWAYS split if:** >3 tasks, multiple subsystems, >5 files in any task, complex domains (auth, payments). **If scope appropriate (2-3 tasks, single subsystem, <5 files/task):** Proceed to confirm_breakdown.