refactor: rename depth setting to granularity (closes #879)
The "depth" setting with values quick/standard/comprehensive implied investigation thoroughness, but it only controls phase count. Renamed to "granularity" with values coarse/standard/fine to accurately reflect what it controls: how finely scope is sliced into phases. Includes backward-compatible migration in loadConfig and config-ensure that auto-renames depth→granularity with value mapping in both .planning/config.json and ~/.gsd/defaults.json. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -14,7 +14,7 @@ Check if `--auto` flag is present in $ARGUMENTS.
|
||||
**If auto mode:**
|
||||
- Skip brownfield mapping offer (assume greenfield)
|
||||
- Skip deep questioning (extract context from provided document)
|
||||
- Config: YOLO mode is implicit (skip that question), but ask depth/git/agents FIRST (Step 2a)
|
||||
- Config: YOLO mode is implicit (skip that question), but ask granularity/git/agents FIRST (Step 2a)
|
||||
- After config: run Steps 6-9 automatically with smart defaults:
|
||||
- Research: Always yes
|
||||
- Requirements: Include all table stakes + features from provided document
|
||||
@@ -90,13 +90,13 @@ YOLO mode is implicit (auto = YOLO). Ask remaining config questions:
|
||||
```
|
||||
AskUserQuestion([
|
||||
{
|
||||
header: "Depth",
|
||||
question: "How thorough should planning be?",
|
||||
header: "Granularity",
|
||||
question: "How finely should scope be sliced into phases?",
|
||||
multiSelect: false,
|
||||
options: [
|
||||
{ label: "Quick (Recommended)", description: "Ship fast (3-5 phases, 1-3 plans each)" },
|
||||
{ label: "Standard", description: "Balanced scope and speed (5-8 phases, 3-5 plans each)" },
|
||||
{ label: "Comprehensive", description: "Thorough coverage (8-12 phases, 5-10 plans each)" }
|
||||
{ label: "Coarse (Recommended)", description: "Fewer, broader phases (3-5 phases, 1-3 plans each)" },
|
||||
{ label: "Standard", description: "Balanced phase size (5-8 phases, 3-5 plans each)" },
|
||||
{ label: "Fine", description: "Many focused phases (8-12 phases, 5-10 plans each)" }
|
||||
]
|
||||
},
|
||||
{
|
||||
@@ -169,7 +169,7 @@ Create `.planning/config.json` with mode set to "yolo":
|
||||
```json
|
||||
{
|
||||
"mode": "yolo",
|
||||
"depth": "[selected]",
|
||||
"granularity": "[selected]",
|
||||
"parallelization": true|false,
|
||||
"commit_docs": true|false,
|
||||
"model_profile": "quality|balanced|budget",
|
||||
@@ -379,13 +379,13 @@ questions: [
|
||||
]
|
||||
},
|
||||
{
|
||||
header: "Depth",
|
||||
question: "How thorough should planning be?",
|
||||
header: "Granularity",
|
||||
question: "How finely should scope be sliced into phases?",
|
||||
multiSelect: false,
|
||||
options: [
|
||||
{ label: "Quick", description: "Ship fast (3-5 phases, 1-3 plans each)" },
|
||||
{ label: "Standard", description: "Balanced scope and speed (5-8 phases, 3-5 plans each)" },
|
||||
{ label: "Comprehensive", description: "Thorough coverage (8-12 phases, 5-10 plans each)" }
|
||||
{ label: "Coarse", description: "Fewer, broader phases (3-5 phases, 1-3 plans each)" },
|
||||
{ label: "Standard", description: "Balanced phase size (5-8 phases, 3-5 plans each)" },
|
||||
{ label: "Fine", description: "Many focused phases (8-12 phases, 5-10 plans each)" }
|
||||
]
|
||||
},
|
||||
{
|
||||
@@ -468,7 +468,7 @@ Create `.planning/config.json` with all settings:
|
||||
```json
|
||||
{
|
||||
"mode": "yolo|interactive",
|
||||
"depth": "quick|standard|comprehensive",
|
||||
"granularity": "coarse|standard|fine",
|
||||
"parallelization": true|false,
|
||||
"commit_docs": true|false,
|
||||
"model_profile": "quality|balanced|budget",
|
||||
@@ -903,7 +903,7 @@ Task(prompt="
|
||||
- .planning/PROJECT.md (Project context)
|
||||
- .planning/REQUIREMENTS.md (v1 Requirements)
|
||||
- .planning/research/SUMMARY.md (Research findings - if exists)
|
||||
- .planning/config.json (Depth and mode settings)
|
||||
- .planning/config.json (Granularity and mode settings)
|
||||
</files_to_read>
|
||||
|
||||
</planning_context>
|
||||
@@ -1090,7 +1090,7 @@ Exit skill and invoke SlashCommand("/gsd:discuss-phase 1 --auto")
|
||||
- [ ] Brownfield detection completed
|
||||
- [ ] Deep questioning completed (threads followed, not rushed)
|
||||
- [ ] PROJECT.md captures full context → **committed**
|
||||
- [ ] config.json has workflow mode, depth, parallelization → **committed**
|
||||
- [ ] config.json has workflow mode, granularity, parallelization → **committed**
|
||||
- [ ] Research completed (if selected) — 4 parallel agents spawned → **committed**
|
||||
- [ ] Requirements gathered (from research or conversation)
|
||||
- [ ] User scoped each category (v1/v2/out of scope)
|
||||
|
||||
@@ -157,7 +157,7 @@ Write `~/.gsd/defaults.json` with:
|
||||
```json
|
||||
{
|
||||
"mode": <current>,
|
||||
"depth": <current>,
|
||||
"granularity": <current>,
|
||||
"model_profile": <current>,
|
||||
"commit_docs": <current>,
|
||||
"parallelization": <current>,
|
||||
|
||||
Reference in New Issue
Block a user