/gz-adr-promote¶
Promote a pool ADR into canonical ADR package structure. Use when moving a backlog item (ADR-pool.*) into an active, versioned ADR.
Purpose¶
/gz-adr-promote exposes the canonical gz-adr-promote workflow for operator invocation. It runs gz adr promote to turn a pool ADR into a versioned ADR package with one OBPI brief per scope item, marks the pool file Superseded and records artifact_renamed and obpi_created in the ledger; gz adr demote is the inverse.
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-adr-promote/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-adr-promote/SKILL.md |
Canonical skill contract | Read |
.claude/skills/gz-adr-promote/SKILL.md |
Claude mirror | Read |
.agents/skills/gz-adr-promote/SKILL.md |
Codex mirror | Read |
Related Skills and Commands¶
| Related | Relationship |
|---|---|
| skills index | Browse the full skill catalog |
| governance runbook | Workflow context |