tvproductions/gzkit / .agents/skills/gz-content-compose
gz-content-compose
VerifiedUse after compression decisions on a corpus to validate and stage the candidate rendition with byte evidence.
gz-content-compose
Overview
Wield gz content compose to validate and stage a candidate rendition of a
control surface toward a target consumer (vendor) at the declared compression
setpoint. This is the compress stage of the ADR-0.0.37 CMS pipeline:
corpus → compress → rendition → playback.
The tool is deterministic. NO LLM call, NO network I/O. The drop/combine/rewrite compression judgment is the agent's (this skill is the LLM surface). The tool validates, accounts bytes, and writes the candidate.
The tool NEVER writes a rendered surface. AGENTS.md, CLAUDE.md, and
their mirrors are byte-unchanged after every compose run. Only the candidate
artifact under .gzkit/renditions/ and the ledger change.
Workflow
- Read the corpus for the target surface:
.gzkit/corpus/<surface>.jsonl— the append-only source of truth- Identify
tier: invariantentries — these MUST appear verbatim in the candidate - Identify
tier: compressibleentries — these can be dropped, combined, or rewritten
- Know the setpoint — resolve via
gz validate --setpoint-coherenceor readdata/vendor-manifest.jsoncontent_type_temperatures.<ContentType>.<consumer>. The setpoint islite,medium, orheavy. - Draft the candidate text — compress the compressible entries toward the setpoint:
lite: maximum compression; include only the highest-priority compressible entriesmedium: balanced compressionheavy: minimal compression; include most compressible content- Invariant-tier entries MUST appear verbatim (0-Kelvin floor — no exceptions)
- Write the candidate to a temp file (e.g.
/tmp/candidate.md) - Run the compose tool to validate + stage:
gz content compose <surface> --consumer <vendor> --candidate /tmp/candidate.md
- Confirm the output — check byte evidence and candidate path:
test -s .gzkit/renditions/<surface>/<consumer>.candidate.md
grep "composition_candidate_emitted" .gzkit/ledger.jsonl
- The candidate flows to the advisor-QC loop (OBPI-24) and operator attestation (OBPI-22) before promotion to a committed rendition.
Before commit: the retention map
gz content commit enforces a retention gate (ADR-0.35.0 § Decision item 10,
GHI #1090/#1091; manpage content § "Retention gate: --retention-map") when
the candidate drops a block the consumer's prior committed rendition
carried. The gate proves only bytes; whether the extraction was independent,
whether a KEPT span carries its quote's meaning, and whether the operator
actually ruled each drop live in this procedure, not in the tool. Before
running commit:
- Find the removed blocks before committing. Compare the consumer's
committed rendition
.gzkit/renditions/<surface>/<consumer>.mdwith the candidate block by block (a block is a heading, paragraph, list item or table row; a fenced code block is one block); every prior block whose text does not appear in the candidate is removed. No committed rendition, or no removed block, means no map is needed.gz content commithas NO dry run: without a map it exits 3 and names each removed block, but when nothing was removed it PROMOTES (exit 0) — never run it as a probe with attestation words the operator did not say. - Dispatch an independent reviewer — a different model from the author
wherever one is available; otherwise a fresh-context agent, and say so —
to extract the binding conditions of each removed block, verbatim. The
reviewer's identity goes in
extracted_by; it must differ frommapped_by. - The author (you) maps each condition: KEPT with the verbatim candidate
span that carries it, or DROPPED with a reason; sentences that bind
nothing go in
non_bindingwith a reason. Every meaningful character of each removed block must be covered. - The reviewer verifies every KEPT pair (quote -> span) for sameness of
meaning, and every
non_bindingexemption; the tool checks only byte presence. Record the reviewer's verdict on each pair, and present it to the operator alongside the DROPPED ids in step 5. - Present every DROPPED condition to the operator by id (e.g.
C2), with its quote and reason, and obtain the operator's own words ruling each drop. Never author attestation text the operator did not say. - Commit with
--retention-map <file>and the operator's words in--attestation-text, which must contain every DROPPED id at a token boundary. On exit 3, read every named violation and repair the map; never delete a condition to make the refusal go away.
Output Contract
On success (exit 0):
- Candidate written to
.gzkit/renditions/<surface>/<consumer>.candidate.md composition_candidate_emittedledger event carryingsurface,consumer,setpoint, and per-tier byte evidence- Byte evidence printed to stdout
On failure (exit 1):
- No candidate written
- Error to stderr naming the cause (absent corpus / undeclared setpoint / invariant violation)
Do Not
- Call any Anthropic/LLM API in tool code — the tool is deterministic; this skill IS the LLM surface
- Promote the candidate (
gz content commit) except through § Before commit: the retention map, with the operator's own attestation words - Rewrite or drop
tier: invariantentries in the candidate text - Claim compose is complete without running
gz content composeand confirmingexit 0 - Edit
AGENTS.md,CLAUDE.md, or any mirror during this skill — rendered surfaces are never touched - Mark a condition KEPT at a candidate span that does not carry its removed quote's meaning — byte presence is not sameness of meaning
- Author or paraphrase the operator's drop ruling — a DROPPED condition's attestation words must be the operator's own, never invented on their behalf
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: 197k | 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 |