gz-adr-map

Use to trace an ADR to its artifacts with gz state and repository search.

SKILL.md

GitHub

gz-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 map subcommand in this repository.
  • This skill is intentionally workflow-based instead of a single command.

References

  • Command implementation: src/gzkit/cli/ (parsers) and src/gzkit/commands/ (command bodies)
  • User docs: docs/user/manpages/state.md, docs/user/manpages/adr-audit-check.md