gz-adr-sync
Sync ADR governance by discovering @covers annotations and reconciling ledger states.
Install
mkdir -p .claude/skills/gz-adr-sync && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10684" && unzip -o skill.zip -d .claude/skills/gz-adr-sync && rm skill.zipInstalls to .claude/skills/gz-adr-sync
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
End-to-end ADR governance sync — discover @covers evidence, reconcile OBPI ledger state, and register ADR files. Accepts an optional ADR-ID for scoped reconciliation.Key capabilities
- →Discover @covers evidence
- →Reconcile OBPI ledger
- →Register ADR files
- →Audit ADR status
- →Verify evidence gaps
How it works
It executes a three-layer sync process covering evidence discovery, ledger reconciliation, and registration.
Inputs & outputs
When to use gz-adr-sync
- →Register new ADRs
- →Reconcile ADR ledger
- →Verify ADR coverage evidence
About this skill
gz-adr-sync
End-to-end ADR governance sync. Absorbs gz-adr-autolink (Layer 1), gz-adr-recon (Layer 2), and the original gz-adr-sync (Layer 3) into a single operator-facing skill. Run after multi-session work, after importing pool ADRs, or before requesting ADR closeout.
Modes
Full sync (no ADR-ID)
Runs all three layers in trust order.
# Layer 1 — discover @covers annotations
rg -n '@covers\("ADR-' tests
# Layer 2 — global ledger reconciliation
uv run gz status --json
# Layer 3 — register and refresh
uv run gz register-adrs --dry-run
uv run gz register-adrs
uv run gz status
Scoped (with ADR-ID)
Reconciles a single ADR and its OBPIs. Use when verifying evidence gaps or preparing a specific ADR for closeout.
# Layer 1 — discover @covers annotations for target ADR
uv run gz adr covers-check ADR-<X.Y.Z>
# Layer 2 — ledger reconciliation for target
uv run gz adr status ADR-<X.Y.Z> --json
uv run gz adr audit-check ADR-<X.Y.Z> --json
# After any doc updates, re-lint
uv run gz lint
Notes
gz-adr-reconandgz-adr-autolinkare archived; this skill is their successor.- The runbook prescribes full sync before closeout; scoped mode is for targeted investigation.
- Apply markdown table updates manually after evidence discovery, then run
uv run gz lint.
Archived predecessors
| Archived skill | Absorbed as |
|---|---|
gz-adr-autolink | Layer 1 phase (evidence gathering) |
gz-adr-recon | Layer 2 phase (ledger reconciliation) |
gz-register-adrs | Layer 3 phase (registration) |
References
- Command implementation:
src/gzkit/cli.py - User docs:
docs/user/manpages/register-adrs.md,docs/user/manpages/adr-status.md,docs/user/manpages/adr-audit-check.md
When not to use it
- →Manual ADR registration
Prerequisites
Limitations
- →Requires GovZero v6 framework
- →Manual markdown table updates required
How it compares
It consolidates multiple legacy ADR tools into a single operator-facing workflow.
Compared to similar skills
gz-adr-sync side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| gz-adr-sync (this skill) | 0 | 2mo | Review | Intermediate |
| generate-release-notes | 7 | 8mo | Review | Intermediate |
| release-note-generation | 5 | 3mo | Review | Intermediate |
| codex-review | 5 | 6mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by tvproductions
View all by tvproductions →You might also like
generate-release-notes
teambit
Generate comprehensive release notes for Bit from git commits and pull requests. Use when creating release notes, building changelogs, documenting version releases, or preparing a new Bit release.
release-note-generation
microsoft
Toolkit for generating PowerToys release notes from GitHub milestone PRs or commit ranges. Use when asked to create release notes, summarize milestone PRs, generate changelog, prepare release documentation, request Copilot reviews for PRs, update README for a new release, manage PR milestones, or collect PRs between commits/tags. Supports PR collection by milestone or commit range, milestone assignment, grouping by label, summarization with external contributor attribution, and README version bumping.
codex-review
davila7
Professional code review with auto CHANGELOG generation, integrated with Codex AI
rsyslog-doc-dist
rsyslog
Ensures doc/Makefile.am stays in sync with changes to documentation files.
prepare-release
mysticaltech
Use when preparing a release - generates changelog, updates version references, and creates release notes
release
serithemage
Runs a comprehensive release review before tagging and publishing a new version. Reviews code, docs, tests, security, cost, and operations; use platform-native parallelism when available and a sequential fallback otherwise.