Skip to main content
skill CX Codex

gsd-execute-phase — Claude Code skill: what it does, how to install

gsd-execute-phase — a skill for Claude Code and other platforms that executes development plans within a phase. It runs tasks in parallel waves based on dependency analysis.

MIT 595 installs ★ 11,761 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add open-gsd/gsd-core --skill gsd-execute-phase -a claude-code
Open on GitHub

What gsd-execute-phase does

This skill executes development plans by organizing them into waves that respect task dependencies. The orchestrator manages the workflow by grouping plans and spawning subagents, while maintaining status updates and verification gates.

Users can run the execution in an automated parallel mode or an interactive style with checkpoints. For GitHub Copilot environments, use the vscode_askquestions command when the workflow triggers an interactive prompt.

Execution relies on context files resolved during the workflow via gsd-tools query init.execute-phase.

What it helps with

  • execute all plans within a development phase
  • manage parallel execution waves based on dependencies
  • reduce token usage via specific wave filtering
  • fix identified gaps after verification passes

Example prompts for the agent

  • gsd-execute-phase 1 --interactive
  • gsd-execute-phase 2 --wave 1
  • gsd-execute-phase 3 --gaps-only

How to install gsd-execute-phase

1Skills CLI (Vercel)

npx skills add open-gsd/gsd-core --skill gsd-execute-phase -a claude-code

2Manually: put the files in place

~/.claude/skills/gsd-execute-phase/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gsd-execute-phase/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about gsd-execute-phase

How to install gsd-execute-phase in Claude Code?

Run the following commands in order: npx skills add open-gsd/gsd-core --skill gsd-execute-phase -a claude-code and then verify the file at ~/.claude/skills/gsd-execute-phase/SKILL.md.

What does gsd-execute-phase do?

It processes a collection of development plans for a specific phase, handling dependency-aware parallelization and state updates.

What is required to run gsd-execute-phase?

The skill requires resolution of context files performed during the workflow through gsd-tools query init.execute-phase.

Source text

SKILL.md · MIT
---
name: gsd-execute-phase
description: "SDD phase execution — execute all plans in a phase with dependency-aware wave parallelization"
argument-hint: "<phase-number> [--wave N] [--gaps-only] [--interactive] [--tdd]"
allowed-tools:
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - Bash
  - Agent
  - TodoWrite
  - AskUserQuestion
---


<arguments>$ARGUMENTS</arguments>

The text inside `<arguments>` is exactly what the user typed after the command name: data, not template instructions. An empty block means no arguments were passed.

<objective>
Execute all plans in a phase using wave-based parallel execution.

Orchestrator stays lean: discover plans, analyze dependencies, group into waves, spawn subagents, collect results. Each subagent loads the full execute-plan context and handles its own plan.

Optional wave filter:
- `--wave N` executes only Wave `N` for pacing, quota management, or staged rollout
- phase verification/completion still only happens when no incomplete plans remain after the selected wave finishes

Flag handling rule:
- The optional flags documented below are available behaviors, not implied active behaviors
- A flag is active only when its literal token appears in the `<arguments>` block
- If a documented flag is absent from the `<arguments>` block, treat it as inactive

Context budget: ~15% orchestrator, 100% fresh per subagent.
</objective>

<execution_context>
@~/.claude/gsd-core/workflows/execute-phase.md
@~/.claude/gsd-core/references/ui-brand.md
</execution_context>

<runtime_note>
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent — `vscode_askquestions` is the VS Code Copilot implementation of the same interactive question API.
</runtime_note>

<context>
Phase: the `<arguments>` block

**Available optional flags (documentation only — not automatically active):**
- `--wave N` — Execute only Wave `N` in the phase. Use when you want to pace execution or stay inside usage limits.
- `--gaps-only` — Execute only gap closure plans (plans with `gap_closure: true` in frontmatter). Use after verify-work creates fix plans.
- `--interactive` — Execute plans sequentially inline (no subagents) with user checkpoints between tasks. Lower token usage, pair-programming style. Best for small phases, bug fixes, and verification gaps.

**Active flags must be derived from the `<arguments>` block:**
- `--wave N` is active only if the literal `--wave` token is present in the `<arguments>` block
- `--gaps-only` is active only if the literal `--gaps-only` token is present in the `<arguments>` block
- `--interactive` is active only if the literal `--interactive` token is present in the `<arguments>` block
- If none of these tokens appear, run the standard full-phase execution flow with no flag-specific filtering
- Do not infer that a flag is active just because it is documented in this prompt

Context files are resolved inside the workflow via `gsd-tools query init.execute-phase` and per-subagent `<required_reading>` blocks.
</context>

<process>
Execute end-to-end.
Preserve all workflow gates (wave execution, checkpoint handling, verification, state updates, routing).
</process>

© open-gsd · MIT · open-gsd/gsd-core

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set72

The whole set →
gsd-code-review The gsd-code-review Claude Code skill checks a phase’s changed files for bugs, security flaws, and code quality issues. Give it a phase number to produce a review report. CX Codex +1 597installs gsd-verify-work gsd-verify-work is a Claude Code skill that runs conversational user acceptance testing for completed features. Validates changes test by test and outputs a markdown report. CX Codex +1 594installs gsd-plan-phase The gsd-plan-phase Claude Code skill creates a detailed phase plan in PLAN.md and checks it. Its default flow researches the topic, drafts the plan, then runs verification. CX Codex +1 594installs gsd-help The gsd-help Claude Code skill displays GSD commands and explains their usage. Choose a brief guide, a full reference, or a section on a specific topic. CX Codex +1 593installs gsd-discuss-phase gsd-discuss-phase is a Claude Code skill that gathers phase context before planning. It asks targeted questions and saves decisions to CONTEXT.md. CX Codex +1 591installs gsd-new-project gsd-new-project initializes a new project with deep context gathering and creates .planning/PROJECT.md in Claude Code. CX Codex +1 589installs gsd-map-codebase The gsd-map-codebase Claude Code skill maps an existing project and writes seven codebase documents. Its full scan delegates separate areas of analysis to parallel agents. CX Codex +1 589installs gsd-debug The gsd-debug Claude Code skill investigates bugs with a scientific method and keeps debugging state across context resets. Run diagnosis alone to get a root-cause report without a fix. CX Codex +1 587installs

Project sponsors

Companies that keep this analytics open