gpd-add-phase

Add a new research phase to the current milestone in ROADMAP.md.

1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/CharlieGreenman/roomtemp-superconductor-gpd --skill gpd-add-phase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpd-add-phase
Source: https://github.com/CharlieGreenman/roomtemp-superconductor-gpd/tree/main/.agents/skills/gpd-add-phase
Command: npx skills add https://github.com/CharlieGreenman/roomtemp-superconductor-gpd --skill gpd-add-phase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Add a new research phase to the end of the current milestone in the roadmap.

Core Features & Use Cases

  • Phase number calculation (next sequential integer)
  • Directory creation with slug generation
  • Roadmap structure updates
  • STATE.md roadmap evolution tracking
  • Validation that ROADMAP.md exists and that STATE.md stays in sync

Quick Start

Run gpd-add-phase <description> to append a new phase to the current milestone.

Frequently Asked Questions about gpd-add-phase

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new research phase to a milestone in my roadmap?

To add a research phase to a milestone, the Skill appends it to the end of the current roadmap. It calculates the next phase number, generates a slug, creates the directory, and updates both ROADMAP.md and STATE.md.

What files are required to manage roadmap state and phase evolution?

Roadmap state management requires existing ROADMAP.md and STATE.md files. The Skill validates that ROADMAP.md exists and uses STATE.md to track roadmap evolution, ensuring both stay in sync when adding phases.

Do I need the gpd CLI to append phases to project milestones?

Yes, appending phases to project milestones requires the gpd CLI. You run the command with a phase description to automate directory creation, slug generation, and state evolution tracking within your research workflow.

How does slug generation and phase number calculation work for roadmap milestones?

Phase number calculation assigns the next sequential integer to the new phase. Slug generation creates a URL-friendly directory name from the provided description, which is then created in the filesystem alongside the roadmap updates.

What happens if my ROADMAP.md and STATE.md files are out of sync?

The Skill includes validation ensuring STATE.md stays in sync with ROADMAP.md. If synchronization fails, the phase addition process halts to prevent roadmap corruption and maintain accurate state evolution tracking.