Best use case
gsd-add-phase is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Add phase to end of current milestone in roadmap
Teams using gsd-add-phase should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/gsd-add-phase/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How gsd-add-phase Compares
| Feature / Agent | gsd-add-phase | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Add phase to end of current milestone in roadmap
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
<cursor_skill_adapter>
## A. Skill Invocation
- This skill is invoked when the user mentions `gsd-add-phase` or describes a task matching this skill.
- Treat all user text after the skill mention as `{{GSD_ARGS}}`.
- If no arguments are present, treat `{{GSD_ARGS}}` as empty.
## B. User Prompting
When the workflow needs user input, prompt the user conversationally:
- Present options as a numbered list in your response text
- Ask the user to reply with their choice
- For multi-select, ask for comma-separated numbers
## C. Tool Usage
Use these Cursor tools when executing GSD workflows:
- `Shell` for running commands (terminal operations)
- `StrReplace` for editing existing files
- `Read`, `Write`, `Glob`, `Grep`, `Task`, `WebSearch`, `WebFetch`, `TodoWrite` as needed
## D. Subagent Spawning
When the workflow needs to spawn a subagent:
- Use `Task(subagent_type="generalPurpose", ...)`
- The `model` parameter maps to Cursor's model options (e.g., "fast")
</cursor_skill_adapter>
<objective>
Add a new integer phase to the end of the current milestone in the roadmap.
Routes to the add-phase workflow which handles:
- Phase number calculation (next sequential integer)
- Directory creation with slug generation
- Roadmap structure updates
- STATE.md roadmap evolution tracking
</objective>
<execution_context>
@.cursor/get-shit-done/workflows/add-phase.md
</execution_context>
<context>
Arguments: {{GSD_ARGS}} (phase description)
Roadmap and state are resolved in-workflow via `init phase-op` and targeted tool calls.
</context>
<process>
**Follow the add-phase workflow** from `@.cursor/get-shit-done/workflows/add-phase.md`.
The workflow handles all logic including:
1. Argument parsing and validation
2. Roadmap existence checking
3. Current milestone identification
4. Next phase number calculation (ignoring decimals)
5. Slug generation from description
6. Phase directory creation
7. Roadmap entry insertion
8. STATE.md updates
</process>Related Skills
gsd-ultraplan-phase
[BETA] Offload plan phase to Cursor's ultraplan cloud — drafts remotely while terminal stays free, review in browser with inline comments, import back via /gsd-import. Cursor only.
gsd-spec-phase
Socratic spec refinement — clarify WHAT a phase delivers with ambiguity scoring before discuss-phase. Produces a SPEC.md with falsifiable requirements locked before implementati...
gsd-secure-phase
Retroactively verify threat mitigations for a completed phase
gsd-ai-integration-phase
Generate AI design contract (AI-SPEC.md) for phases that involve building AI systems — framework selection, implementation guidance from official docs, and evaluation strategy
gsd-ui-phase
Generate UI design contract (UI-SPEC.md) for frontend phases
gsd-research-phase
Research how to implement a phase (standalone - usually use /gsd-plan-phase instead)
gsd-remove-phase
Remove a future phase from roadmap and renumber subsequent phases
gsd-plan-phase
Create detailed phase plan (PLAN.md) with verification loop
gsd-list-phase-assumptions
Surface Claude's assumptions about a phase approach before planning
gsd-insert-phase
Insert urgent work as decimal phase (e.g., 72.1) between existing phases
gsd-execute-phase
Execute all plans in a phase with wave-based parallelization
gsd-discuss-phase
Gather phase context through adaptive questioning before planning. Use --all to skip area selection and discuss all gray areas interactively. Use --auto to skip interactive ques...