Skip to content

CLAUDE.md

Latest commit

 

History

History
71 lines (58 loc) · 5.85 KB

CLAUDE.md

File metadata and controls

71 lines (58 loc) · 5.85 KB
Raw

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.

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

CHORA → ANCHOR → AGENTIC → ECOSYSTEM → STATE -> NEUROSYM -> PLAYBOOK

The descriptive family (working name descriptiles) describes what-is; the contractiles are the normative set-point.

File Answers
CLADE.a2ml Identity / lineage — what this repo IS (registers into gv-clade-index).
ANCHOR.a2ml 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.
META.a2ml Concept / constitutional authority — ADRs, what's permitted.
AGENTIC.a2ml May I act now? — permissions, risk gating, fail-safe-deny.
ECOSYSTEM.a2ml Where it sits — estate + external relations, and what-this-is-not.
NEUROSYM.a2ml Meaning of operations — proof obligations.
PLAYBOOK.a2ml How permitted actions run.
STATE.a2ml Where things are now — progress, 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, AGPL. (Guix, not Nix.) JavaScript tooling order: Bun (default) > Deno (being removed — owner ruling 2026-08-26, standards#655) > pnpm > npm (last resort, permitted). Use plain JavaScript when this tooling is needed. The "use ReScript" rule is retired — ReScript is no longer used in this estate. Do not migrate Bun to Deno.

This repo: dicta-task · clade ap-dicta-task

  • Identity — uuid 7aff6bbd-b776-503f-ba55-3f67c7106886; clade ap (secondary ``); born 2026-03-14; forge hyperpolymath/dicta-task.
  • IS — Speech-to-do pipeline: portable recorder → transcription → NLP parsing → prioritised task list
  • IS-NOT — a cloud dictation service (ASR runs offline; cloud is encrypted backup only) · a general note-taking app · a template (it is minted from rsr-template-repo)
  • Where it sits — pipeline position leaf; chain standards → rsr-template-repo → dicta-task; 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: .machine_readable/bot_directives/{methodology,coverage,debt}.a2ml.
  • Golden path (ANCHOR) — just test && just quality → Core tests pass; Quality gates pass; No unresolved critical security findings.
  • State — phase implementation; maturity experimental; 15% complete; status active.