Skip to content

tvproductions/gzkit / .agents/skills/gz-adr-sync

gz-adr-sync

Verified

Use to reconcile an ADR end to end by discovering @covers evidence, reconciling OBPI ledger state and registering files.

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 — repo-wide @covers coverage (REQ/OBPI/ADR granularity)
uv run gz covers

# 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-recon and gz-adr-autolink are 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 skillAbsorbed as
gz-adr-autolinkLayer 1 phase (evidence gathering)
gz-adr-reconLayer 2 phase (ledger reconciliation)
gz-register-adrsLayer 3 phase (registration)

References

  • Command implementation: src/gzkit/cli/
  • User docs: docs/user/manpages/register-adrs.md, docs/user/manpages/adr-status.md, docs/user/manpages/adr-audit-check.md
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall