gz-adr-map
Use to trace an ADR to its artifacts with gz state and repository search.
SKILL.md.claude/skills/gz-adr-map/SKILL.md
GitHubgz-adr-map
Construct ADR traceability with the available gz and repo-local tooling.
Procedure
# 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
Notes
<!-- gz-validate-skip: command-shape -->- There is no dedicated
gz adr mapsubcommand in this repository. - This skill is intentionally workflow-based instead of a single command.
References
- Command implementation:
src/gzkit/cli/(parsers) andsrc/gzkit/commands/(command bodies) - User docs:
docs/user/manpages/state.md,docs/user/manpages/adr-audit-check.md