gsd-phase

Manage project phase CRUD operations in ROADMAP.md files.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/nnexai/git-stacks --skill gsd-phase-nnexai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-phase
Source: https://github.com/nnexai/git-stacks/tree/main/.codex/skills/gsd-phase
Command: npx skills add https://github.com/nnexai/git-stacks --skill gsd-phase-nnexai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the manual overhead of maintaining project roadmaps by providing a structured, command-line interface to modify phases within a ROADMAP.md file.

Core Features & Use Cases

  • Phase CRUD: Add, insert, remove, or edit project phases with automated renumbering.
  • Workflow Routing: Intelligent routing based on flags to handle integer and decimal phase numbering.
  • Use Case: When a new urgent task arises, use the insert flag to add a decimal phase between existing milestones without manually recalculating the entire roadmap sequence.

Quick Start

Invoke the gsd-phase skill by typing the command followed by your desired action flag and the phase description to update your roadmap.

Frequently Asked Questions about gsd-phase

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

FAQPage Schema
How do I automate project phase updates in a markdown roadmap file?▼

Automate project phase updates by using command-line CRUD operations to add, insert, remove, or edit entries directly within a ROADMAP.md file. This maintains sequential integrity automatically, eliminating manual recalculations when modifying project milestones.

What is the best way to add an urgent task between existing project milestones?▼

The best way to add an urgent task between existing milestones is using the insert flag. This action adds a decimal phase between current milestones, preserving sequential numbering without requiring you to manually recalculate the entire roadmap sequence.

How does phase tracking handle integer and decimal numbering in roadmap management?▼

Phase tracking handles integer and decimal numbering through intelligent workflow routing based on command flags. This routing mechanism directs phase-specific logic, allowing both standard sequential milestones and inserted decimal sub-phases to coexist seamlessly.

Do I need a specific workflow environment to manage roadmap phases?▼

Yes, managing roadmap phases requires integration with GSD workflow core components to execute phase-specific logic and validation gates. This dependency ensures automated renumbering and phase lifecycle transitions function correctly.

Can I remove a project phase without breaking the sequential integrity of my roadmap?▼

Yes, you can remove a project phase without breaking sequential integrity. The automated CRUD operations renumber the remaining phases instantly, ensuring your ROADMAP.md file maintains a logical, continuous progression after deletion.