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.