tvproductions/gzkit / .agents/skills/gz-adr-emit-receipt
gz-adr-emit-receipt
VerifiedUse to record a completed, validated or closed ADR receipt event with its evidence.
gz adr emit-receipt
Overview
Record one ADR receipt event (completed, validated or closed) in the
ledger with uv run gz adr emit-receipt.
Workflow
- Confirm the ADR ID and read its
laneandkindfrom frontmatter; they decide what the evidence must carry. - Choose the event and build
--evidence-jsonfor it:completedneedsvalue_narrativeandkey_proof. On Heavy lane or Foundation kind it also needshuman_attestation(true),attestation_textandattestation_date(see--help).validatedis a Gate-5 human attestation.attestation_text(orscope) carries the operator's verbatim words and is refused when empty. Never author words the operator did not say.closedis the ADR closeout. It refuses at exit 3 while any OBPI has an unwaived REQ coverage gap.
- Record the operator as
--attestor g0, never a real name (AGENTS.md§ Execution Rules, operator PII). - Run with
--dry-runto see the event, then run it for real. - Summarize results, including evidence and any follow-up gates.
Validation
- Verify command output reflects the requested scope.
- If governance state changed, confirm with uv run gz status or uv run gz state.
Example
uv run gz adr emit-receipt ADR-X.Y.Z \
--event validated \
--attestor g0 \
--evidence-json '{"attestation_text": "<operator verbatim words>. Receipts: arb-ruff-<id>, arb-step-typecheck-<id>, arb-step-unittest-<id>, arb-step-mkdocs-<id>", "attestation_date": "YYYY-MM-DD"}'
On Heavy lane / foundation kind, the attestation text MUST cite the arb-*
receipt IDs emitted by the canonical ARB steps (gz arb ruff, gz arb typecheck,
gz arb step --name unittest ..., gz arb step --name mkdocs ...). The gate reads the IDs
from the attestation_text (or scope) prose only; a separate receipts list is not read.
A text citing no receipt fails closed at exit 3 before the receipt is recorded (locked by
CANONICAL_STEP_COMMANDS; see AGENTS.md § Attestation).
The $gz-adr-emit-receipt token in agents/openai.yaml names this skill
for Codex; it is not a CLI alias. Every agent runs the literal
uv run gz adr emit-receipt ... command shown above.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |