gsd-remove-phase

Remove an unstarted roadmap phase and renumber subsequent phases.

264|11|Updated Apr 25, 2026

Search Tags:#workflow automation #validation #roadmap #git commit #renumbering #phase removal

Ready to run

npx skills add https://github.com/coco-research/coco --skill gsd-remove-phase-coco-research

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gsd-remove-phase
Source: https://github.com/coco-research/coco/tree/main/systems/gsd/skills/gsd-remove-phase
Command: npx skills add https://github.com/coco-research/coco --skill gsd-remove-phase-coco-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes a planned-but-not-started roadmap phase without leaving cancellation clutter behind, while keeping the roadmap sequence consistent.

Core Features & Use Cases

Phase Removal: Deletes a future phase that you no longer want to pursue.
Automatic Renumbering: Updates all later phases so the roadmap stays linear and easy to read.
Safe Workflow Execution: Preserves validation checks and creates a git commit as a historical record.
Use Case: A team decides to drop a feature after planning and wants the roadmap cleaned up without manual edits or broken phase numbering.

Quick Start

Ask the skill to remove the specified future phase from the roadmap and renumber all later phases automatically.

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 breaking the numbering sequence?▼

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.

Can I delete a planned roadmap phase without leaving cancellation clutter in git history?▼

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.

What happens to validation gates when I delete an unstarted phase from the roadmap?▼

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.

When should I avoid using automated phase removal on my roadmap?▼

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.

What is the best way to clean up deferred items from a phase-based roadmap?▼

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.

Do I need to manually renumber roadmap phases after deleting one?▼

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.