tvproductions/gzkit / .agents/skills/gz-constitute
gz-constitute
VerifiedUse to create or refresh governance constitution artifacts.
gz constitute
Overview
Self-Escalation (opus-tier). The dialogue with the operator stays in the main session: a subagent cannot ask the operator a question or hear the answer, and what the operator adds is this skill's primary input. When the session model is below opus-tier, you may spawn an
Agentwithmodel="opus"for a bounded drafting or QC track that needs no operator input — pass the operator's words verbatim and the relevant context (ADR IDs, OBPI IDs, prior decisions), and treat what it returns as a draft you verify, not as the operator-facing result.
Scaffold a constitution, then fill it with the operator. gz constitute <name>
(constitute in src/gzkit/commands/init_cmd.py):
- requires an initialized project (
.gzkit.json); otherwise it exits 1; - canonicalizes
nametoCONSTITUTION-<SLUG>-<semver>: a leadingCONSTITUTION-is dropped, a trailing-X.Y.Zbecomes the semver (default1.0.0), and the rest is stripped to alphanumerics and upper-cased, socharterbecomesCONSTITUTION-CHARTER-1.0.0(GHI #216). A name with no alphanumeric character exits 1; - renders the
constitutiontemplate (src/gzkit/templates/constitution.md) withstatus: Draft, today's date and--title(default: the id) into<paths.constitutions>/<id>.md; - appends one
constitution_createdledger event, which makes the id a node in thegz stategraph.
The scaffold holds placeholder principles and rules; the content comes from the
operator. It does not check for an existing file: a name that canonicalizes to
an existing id overwrites that file and appends a second event. --dry-run
prints the path and event it would write, whether or not the file exists, and
writes nothing.
Workflow
- Preview:
uv run gz constitute <name> --dry-run. If the printed path already exists, stop — that constitution is revised in place, not re-scaffolded. - Create it:
uv run gz constitute <name> [--title "<title>"]. - Draft each section the template requires with the operator — Purpose, Scope,
Principles, Rules (requirement, rationale, verification), Exceptions,
Amendments — using the operator's words.
required_headersinsrc/gzkit/schemas/constitution.jsonis the authority for the sections and the permittedstatusvalues. - Validate:
uv run gz validate --documentschecks the frontmatter and headers against that schema. Capture the output to a file and read$?straight after it. - Report the id, path and validation result. Changing
statusfromDraftis the operator's ratification, not the agent's.
Example
uv run gz constitute charter --dry-run
uv run gz constitute charter --title "Project Charter"
uv run gz validate --documents
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 |