| name | expand |
| description | Use when the user asks to expand a task into a concrete task tree. |
| category | core |
| triggers | expand task, break down, subtask, decompose |
| metadata | {"gobby":{"audience":"interactive","depth":0}} |
/gobby expand
Thin wrapper over the expand-task pipeline and the new expansion-run MCP tools.
Plan-Coverage Contract
Expansion consumes typed plans authored under the Plan-Coverage Contract in
src/gobby/install/shared/skills/plan-draft/SKILL.md; the single-page
reference is docs/contracts/plan-coverage.md.
Expansion-side obligations:
- A
.coverage-ledger.yaml companion file MUST exist before expansion
proceeds for new epic plans.
- Created leaves MUST emit structured
covers:<plan-id>:<section-id>:<item-id> labels for the acceptance items
they implement.
expansion-qa is the mechanical gate that compares the expanded task tree
against the compiled contract and records any missing or invalid coverage.
- Free-form
plan-ref: labels are not honored.
Supported Inputs
#N or another task ref
path/to/plan.md together with a target task
Workflow
- Resolve the target task.
- Run the
expand-task pipeline with:
call_tool("gobby-workflows", "run_pipeline", {
"name": "expand-task",
"inputs": {
"task_id": "<task_ref>",
"plan_file": "<optional relative plan path>"
}
})
- Store the returned
execution_id and end the turn. The daemon sends a
durable completion notification and wake signal when the pipeline finishes.
On wake/resume, inspect the run with:
call_tool("gobby-workflows", "get_pipeline_status", {
"execution_id": "<execution_id>"
})
- Report the resulting run status and created tasks.
Notes
- Expansion state lives on
expansion_runs, not on the task record.
- Do not call deprecated save/execute-spec tools.
- Do not call the removed workflow completion-wait tool.
- Use
gobby-tasks-ops:get_latest_expansion_run or get_expansion_run for inspection.