gpd-remove-phase

Remove unstarted future phases from a GPD roadmap and renumber subsequent phases.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-remove-phase-michaelsengineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpd-remove-phase
Source: https://github.com/MichaelsEngineering/get-physics-done-test/tree/main/.agents/skills/gpd-remove-phase
Command: npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-remove-phase-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the removal of a planned but unstarted research phase from a GPD roadmap and updates the associated ROADMAP.md and STATE.md to maintain a clean, linear sequence.

Core Features & Use Cases

  • Phase validation: Ensures the target phase is in the future and not completed, preventing accidental data loss.
  • Roadmap/state synchronization: Renumbers subsequent phases and updates ROADMAP.md, STATE.md, and related metadata.
  • CLI delegation: Delegates the actual removal to the GPD CLI and records a descriptive commit message.

Quick Start

Invoke the command with the target phase number to remove, such as gpd-remove-phase 17, and confirm when prompted.

Frequently Asked Questions about gpd-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 research roadmap and renumber the rest?

The phase-removal process enforces validation to ensure the target phase is in the future and unstarted, preventing accidental data loss. It checks the phase status before allowing any deletion to proceed.

Can I delete a phase that has already started or been completed?

After removing a future phase, the process automatically updates the ROADMAP.md and STATE.md files by renumbering subsequent phases and related metadata to maintain a synchronized, linear sequence.

Does the roadmap phase removal process require manual state file updates?

Yes, the phase-removal process requires user confirmation before executing the deletion. After confirming, it delegates the removal to the CLI and records a descriptive commit message for tracking.

What happens to the state and roadmap files after deleting an unstarted phase?

The process is triggered by invoking a command with the target phase number, such as specifying phase 17. The system validates the phase is unstarted, prompts for confirmation, executes the removal, and records a commit message.