Menu
Build ADR-to-artifact traceability using gz state and repository search.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Validate and stage a candidate rendition from the corpus via gz content compose. Use when the agent has made compression decisions (drop/combine/rewrite of compressible corpus entries toward the declared setpoint) and wants the tool to validate invariant-floor compliance, compute byte evidence, write the candidate artifact, and emit a ledger event.
Enter and exit the MX Maintenance Hangar — operator's interface to gz mx. Use when entering the hangar to perform governance repair, checking hangar status mid-session, or cleanly exiting when repair is complete. Operator operates the skill; the skill invokes gz mx; nobody shells out.
Create and resume session handoff documents for agent context preservation across engineering sessions.
Create and resume session handoff documents for agent context preservation across engineering sessions.
Collaborative design dialogue that produces GovZero ADR artifacts. Use when exploring a new feature, capability, or architectural change before implementation — replaces superpowers brainstorming for this project. Triggers on "design X", "let's design", "brainstorm X", "I want to build X", "gz-design".
Cross the airlock membrane — the entry/exit gate every unit of work passes through (ADR-0.33.0). Use to inspect a target's seam-map before touching it (`gz airlock in`), account for what a transit disturbed (`gz airlock out`), or make a governed ad-hoc reconnaissance entry with light repair at most (`gz permitted-entry`). Diagnostic-only for now — a staged posture, not the declared end state; never writes L1 canon.
| name | gz-adr-map |
| description | Build ADR-to-artifact traceability using gz state and repository search. |
| category | adr-operations |
| compatibility | GovZero v6 framework; manual mapping workflow |
| metadata | {"skill-version":"1.2.1","govzero-framework-version":"v6","govzero-author":"GovZero governance team","govzero_layer":"Layer 1 - Evidence Gathering"} |
| gz_command | state |
| invocation | uv run gz state --json |
| lifecycle_state | active |
| owner | gzkit-governance |
| last_reviewed | "2026-07-25T00:00:00.000Z" |
| model | haiku |
Construct ADR traceability with the available gz and repo-local tooling.
# 1) ADR/OBPI graph from ledger
uv run gz state --json
# 2) ADR -> REQ -> test coverage hop
# Decorators are REQ-level (`@covers("REQ-X.Y.Z-NN-MM")`), not ADR-level.
# Traceability hop is ADR -> OBPI briefs (Acceptance Criteria REQ IDs) -> @covers(REQ-...).
uv run gz covers ADR-0.3.0 # canonical traceability walker (replace with target ADR)
rg -n '@covers\("REQ-' tests # raw REQ-decorator survey across the repo
# 3) Validate a target ADR's linked briefs
uv run gz adr audit-check ADR-0.3.0 --json
gz adr map subcommand in this repository.src/gzkit/cli/ (parsers) and src/gzkit/commands/ (command bodies)docs/user/manpages/state.md, docs/user/manpages/adr-audit-check.md