feat(11-01): add read_parallelization_config step to plan-phase workflow

- Reads .planning/config.json parallelization settings early
- Documents planning behavior when parallel enabled vs disabled
- Placed after load_project_state, before load_codebase_context
- Default: assume parallelization enabled for new projects
This commit is contained in:
Lex Christopherson
2026-01-12 14:08:19 -06:00
parent 560ef346be
commit 8e67241e73
3 changed files with 53 additions and 6 deletions

View File

@@ -17,7 +17,8 @@ None - this is internal GSD development following existing command/workflow/temp
- [ ] **Phase 1: Templates & Structure** - Create codebase map templates and folder structure
- [ ] **Phase 2: Map Codebase Command** - Build /gsd:map-codebase with parallel Explore agents
- [ ] **Phase 3: Integration** - Wire brownfield support into existing GSD workflows
- [ ] **Phase 10: Parallel Phase Execution** - Separate single-plan vs multi-plan execution with intelligent parallelization
- [x] **Phase 10: Parallel Phase Execution** - Separate single-plan vs multi-plan execution with intelligent parallelization
- [ ] **Phase 11: Parallel-Aware Planning** - Update plan-phase.md to create parallelizable plans when config enables it
## Phase Details
@@ -167,6 +168,28 @@ Parallelization features (adapted from PR #43):
- Merge conflict detection as failsafe
- Configurable via `.planning/config.json` parallelization section
### Phase 11: Parallel-Aware Planning
**Goal:** Update plan-phase.md to create plans optimized for parallel execution when parallelization is enabled
**Depends on:** Phase 10
**Research:** Unlikely (extending existing plan-phase workflow)
**Plans:** 4 plans
Plans:
- [ ] 11-01: Update phase-prompt template - Add parallelization frontmatter fields (parallelizable, depends_on, files_exclusive)
- [ ] 11-02: Add parallel-aware step to plan-phase workflow - Read config, restructure for vertical slices, document independence
- [ ] 11-03: Update execute-phase to use plan frontmatter - Use explicit markers instead of inference, backward compat
- [ ] 11-04: Documentation and examples - Update references, add parallel vs sequential planning examples
**Details:**
Current plan-phase.md has sequential execution bias - later plans reference earlier SUMMARY.md, file overlap is acceptable, no independence markers. When parallelization enabled in config.json, planning should:
- Group by vertical slice (feature A, feature B) not workflow stage (setup → implement → test)
- Avoid unnecessary inter-plan dependencies (only reference SUMMARY if genuinely needed)
- Mark explicit file ownership per plan
- Add frontmatter: `parallelizable: true/false`, `depends_on: []`, `files_exclusive: []`
This enables execute-phase to produce more Wave 1 plans (true independence) instead of sequential chains.
## Progress
**Execution Order:**
@@ -184,3 +207,4 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6
| 8. Improve Roadmap System | 1/1 | Complete | 2026-01-05 |
| 9. Integrate Verify-Work | 1/1 | Complete | 2026-01-08 |
| 10. Parallel Phase Execution | 4/4 | Complete | 2026-01-12 |
| 11. Parallel-Aware Planning | 0/4 | Not Started | - |

View File

@@ -19,12 +19,12 @@
## Current Position
Phase: 10 of 10 (Parallel Phase Execution)
Plan: 4 of 4 in current phase
Status: Phase complete
Last activity: 2026-01-12 - Completed 10-04-PLAN.md
Phase: 11 of 11 (Parallel-Aware Planning)
Plan: 0 of 4 in current phase
Status: Not started
Last activity: 2026-01-12 - Added Phase 11 to roadmap
Progress: █████████████ 100% (19 of 19 plans)
Progress: ████████████░ 83% (19 of 23 plans)
## Performance Metrics
@@ -89,6 +89,7 @@ None yet.
- Phase 8 added: Improve roadmap system
- Phase 9 added: Integrate verify-work (community contribution from OracleGreyBeard)
- Phase 10 added: Parallel phase execution (rename workflow, create /gsd:execute-phase with parallelization)
- Phase 11 added: Parallel-aware planning (update plan-phase.md to create parallelizable plans when enabled)
## Project Alignment

View File

@@ -54,6 +54,28 @@ Read `.planning/STATE.md` and parse:
If STATE.md missing but .planning/ exists, offer to reconstruct or continue without.
</step>
<step name="read_parallelization_config" priority="second">
Read parallelization settings from config.json:
```bash
cat .planning/config.json 2>/dev/null | jq '.parallelization'
```
**Extract settings:**
- `enabled`: Whether parallel execution is available (default: true)
- `plan_level`: Whether plan-level parallelization is enabled (default: true)
**Store for later steps:**
- If `parallelization.enabled && parallelization.plan_level`: Planning will optimize for independence
- Group tasks by vertical slice (feature A, feature B) not workflow stage (setup → implement → test)
- Avoid unnecessary inter-plan dependencies
- Mark explicit file ownership per plan via files_exclusive
- Set parallelizable: true when genuinely independent
- If disabled: Planning proceeds with sequential assumptions (current behavior)
**If config.json missing:** Assume parallelization enabled (new projects get it by default).
</step>
<step name="load_codebase_context">
Check for codebase map: