gsd-remove-phase

Remove a phase from ROADMAP.md and synchronize CHANGELOG and STATE.md.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/optivent/gsd-kimi-cli --skill gsd-remove-phase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-phase
Source: https://github.com/optivent/gsd-kimi-cli/tree/main/skills/gsd-remove-phase
Command: npx skills add https://github.com/optivent/gsd-kimi-cli --skill gsd-remove-phase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Remove a phase from the project roadmap when it is no longer needed or was created by mistake.

Core Features & Use Cases

  • Remove a phase from ROADMAP.md to keep plans current.
  • Optionally archive related work, renumber subsequent phases, and synchronize state references.
  • Use case: canceling a planned phase and cleaning up the roadmap while preserving history.

Quick Start

Run the removal command for the target phase number, ensuring safety checks are satisfied.

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 phase from a project roadmap?

Removing a phase from a project roadmap involves targeting the specific phase number within ROADMAP.md. The process enforces safety checks and requires a force flag for potentially destructive deletions to prevent accidental data loss.

Can I archive a roadmap phase instead of permanently deleting it?

Yes, archiving a roadmap phase is supported instead of permanent deletion. The process allows optional archiving when canceling a planned phase, enabling you to clean up the roadmap while preserving historical project data and related work logs.

Does removing a roadmap phase automatically renumber subsequent phases?

Yes, removing a roadmap phase supports optional phase renumbering. When you delete a phase, the skill can renumber subsequent phases to maintain sequential consistency across your roadmap documentation and state synchronization files.

How does roadmap phase removal synchronize project state and changelogs?

Roadmap phase removal synchronizes project state by updating STATE.md and logging changes in the CHANGELOG. This ensures that state references and historical logs accurately reflect the deletion, keeping project management documents consistent.

What happens if I try to delete a roadmap phase without the force flag?

Attempting to delete a roadmap phase without the force flag blocks the operation. The skill enforces safety checks and requires explicit force commands for potentially destructive deletions to protect your project roadmap data from accidental removal.

When should I prune phases from my project roadmap?

You should prune phases from your project roadmap when they are no longer needed or were created by mistake. This keeps your plans current and cleans up the roadmap while preserving history through optional archiving and state synchronization.