gsd-add-phase

Automating roadmap phase creation involves computing the next integer phase number, generating a slug from a description, creating the directory, and updating both ROADMAP and STATE.md files for project synchronization.

Slug generation for roadmap milestones works by deriving a URL-friendly slug from the provided phase description, which is then used to create the phase directory and insert the corresponding entry into the ROADMAP.

Calculating the next phase number for a milestone requires identifying the current milestone in the roadmap and computing the next sequential integer, explicitly ignoring any decimal values in existing phase numbers.

Updating STATE.md and ROADMAP files simultaneously is supported by validating input, detecting the current milestone, inserting the new phase into the roadmap, and synchronizing the project state document.

The best way to append a new phase to the end of a current milestone is to run an automated workflow that parses arguments, detects the milestone, computes the phase number, and updates the roadmap.

Roadmap phase numbering ignores decimals during insertion to ensure sequential integer progression for high-level planning, preventing fractional phases from disrupting the automated slug generation and directory creation workflow.