gsd-add-phase

To add a new phase to a milestone, the Skill computes the next sequential integer and generates a slug from your description, then updates the roadmap directory structure and STATE.md file automatically.

If no milestone is set, the roadmap state tracking uses a safe fallback mechanism during phase creation. This prevents errors by validating arguments before attempting to compute the next phase number or generate directory paths.

Slug generation for sequential roadmap phases derives a URL-friendly identifier from the provided phase description. This slug is used consistently for directory creation and STATE.md entries across the active milestone.

Yes, you can automate roadmap milestone updates without manual bookkeeping by providing a phase description. The Skill handles sequential numbering, slug generation, directory creation, and documentation updates in one workflow.

A key limitation when adding phases is that it only appends to the end of the current milestone using computed next sequential numbers. It does not support inserting phases out of order or renumbering existing roadmap structures.