skills.rest
gesmith0606
gesmith0606COMMUNITY
Explore all skills by this author →
GitHub

gsd-add-phase

Add a new integer phase to the current milestone in the roadmap.

Updated Aug 15, 2025
Search Tags:#automation#roadmap#filesystem#milestone#slug#state-tracking#phase
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-add-phase-gesmith0606
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-add-phase
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-add-phase
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-add-phase-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates manual bookkeeping when evolving a project's roadmap by automatically adding a next-sequential integer phase to the active milestone, creating the needed directory and updating roadmap state so teams don't lose track of iteration history.

Core Features & Use Cases

  • Next-phase calculation: Determines the next integer phase number for the current milestone, ignoring decimal sub-phases.
  • Slugged directory creation: Generates a filesystem-safe slug from the phase description and creates the phase directory.
  • Roadmap and STATE.md updates: Inserts the new phase into the roadmap structure and records the evolution in STATE.md for traceability.
  • Use Case: Add a new feature development phase to a sprint milestone so the team can track tasks, artifacts, and historical changes without manual file edits.

Quick Start

Add a new phase titled Design API with description Implement core endpoints to the end of the current milestone.

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 project roadmap?▼

To add a new phase to a milestone, the workflow calculates the next sequential integer phase, generates a filesystem-safe slug, creates the directory, and updates the roadmap and STATE.md file for traceability.

What is the best way to automate roadmap milestone phase creation?▼

Automating roadmap milestone phase creation involves invoking a dedicated workflow that validates inputs, calculates the next phase number ignoring decimal sub-phases, and records all structural changes automatically in STATE.md.

Does adding a roadmap phase require filesystem write permissions?▼

Yes, adding a roadmap phase requires filesystem write permissions to create the new phase directory and update the repository's roadmap entries and state tracking files.

How does slug generation work when creating roadmap phase directories?▼

Slug generation works by converting the provided phase description into a filesystem-safe slug, which is then used to create the corresponding phase directory within the current milestone structure.

Can I append decimal sub-phases to the current milestone using this workflow?▼

No, the workflow specifically calculates the next sequential integer phase for the milestone, ignoring decimal sub-phases to maintain clean iteration history and directory structure.

Why is STATE.md updated when a new roadmap phase is added?▼

STATE.md is updated to record the evolution of the roadmap and provide traceability, ensuring teams do not lose track of iteration history when new phases are appended to a milestone.

Related Skills

Explore More Product & Management Skills→
Pear-CommercePear-Commerce

gsd-add-phase

Add sequential integer phases to the active GSD milestone roadmap.

Official
Intermediate
sunholo-datasunholo-data
33

AILANG Sprint Executor

Execute approved sprint plans with test-driven development and lint checks.

Official
Intermediate
imbue-aiimbue-ai
213

restack

Merge parent branch commits into child branches in a git stack.

Official
Advanced
DuySeuDuySeu
1

gsd-add-phase

Adds an integer phase to the current milestone in the project roadmap.

Community
Advanced