gsd-remove-phase

Roadmap phase removal deletes the unstarted future phase and automatically renumbers all subsequent phases to maintain a linear sequence. This prevents manual edits and keeps the planning document consistent without leaving cancellation markers behind.

Yes, deleting a planned roadmap phase removes it entirely without leaving cancellation markers. The workflow records the cleanup change in a git commit, providing a clean historical record while ensuring the roadmap stays readable.

Validation gates are preserved when deleting an unstarted phase. The removal workflow enforces future-phase and work checks before deletion, ensuring no active work is disrupted while maintaining the integrity of remaining validation gates.

You should avoid automated phase removal if the target phase has already started or contains active work. The workflow enforces future-phase and work checks, blocking deletion of phases with ongoing tasks to prevent breaking the roadmap sequence.

The best way to clean up deferred items is removing the decided-deferred future phase entirely. This approach automatically renumbers subsequent phases, updates ordering, and eliminates the need for manual edits or leaving cancellation clutter in the roadmap.

No, you do not need to manually renumber phases. The removal process automatically updates the ordering of all later phases, ensuring the roadmap stays linear and readable while recording the change in a git commit.