gsd-remove-phase

Remove an unstarted roadmap phase and renumber subsequent phases.

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/ArtRiv/game-topicos-especiais --skill gsd-remove-phase-artriv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-phase
Source: https://github.com/ArtRiv/game-topicos-especiais/tree/main/.github/skills/gsd-remove-phase
Command: npx skills add https://github.com/ArtRiv/game-topicos-especiais --skill gsd-remove-phase-artriv

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you remove a future, unstarted phase from a roadmap without leaving confusing gaps or outdated numbering.

Core Features & Use Cases

  • Removes an unstarted future phase: targets only phases that have not begun yet, preventing accidental deletion of active work.
  • Renumbers subsequent phases: updates all later phases so the roadmap stays linear and consistent.
  • Records the change in git history: creates a commit that preserves the action as an audit-friendly record.

Use Case: You planned Phase 3 and Phase 4, but Phase 3 was cancelled before any work started; remove Phase 3 and automatically renumber Phase 4 to become Phase 3.

Quick Start

Use gsd-remove-phase to delete the specified unstarted phase and automatically renumber all later phases in the roadmap.

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 without leaving numbering gaps?

To remove a future phase from a roadmap without leaving numbering gaps, delete the unstarted phase and automatically renumber all subsequent phases to maintain linear sequence consistency. This prevents confusing gaps and outdated numbering in your project timeline.

Can I delete an active phase from my roadmap using this workflow?

No, you cannot delete an active phase because the workflow applies validation gates requiring the target phase to be future and unstarted. This prevents accidental deletion of active work and ensures only cancelled planned phases are removed.

How to renumber phases in a roadmap after cancelling an unstarted phase?

To renumber phases after cancelling an unstarted phase, remove the target phase and automatically update all later phases to eliminate sequence gaps. This maintains linear progression and keeps the roadmap structure consistent for ongoing workflow execution.

Does removing a roadmap phase create a git commit for audit history?

Yes, removing a roadmap phase creates a git commit that preserves the deletion and renumbering action as an audit-friendly record. This ensures the phase management change is tracked in version control history for future reference.

What are the limitations of removing roadmap phases during workflow execution?

The main limitation is that the phase must be future and unstarted; active phases cannot be targeted. Additionally, the workflow strictly requires passing validation gates before executing the removal and renumbering process to prevent data loss.