gsd-remove-phase

Remove unstarted GSD roadmap phases and renumber subsequent phases.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-remove-phase-dobrinz123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-phase
Source: https://github.com/dobrinz123/claude-skills-share/tree/main/skills/gsd-remove-phase
Command: npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-remove-phase-dobrinz123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Remove an unstarted future phase from a project's roadmap and avoid leaving cancelled markers or broken numbering that confuse planning and execution.

Core Features & Use Cases

  • Safe Removal: Validates the target phase is unstarted before deletion to prevent data loss of active work.
  • Automatic Renumbering: Renumbers all subsequent phases to preserve a clean, linear sequence across the milestone.
  • Audit Trail: Commits the change to git for historical traceability and review.
  • Use Case: When a planned phase is deprioritized, run this workflow to delete it, renumber the roadmap, and record the change without manual edits.

Quick Start

Remove phase 3 from the roadmap, renumber all subsequent phases, and commit the change to git.

Frequently Asked Questions about gsd-remove-phase

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove a planned phase from a roadmap and renumber the remaining milestones?

The workflow validates the target phase is unstarted, deletes it, automatically renumbers subsequent phases to preserve a linear sequence, and records the operation with a git commit.

Can I safely delete a future roadmap phase without breaking milestone numbering?

Yes, the workflow validates the phase is unstarted before deletion and automatically renumbers all following phases to preserve a clean, linear sequence across the milestone.

Does the GSD workflow support git commits for cancelled roadmap phases?

Yes, when cancelling planned work, the workflow records the phase removal and renumbering operation with a git commit to ensure historical traceability and review.

What happens if I try to remove an active phase from the milestone sequence?

The workflow prevents data loss by validating that the target phase is future or unstarted before deletion, blocking the removal of any active work from the milestone sequence.

What is the best way to clean up a project roadmap before execution when work is deprioritized?

Run this workflow to delete the deprioritized phase, automatically renumber subsequent milestones, and record the change with a git commit, avoiding manual edits to the roadmap.