gsd-add-phase

Add an integer phase to the current milestone and update roadmap and STATE.md.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill gsd-add-phase-mint-ia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-add-phase
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/gsd-add-phase
Command: npx skills add https://github.com/MINT-IA/MINT --skill gsd-add-phase-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the manual and error-prone process of adding a new, sequential phase to the current milestone in a repository-based roadmap, ensuring consistent numbering, slugs, and state tracking.

Core Features & Use Cases

  • Next-phase calculation: Determines the next integer phase number for the current milestone, ignoring decimal versions.
  • Directory and slug creation: Generates a filesystem-safe slug from the provided description and creates the corresponding phase directory.
  • Roadmap and STATE.md updates: Inserts a roadmap entry and updates STATE.md to reflect the roadmap evolution for reproducible project tracking.
  • Use Case: Ideal for repo-driven product teams who maintain milestones and phases in-file and need deterministic, repeatable updates when planning sprints or release activities.

Quick Start

Add a new phase with the description "finalize onboarding flow" to append the next integer phase to the current milestone and update the roadmap and STATE.md.

Frequently Asked Questions about gsd-add-phase

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

FAQPage Schema
How do I add a new phase to a milestone in a repository roadmap?

To add a new phase to a milestone in a repository roadmap, this Skill calculates the next sequential integer, generates a filesystem-safe slug from your description, creates the phase directory, and updates the roadmap and STATE.md files automatically.

What is the best way to automate sequential phase numbering for project milestones?

Automating sequential phase numbering is handled by calculating the next integer phase for the current milestone while ignoring decimal versions, ensuring deterministic and repeatable numbering for your release activities directly within your roadmap structure.

Can I generate a slug from a description when creating a roadmap phase directory?

Yes, you can generate a slug from a description when creating a roadmap phase directory. The Skill uses deterministic filesystem operations to derive a safe slug and create the corresponding directory alongside the roadmap entry.

Does this roadmap phase automation tool require external dependencies or components?

No external dependencies or components are required. The Skill operates using built-in Read, Write, and Bash tool calls to perform deterministic filesystem operations for updating the roadmap and STATE.md tracking files.

When should I use an automated script to update STATE.md and roadmap entries?

You should use an automated script to update STATE.md and roadmap entries when planning sprints or release activities in repo-driven product teams, ensuring consistent state tracking and avoiding manual errors during milestone evolution.