Extract remaining workflows from project.md #137
Description
Context
Phase 33 — project.md Decomposition, final step. After #135 and #136, project.md still contains align_from_gsd (~120 lines), milestone_mapper (~120 lines), drift-reconciliation (~100 lines), and extend (~80 lines) inline. This issue completes the decomposition so project.md becomes ~85 lines of routing logic + @workflow imports. The milestone_mapper step is also used by the Fresh path (vision-cycle.md) and the align path — it needs to be standalone.
What Already Exists
commands/project.md(1979 lines) — post-Extract vision-cycle.md workflow from project.md #136, contains: align_from_gsd step (line 248, ~120 lines), milestone_mapper step (line 311, ~120 lines), drift-reconciliation logic, extend routingcommands/sync.md(243 lines) — also uses align_from_gsd logic; will reference workflows/align-from-gsd.md after extractioncommands/status.md(526 lines) — may reference extend logicworkflows/detect-state.md— exists after Extract detect-state.md workflow from project.md #135workflows/vision-cycle.md— exists after Extract vision-cycle.md workflow from project.md #136; references milestone_mapper which will become workflows/milestone-mapper.md
Description
Complete the decomposition of commands/project.md by extracting four remaining logical chunks into standalone workflow files: workflows/align-from-gsd.md, workflows/milestone-mapper.md, workflows/drift-reconcile.md, workflows/extend-project.md.
Technical Approach
- Extract align_from_gsd + milestone_mapper path →
workflows/align-from-gsd.md(~120 lines) - Extract milestone_mapper step →
workflows/milestone-mapper.md(~120 lines; referenced by both align-from-gsd.md and vision-cycle.md) - Extract drift-reconciliation step →
workflows/drift-reconcile.md(~100 lines) - Extract extend routing →
workflows/extend-project.md(~80 lines) - In project.md, replace each extracted section with
@workflows/filename.md - Update vision-cycle.md to reference
@workflows/milestone-mapper.mdinstead of the inline step
Done When
- All four workflow files exist: workflows/align-from-gsd.md, workflows/milestone-mapper.md, workflows/drift-reconcile.md, workflows/extend-project.md
-
commands/project.mdis ≤200 lines containing only routing logic and @workflow references (target ~85 lines) -
workflows/vision-cycle.mdreferences@workflows/milestone-mapper.mdinstead of inlining the step - Each workflow file has a documented precondition (what STATE_CLASS or input it expects) and postcondition
-
commands/sync.mdreferences workflows/align-from-gsd.md where it currently inlines equivalent logic
GSD Route
Quick task or GSD Phase 33 plan.
Phase Context
Phase 33 of 36 — project.md Decomposition. Issues: #135 (blocks), #136 (blocks), #137 (this).
Depends on
#136 — vision-cycle.md must exist first (milestone-mapper.md will be cross-referenced from it).