SDD phase execution — execute all plans in a phase with dependency-aware wave parallelization
68%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./pi/package-skills/gsd-execute-phase/SKILL.mdInvoke this Pi skill with /skill:gsd-execute-phase.
Pi dispatch (fail closed). Pi has no built-in subagent API; GSD provides the gsd_dispatch tool. Where a workflow step dispatches a named gsd-* role, call gsd_dispatch with role (the installed role name) and task (the full task text). A workflow that still writes the step as an Agent(...) call means the same: its subagent_type is the role and its prompt is the task. The role runs in an isolated child session and cannot dispatch further, so a step that needs nested dispatch cannot run on Pi. If gsd_dispatch reports the role unresolved or the child failed, STOP that step and surface the error. If the workflow marks the step optional, say so and offer to skip it and continue; if it is required, stop the run. Never execute the role's work inline as a substitute.
Pi includes. Pi does not expand @path references in a skill. Before doing anything else, read every file listed under <execution_context> below with your read tool (the leading @ is accepted), then follow the workflow they define.
(the text typed after the skill name)
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.
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 rolloutFlag handling rule:
<arguments> block<arguments> block, treat it as inactiveContext budget: ~15% orchestrator, 100% fresh per subagent.
<execution_context> @GSD_PI_ENGINE_ROOT/gsd-core/workflows/execute-phase.md @GSD_PI_ENGINE_ROOT/gsd-core/references/ui-brand.md </execution_context>
Phase: the `` blockAvailable 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> blockContext files are resolved inside the workflow via gsd-tools query init.execute-phase and per-subagent <required_reading> blocks.
open-gsd/gsd-core
99bbbac
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.