What problem does it solve?
It prevents fragile, manual handoffs when finishing work in the GSD → Superpowers → sg-retro loop by reliably completing the requested phase or closing the current/target milestone while archiving lessons and recording handoff state.
Core Features & Use Cases
- Phase completion (bare number): Completes a specific planning phase by delegating to sg-phase so the phase-owned reconciliation runs exactly once.
- Milestone closure (vX.Y or current): Archives lessons for the milestone version, appends a HANDOFF row for the complete stage, and then delegates to gsd-complete-milestone to finish the milestone.
- Stage-safe argument parsing: Distinguishes
vX.Y (milestone versions) from bare phase numbers to avoid accidentally passing an incorrect value to gsd-complete-milestone.
Use case: You finish planning and retro work for a milestone and want the system to archive the resulting lessons, update the orchestration ledger, and close the milestone without you manually running the right sequence of commands.
Quick Start
Run /super-gsd:sg-complete v1.4 to archive lessons and close milestone v1.4 via the gsd-complete-milestone handoff.