If you are unsure what something is, read the canon; do not guess (guessing is how the fake lith monorepo got fabricated). Start here, then the files named below.
- Holes before anything else — fix soundness holes before features/perf/docs.
- Fixes first, on firm foundations — ground-truth by running the tool, not trusting status docs.
- Fail loudly, seal soundly — no silent green; seams (ABI/FFI) sealed & proven.
- Distrust the neural for exactness — licences/invariants/equivalence belong to PLASMA (formal), not to an LLM. Your edits there are provisional + supervised.
- Squabble, don't bypass — reach green by satisfying the gate, never by admin-override.
- No automated licence edits — ever — manual, owner-only; third-party untouchable.
- No deletion by access-recency — cold ≠ disposable.
- Wire first — unwired is not done.
- Always sign commits (
id_ed25519_signing; verifystatus:G). - Report faithfully — no overclaim (the AFFIRMATION ethos).
- Stop-first when an action is costly to undo or outward-facing.
- Boundaries are real — respect IS / IS-NOT; never assimilate or rename across them.
- Equivalence as identity — the estate's intellectual through-line.
- Solutions at source — fix the canonical/upstream origin, never patch the downstream symptom; trace and respect every up- and down-stream before you act.
- Elegance by default — treat the most elegant and correct long-term option as the default arm; when you put a choice to the owner, LABEL which option that is, and if you recommend another, name both arms and say why you depart. Binds unasked design calls too: report the departure, never absorb it.
- Cheap models for upkeep: CI/CD, workflow, template-drift and status-file work does not get a top-tier model. If it needs real effort, stop and say so, then open a thread on cheaper models (Sonnet and Haiku). Keep top-tier models for proof work and hard design.
CHORA → ANCHOR → AGENTIC → ECOSYSTEM → STATE -> NEUROSYM -> PLAYBOOK
ANCHOR, AGENTIC, ECOSYSTEM, STATE, NEUROSYM and PLAYBOOK are clauses of the CHORA deed — (anchor), (agentic), (ecosystem), (status) and (maturity), (neurosym), (playbook) — not files; STATE's journal is docs/status/ROADMAP.adoc. There are no .a2ml files in this estate.
The descriptive family (working name descriptiles) describes what-is; the contractiles are the normative set-point.
| File | Answers |
|---|---|
xmlpull-zig_chora.deed |
CHORA, the repo deed. Its (identity) (clade) (lineage) clauses say what this repo IS (registers into gv-clade-index); (meta) the architecture axes; (agentic) may I act now?; (ecosystem) where it sits and what it is not; (status) and (maturity) where it is now. Read fields with scripts/deed-field.sh. |
(anchor) |
Semantic authority + golden path — what downstream may extend-not-redefine; if a recognised-drift / re-anchor marker is present, it supersedes accumulated context — read it first. |
(neurosym) |
Meaning of operations — proof obligations. |
(playbook) |
How permitted actions run. |
docs/status/ROADMAP.adoc |
What is next — milestones, blockers, next actions. |
| contractiles | Normative doctrine: Intend (north-star) · Must (invariants) · Trust (security) · Adjust (accessibility / inclusive design) — the integral core that holds strong; plus Dust (exnovation drift) · Bust (failure / breakage, not drift). |
| k9 | Validation. Kennel (data) / Yard (pure eval) / Hunt (guarded exec). |
hyperpolymath/standards— the canon source. ·hyperpolymath/gv-clade-index— the estate map (identity registry). ·hyperpolymath/manifesto— this doctrine.- Before you invent, rename, or consolidate anything: STOP and check the map + IS-NOT.
Deny: Nix, Python, Go, TypeScript, Deno, ReScript, AGPL. (Guix, not Nix.) JavaScript runtime: Bun (package.json + bun.lock) > pnpm > npm (last resort, permitted). Deno is retired, not grandfathered (owner ruling 2026-08-26, standards#655): existing Deno projects migrate to Bun. Use plain JavaScript when this tooling is needed. TypeScript and ReScript migrate to AffineScript.
- Identity — uuid
12f79705-0c45-527e-b7d9-2369b7627921; cladeUNASSIGNED(secondary ``); born 2026-11-12; forgehyperpolymath/xmlpull-zig. - IS — UNASSIGNED
- IS-NOT — (not yet declared — add (ecosystem :not (…)) to the deed)
- Where it sits — pipeline position ****; chain ``; coordination =
standards. - Constraints here (AGENTIC) — fail-closed; evidence-per-step; no-silent-skip; rerun-after-fix; release-claim-requires-hard-pass. Never: banned langs (above), secrets, state files in repo root, AGPL. Details: the deed's
(bot-directives (methodology) (coverage) (debt))clauses. - Golden path (ANCHOR) —
just test && just quality→ Core tests pass; Quality gates pass; No unresolved critical security findings. - State — phase incubating; maturity experimental. Milestones and next actions:
docs/status/ROADMAP.adoc.
IMPORTANT FOR ALL AGENTS (Claude, Codex, Gemini, Mistral, etc.):
This estate enforces strict format standards. Failure to follow these causes estate drift and broken tooling. These rules are NOT optional.
KYAML (KEP-5295, owner rulings D280/D307): YAML content is KYAML.
- Estate-owned config uses the
.kyamlextension. .yml/.yamlonly where a tool demands the name: GitHub workflows, dependabot. Workflows migrate to KYAML content only once the lock-coverage shim is a required context (D280); leave them alone until then.- Use
yq(Go version) and the estate scriptskyaml-format.sh,kyaml-migrate.sh. No Python YAML parsers (D293). - KYAML format:
{}for maps,[]for lists, double-quoted strings, unquoted keys where unambiguous, trailing commas OK, 2-space indent. KYAML is a subset of YAML; every YAML parser accepts it.
JSON (owner ruling D306): every .json/.jsonl is I-JSON (RFC 7493),
serialised by JCS (RFC 8785), one record per line for JSON Lines. Extensions
do not change. Tool: hyperpolymath/ijson-jcs. Rule and gate:
standards/3-practice/JSON-POLICY.adoc. Tool-demanded JSONC
(devcontainer.json) is carved out.
UUIDv8 (owner ruling D305, standards ADR-008): mint every new identifier
as UUIDv8 in the ADR-008 layout. Do not rewrite existing v4/v7 identifiers by
hand; that migration is done per repo (ADR-008 phase P3). In deed files use
#u5 literals until the deed ABNF admits v8; a #u7 literal is illegal.
.a2ml → deed: A2ML is retired; never create or restore a .a2ml file.
- Grammars:
standards/1-formats/deed/spec/abnf/deed.abnf(authoritative over the deed README, D308) andstandards/1-formats/k9/for k9. - Descriptiles (anchor, meta, state, ecosystem, agentic, neurosym, playbook)
are clauses of
xmlpull-zig_chora.deed(D312). - Contractiles (intend, must, trust, adjust, bust, dust) are k9 contracts in
.machine_readable/contractiles/<verb>/. The deed attests to them (:contractiles_required, and a(contractiles …)clause per D312). - Do not hand-convert A2ML in bulk: conversion is kyX's first front end (D313).
ENFORCEMENT: these rulings are recorded on standards#787. Some are
ruled but not yet gated: check the gate on standards main before
relying on it.