gsd-add-phase

Add an integer phase to the current milestone and update ROADMAP.md and STATE.md.

8|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/D0NMEGA/donnyclaude --skill gsd-add-phase-d0nmega
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-add-phase
Source: https://github.com/D0NMEGA/donnyclaude/tree/main/packages/skills/gsd-add-phase
Command: npx skills add https://github.com/D0NMEGA/donnyclaude --skill gsd-add-phase-d0nmega

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Roadmaps and milestones often require consistent phase addition; this Skill automates appending a new phase to the end of the current milestone, ensuring consistent structure and traceability.

Core Features & Use Cases

  • Compute the next phase number and generate a slug from the description.
  • Create the phase directory and update ROADMAP.md and STATE.md accordingly.
  • Validate inputs and ensure safe, idempotent updates with basic error handling.

Quick Start

Provide a phase description when prompted, and the Skill will append the next phase to the current milestone.

Frequently Asked Questions about gsd-add-phase

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

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

To add a new phase to a milestone automatically, you provide a phase description. The automation computes the next integer phase number, slugifies the description, creates the phase directory, and updates ROADMAP.md and STATE.md atomically.

What is the best way to ensure consistent structure when appending project phases?

The best way to ensure consistent structure when appending project phases is using an automated workflow that computes the next phase number, generates a slug, and writes updates atomically to ROADMAP.md and STATE.md for traceability.

Do I need a specific roadmap format to automate milestone phase creation?

You need an existing ROADMAP.md file and a STATE.md file to automate milestone phase creation. The Skill validates inputs and handles missing roadmap errors, but requires these specific markdown files to append phases successfully.

How does phase slugification work when updating a project roadmap?

Phase slugification works by converting your provided phase description into a URL-friendly slug. This slug is used to name the new phase directory, which is then recorded in ROADMAP.md and STATE.md during the automated update.

What happens if the roadmap file is missing during project phase addition?

If the roadmap file is missing during project phase addition, the automation includes basic error handling to catch the issue. It validates the input and safely aborts the update, ensuring no inconsistent directories or state files are created.