Skip to content

Latest commit

 

History

History
115 lines (93 loc) · 8.49 KB

CLAUDE.md

File metadata and controls

115 lines (93 loc) · 8.49 KB

You are in the hyperpolymath estate — orient before acting

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.

Doctrine (the rules here)

  1. Holes before anything else — fix soundness holes before features/perf/docs.
  2. Fixes first, on firm foundations — ground-truth by running the tool, not trusting status docs.
  3. Fail loudly, seal soundly — no silent green; seams (ABI/FFI) sealed & proven.
  4. Distrust the neural for exactness — licences/invariants/equivalence belong to PLASMA (formal), not to an LLM. Your edits there are provisional + supervised.
  5. Squabble, don't bypass — reach green by satisfying the gate, never by admin-override.
  6. No automated licence edits — ever — manual, owner-only; third-party untouchable.
  7. No deletion by access-recency — cold ≠ disposable.
  8. Wire first — unwired is not done.
  9. Always sign commits (id_ed25519_signing; verify status:G).
  10. Report faithfully — no overclaim (the AFFIRMATION ethos).
  11. Stop-first when an action is costly to undo or outward-facing.
  12. Boundaries are real — respect IS / IS-NOT; never assimilate or rename across them.
  13. Equivalence as identity — the estate's intellectual through-line.
  14. Solutions at source — fix the canonical/upstream origin, never patch the downstream symptom; trace and respect every up- and down-stream before you act.
  15. 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.
  16. 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.

The machine-readable substrate (read in this order on arrival)

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).

Canon pointers

  • 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.

Estate language policy (overridable per-repo via AGENTIC)

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.


This repo: xmlpull-zig · clade UNASSIGNED-xmlpull-zig

  • Identity — uuid 12f79705-0c45-527e-b7d9-2369b7627921; clade UNASSIGNED (secondary ``); born 2026-11-12; forge hyperpolymath/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.

Estate-Wide Format Migration Directives

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 .kyaml extension.
  • .yml/.yaml only 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 scripts kyaml-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) and standards/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.