gsd-add-phase

Adding a new phase to a milestone roadmap is automated by calculating the next integer phase number, generating a directory slug from your description, creating the phase directory, and inserting the roadmap entry while updating STATE.md for traceability.

Tracking roadmap state when appending a project phase is handled by automatically updating STATE.md. This ensures the roadmap evolution is recorded and traceability is maintained without requiring manual edits to state tracking files.

Slug generation for phase directories works by deriving a URL-friendly slug from the phase description you provide. This slug is then used for consistent directory naming when the new phase is created at the end of the current milestone.

Yes, this milestone phase automation applies specifically to repository-based project workflows that manage milestones, phase directories, and roadmap state during development and releases. It integrates phase creation directly into your repository structure.

No dependencies are required to append an integer phase to your milestone. The Skill operates standalone to calculate the next phase number, generate the slug, create the directory, and update the roadmap and STATE.md files.

Automating milestone phase creation removes the friction of manually calculating phase numbers, creating directories, and updating state tracking. It ensures consistent naming and traceability while preventing contributors from forgetting to update STATE.md.