gsd-phase

Adds, inserts, removes, and edits phases in ROADMAP.md through routed workflows.

1|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill gsd-phase-igorganapolsky
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-phase
Source: https://github.com/IgorGanapolsky/Random-Timer/tree/main/.cursor/skills/gsd-phase
Command: npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill gsd-phase-igorganapolsky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing project roadmap phases manually in ROADMAP.md is error-prone, especially when inserting urgent work between phases, renumbering after removals, or editing phase fields consistently. ## Core Features & Use Cases - Add Phase: Append a new integer phase to the end of the current milestone with a single command. - Insert Phase: Insert urgent work as a decimal phase (e.g., 72.1) between existing phases using the --insert flag. - Remove & Edit Phases: Remove a future phase with automatic renumbering via --remove, or edit any field of an existing phase in place via --edit. - Use Case: While executing a milestone, an urgent bug fix arrives. Run the skill with --insert to slot it in as phase 72.1 without disturbing the rest of the roadmap. ## Quick Start Ask the assistant to run gsd-phase with a phase description to add a new phase, or with --insert, --remove, or --edit followed by the phase number to modify the roadmap.

Frequently Asked Questions about gsd-phase

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

FAQPage Schema
How do I add a new phase to ROADMAP.md?▼

Invoke gsd-phase with a phase description and no flag. The skill routes to the add-phase workflow, which appends a new integer phase to the end of the current milestone.

How do I insert urgent work between existing roadmap phases?▼

Use the --insert flag followed by the phase number to insert after and a description. The insert-phase workflow creates a decimal phase such as 72.1 between existing phases without renumbering the rest.

What happens to phase numbers when I remove a phase?▼

The --remove flag triggers the remove-phase workflow, which deletes a future phase and automatically renumbers all subsequent phases so the roadmap stays sequential.

Can I edit an existing phase without removing it?▼

Yes, use --edit followed by the phase number, optionally with --force. The edit-phase workflow modifies fields of the phase in place while preserving its validation gates.

What are the limitations of decimal phase insertion?▼

Decimal insertion is intended for urgent work between existing integer phases and requires specifying the phase to insert after. It depends on the insert-phase workflow's validation, so malformed arguments or invalid phase numbers are rejected.