gsd-phase

SkillDev tools

Lets your agent add, edit, or remove phases in a ROADMAP.md planning file.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the gsd-phase skill

About this capability

CRUD for phases in ROADMAP.md — add, insert, remove, or edit phases

What this skill tells your AI

The instructions your AI receives, as published by open-gsd/gsd-core in skills/gsd-phase/SKILL.md and read by ahel’s review.

Mode routing:

  • default (no flag): Add a new integer phase to the end of the current milestone → add-phase workflow
  • --insert: Insert urgent work as a decimal phase (e.g., 72.1) between existing phases → insert-phase workflow
  • --remove: Remove a future phase and renumber subsequent phases → remove-phase workflow
  • --edit: Edit any field of an existing phase in place → edit-phase workflow
FlagActionWorkflow
(none)Add new integer phase at end of milestoneadd-phase
--insertInsert decimal phase (e.g., 72.1) after specified phaseinsert-phase
--removeRemove future phase, renumber subsequentremove-phase
--editEdit fields of existing phase in placeedit-phase

<execution_context> @/.claude/gsd-core/workflows/add-phase.md @/.claude/gsd-core/workflows/insert-phase.md @/.claude/gsd-core/workflows/remove-phase.md @/.claude/gsd-core/workflows/edit-phase.md </execution_context>

Parse the first token of $ARGUMENTS:

  • If it is --insert: strip the flag, pass remainder (format: ) to insert-phase workflow
  • If it is --remove: strip the flag, pass remainder (phase number) to remove-phase workflow
  • If it is --edit: strip the flag, pass remainder (phase-number [--force]) to edit-phase workflow
  • Otherwise: pass all of $ARGUMENTS (phase description) to add-phase workflow

Roadmap and state are resolved in-workflow via init phase-op and targeted reads.

Signals

GitHub stars
9k
Forks
680
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
gsd-phase
Source
github.com/open-gsd/gsd-core