Verified:GitHub

gsd-add-phase

Adds a new sequential phase to the current milestone in a project roadmap.

Updated Feb 18, 2026

Search Tags:#project planning #roadmap #slug generation #state tracking #milestone #phase

One-click install

npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-add-phase-jjchambers80

Or copy as Structured Prompt for Agent▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually adding phases to a project roadmap requires calculating the next phase number, creating directories, and updating roadmap and state files consistently, which is error-prone when done by hand. ## Core Features & Use Cases - Automatic Phase Numbering: Calculates the next sequential integer phase number, ignoring decimal phases. - Directory and Slug Generation: Creates the phase directory with a slug derived from the provided description. - Roadmap and State Updates: Inserts the new phase entry into the roadmap and records the evolution in STATE.md. - Use Case: While working through a milestone, you realize a new phase is needed. Provide a short description and the workflow appends the correctly numbered phase to the roadmap with all tracking files updated. ## Quick Start Ask the assistant to add a new phase to the current milestone with a short description, such as adding a phase for user authentication improvements.

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 project roadmap?▼

Invoke the skill with a short phase description as the argument. The workflow calculates the next sequential integer phase number, generates a slug, creates the phase directory, and updates the roadmap and STATE.md automatically.

How is the next phase number calculated in a roadmap?▼

The workflow identifies the current milestone and computes the next sequential integer, ignoring any decimal phase numbers already present. This ensures the new phase is appended as a whole-number phase at the end of the milestone.

What happens if no roadmap exists when adding a phase?▼

The workflow performs a roadmap existence check before making changes. If no roadmap is found, the phase cannot be added, so a roadmap must be initialized first.

Can I add a decimal or sub-phase with this workflow?▼

No, this workflow only appends integer phases to the end of the current milestone. Decimal phases are ignored during number calculation, so sub-phase insertion requires a different operation.