gsd-remove-phase

Delete unstarted GSD roadmap phases and renumber subsequent entries.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill gsd-remove-phase-pear-commerce
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-phase
Source: https://github.com/Pear-Commerce/pear-ai-skills/tree/main/skills/gsd-remove-phase
Command: npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill gsd-remove-phase-pear-commerce

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually deleting unneeded future phases from a project roadmap and renumbering all subsequent entries is tedious and error-prone, often leading to messy, non-linear roadmaps that are difficult to track and follow.

Core Features & Use Cases

  • Future Phase Validation: Automatically checks that the target phase is unstarted to prevent accidental deletion of in-progress work.
  • Automatic Renumbering: Updates all subsequent phase numbers to maintain a clean, linear sequence with no gaps.
  • Change Tracking: Creates a git commit to document the phase removal for historical reference and team transparency.
  • Use Case: If you decide to cut a planned phase 3 from your GSD project roadmap, this skill will delete the phase and automatically renumber the original phase 4 to 3, phase 5 to 4, and so on, with a commit recording the change.

Quick Start

Use the gsd-remove-phase skill to delete the unstarted phase 2 from your current project roadmap and renumber all later phases accordingly.

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 future phase from a roadmap and renumber the remaining milestones?

To remove a future phase from a roadmap and renumber milestones, this skill automatically deletes the unstarted phase and sequentially updates all subsequent phase numbers to maintain a clean, linear sequence without manual gap-filling.

Can I delete a planned project phase that has already started?

You cannot delete an in-progress project phase because the skill performs future phase validation to prevent accidental deletion of started work, ensuring only unstarted planned milestones are removed from your roadmap.

What happens to phase numbering when I cut a future milestone from my project roadmap?

When cutting a future milestone from a project roadmap, automatic renumbering updates all subsequent phase numbers to eliminate gaps, shifting later phases down to preserve a continuous linear sequence.

Does removing a planned phase from a roadmap get tracked in version control?

Removing a planned phase from a roadmap is tracked in version control through an automatically generated git commit that documents the milestone deletion for historical reference and team transparency.

Why does manually deleting future phases from a project roadmap cause tracking errors?

Manually deleting future phases from a project roadmap causes tracking errors because it often leaves non-linear gaps in milestone sequences, making the remaining phases difficult to track and follow accurately.