Planner Skill
Thin wrapper that delegates plan creation to planner-agent.
Delegation skill for planning workflows.
Validate planning inputs, delegate plan creation, and update task state.
See Execution Flow for preflight/delegation/postflight steps.
Validate metadata file, plan artifact, and status updates.
Brief text summary; metadata file in specs/{N}_{SLUG}/.return-meta.json.
Context References
Reference (do not load eagerly):
- Path:
.opencode/context/core/formats/return-metadata-file.md- Metadata file schema - Path:
.opencode/context/core/patterns/postflight-control.md- Marker file protocol - Path:
.opencode/context/core/patterns/file-metadata-exchange.md- Metadata file handling - Path:
.opencode/context/core/patterns/jq-escaping-workarounds.md- jq workaround patterns - Path:
.opencode/context/index.md- Context discovery index
Trigger Conditions
- Task status allows planning
- /plan command invoked
Execution Flow
- Validate task and status.
- Update status to planning.
- Create postflight marker file.
- Delegate to
planner-agentvia Task tool. - Read metadata file and update state + TODO.
- Link plan artifact and commit.
- Clean up marker and metadata files.