/gz-plan¶
Create ADR artifacts for planned change. Use when recording architecture intent and lane-specific scope.
Purpose¶
/gz-plan exposes the canonical gz-plan workflow for operator invocation. It sizes an ADR's decomposition with the operator, then runs gz plan create to write the ADR from its template and book adr_created for a feature ADR; a pool ADR is written but not booked until gz register-adrs runs.
When to Use¶
Invoke this skill when the task described above matches your current workflow stage. The governance runbook at docs/governance/governance_runbook.md lists the canonical workflows and points at this skill where appropriate.
What to Expect¶
The skill reads its canonical execution contract from .gzkit/skills/gz-plan/SKILL.md (mirrored into .claude/skills/, .agents/skills/, and .github/skills/). Follow the agent-facing instructions in that file for the exact execution protocol, stages, and evidence requirements.
Invocation¶
| Argument / Flag | Required | Description |
|---|---|---|
| (see SKILL.md) | — | Arguments are defined by the canonical skill contract |
Supporting Files¶
| File | Role | Read/Write |
|---|---|---|
.gzkit/skills/gz-plan/SKILL.md |
Canonical skill contract | Read |
.claude/skills/gz-plan/SKILL.md |
Claude mirror | Read |
.agents/skills/gz-plan/SKILL.md |
Codex mirror | Read |
Related Skills and Commands¶
| Related | Relationship |
|---|---|
| skills index | Browse the full skill catalog |
| governance runbook | Workflow context |