From 11d458334a0ae9c0954dc7f4a712cd9862376543 Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Fri, 9 Oct 2026 09:44:49 +0100 Subject: [PATCH] docs: point the front doors at deed, k9 and coordination, not A2ML A2ML is retired (D99, D269c, D312, D313), but the files agents read first still told them to create the seven A2ML files. Agents kept producing new A2ML, or "new" A2ML in a different shape, instead of the forms that replace it. Each front door now names the three live forms, each with its normative grammar and its checker: - _chora.deed: 1-formats/deed/spec/abnf/deed.abnf, deed_lint.js - *.k9.ncl: K9-CONTRACT-SPEC, k9-validate.sh --strict - coordination.k9: coordination-k9-grammar_v1.1.abnf, COORDINATION-K9-SPEC They also point at the deed mapping specs for former content and forbid bulk hand-conversion (D313). - .claude/CLAUDE.md: Machine-Readable Artefacts rewritten; the ALLOWED table's A2ML row replaced by deed and k9 rows. - .meta/REQUIRED-FILES.adoc: "Mandatory A2ML Files" replaced by "Machine-Readable Metadata". - AGENTS.adoc: A2ML-retired paragraph; validation line names both checkers. - README.adoc: new "Machine-Readable Metadata" section; the A2ML family table, templates and execution pipeline marked retired history; tree listing, Usage step 2, Document Formats and Related Projects updated. - 0-AI-MANIFEST.a2ml: deletion only. The "7 A2ML files MUST exist" section, the dead a2ml/ routing and the A2ML clause of the attestation are removed. No line is added. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015bTuGfwCcvjrmNFejydTML --- .claude/CLAUDE.md | 41 ++++++++--- .meta/REQUIRED-FILES.adoc | 49 ++++++++----- 0-AI-MANIFEST.a2ml | 23 +----- AGENTS.adoc | 13 +++- README.adoc | 144 +++++++++++++++++--------------------- 5 files changed, 142 insertions(+), 128 deletions(-) diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index 06e7f3e02..e45a37d78 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -54,16 +54,36 @@ ## Machine-Readable Artefacts -Every Hyperpolymath repo must have `.machine_readable/` with these 6 A2ML files: +**A2ML is retired** (owner rulings D99, D269c, D312, D313). Never create, +restore, regenerate or extend a `.a2ml` file, and never write a "new" A2ML +file in a different shape. Machine-readable repo metadata has three forms. +Each has a normative grammar in this repository: -- `STATE.a2ml` - Current project state and progress -- `META.a2ml` - Architecture decisions and development practices -- `ECOSYSTEM.a2ml` - Position in the ecosystem and related projects -- `AGENTIC.a2ml` - AI agent interaction patterns -- `NEUROSYM.a2ml` - Neurosymbolic integration config -- `PLAYBOOK.a2ml` - Operational runbook - -See: https://github.com/hyperpolymath/standards +| What | File | Grammar (normative) | Check | +|---|---|---|---| +| Repo facts: identity, state, meta, ecosystem, agentic, neurosym, playbook, and the `(bot-directives …)` and `(contractiles …)` clauses | `_chora.deed` at the repo root, one per repo (D312) | `1-formats/deed/spec/abnf/deed.abnf` (D308; prose: `1-formats/deed/spec/DEED-GRAMMAR-SPEC.adoc`) | `bun 1-formats/deed/tools/deed_lint.js FILE.deed` | +| Contracts | `*.k9.ncl` | `1-formats/k9/spec/K9-CONTRACT-SPEC.adoc` | `1-formats/k9/tools/k9-validate.sh --strict FILE` | +| Agent coordination | `coordination.k9` at the repo root: first line `K9!`, `schema_version: 1.1.1` | `2-protocols/k9-coordination/spec/abnf/coordination-k9-grammar_v1.1.abnf` (prose: `2-protocols/k9-coordination/spec/COORDINATION-K9-SPEC.adoc`) | No validator script exists yet, and a generic YAML parser does not conform. The generator is `2-protocols/k9-coordination/tools/k9-init/`. | + +- **Translating old content.** The mapping specs in `1-formats/deed/mappings/`, + one per former A2ML family, decide where its content goes. Anything a + mapping spec does not list does not translate. +- **The worked model** is `rsr-template-repo_chora.deed` in + `hyperpolymath/rsr-template-repo`. +- **No bulk conversion.** Do not hand-convert A2ML in bulk, and do not use the + Python converters in `1-formats/deed/tools/`. Conversion becomes kcX's first + front end (D313), and Python is banned. +- **A deed is not TOML.** A file containing `key = value` or `[section]` is not + a deed. `(` is the only bracket. Booleans are `#t`/`#f`. Enums are symbols + (`:primary fv`, not `:primary "fv"`). UUIDs are `#u5"…"` literals. + `:schema-version` appears exactly once at the top level. +- **Existing `.a2ml` files**, here and in other repos, are legacy awaiting + migration. You may delete content from one; never add a fact to one. + +`.machine_readable/descriptiles/` stays the directory for descriptive anchors +that are not yet folded into the chora deed. The `.a2ml` files still in it are +legacy. Anything new written there is a `.deed`, such as +`provisioning_praxis.deed`, never a `.a2ml`. --- @@ -99,7 +119,8 @@ for the canonical statement. | **Bash/POSIX Shell** | Scripts, automation | Keep minimal | | **JavaScript** | Only where AffineScript cannot | MCP protocol glue, runtime APIs (transitional; prefer .affine where possible) | | **Nickel** | Configuration language | For complex configs | -| **A2ML** | State/meta files | STATE.a2ml, META.a2ml, etc. (TOML-like format) | +| **deed** | Repo metadata (`_chora.deed`) | S-expression format; grammar `1-formats/deed/spec/abnf/deed.abnf`. Replaces A2ML, which is retired. See Machine-Readable Artefacts above. | +| **k9** | Contracts (`*.k9.ncl`) and agent coordination (`coordination.k9`) | Grammars and validators in `1-formats/k9/` and `2-protocols/k9-coordination/`. | | **Julia** | Batch scripts, data processing | Per RSR | | **OCaml** | AffineScript compiler | Language-specific | | **Ada** (legacy) | Safety-critical systems where Rust/SPARK is not yet reachable | Rust/SPARK is absorbing most Ada work over time. Do not start new pure-Ada projects unless Rust/SPARK cannot reach. | diff --git a/.meta/REQUIRED-FILES.adoc b/.meta/REQUIRED-FILES.adoc index 345225e4e..81f931d65 100644 --- a/.meta/REQUIRED-FILES.adoc +++ b/.meta/REQUIRED-FILES.adoc @@ -15,28 +15,44 @@ The following files *MUST* be present and kept up-to-date in every repository: | `.tool-versions` | asdf version pinning for reproducible builds |=== -== Mandatory A2ML Files +== Machine-Readable Metadata -[NOTE] +[IMPORTANT] ==== -These files use the `.a2ml` extension. Earlier versions of this doc -listed them as `.scm`; that was stale drift. `.scm` is reserved exclusively -for Guix-related files (`guix.scm`, `.guix-channel`). All descriptiles metadata -files use `.a2ml`. +*A2ML is retired* (owner rulings D99, D269c, D312, D313). This section used to +require six `.a2ml` files (META, STATE, ECOSYSTEM, PLAYBOOK, AGENTIC, +NEUROSYM). Do not create them, restore them, or write a "new" A2ML file in +their place. Their content now lives in deed clauses, as below. `.scm` stays +reserved for Guix files (`guix.scm`, `.guix-channel`). ==== -[cols="2,3"] +[cols="2,3,3"] |=== -| File | Purpose - -| `META.a2ml` | Architecture decisions, development practices -| `STATE.a2ml` | Project state, phase, milestones -| `ECOSYSTEM.a2ml` | Ecosystem positioning, related projects -| `PLAYBOOK.a2ml` | Executable plans, procedures -| `AGENTIC.a2ml` | AI agent operational gating -| `NEUROSYM.a2ml` | Symbolic semantics, proof obligations +| File | Purpose | Grammar and check + +| `_chora.deed` (repo root, one per repo) +| The repo's facts: identity, state, meta, ecosystem, agentic, neurosym, + playbook, and the `(bot-directives …)` and `(contractiles …)` clauses (D312). +| link:../1-formats/deed/spec/abnf/deed.abnf[`deed.abnf`] (normative, D308). + Check with `bun 1-formats/deed/tools/deed_lint.js FILE.deed`. Model: + `rsr-template-repo_chora.deed` in `hyperpolymath/rsr-template-repo`. + +| `*.k9.ncl` +| Contracts. The chora deed attests to them through its `(contractiles …)` clause. +| link:../1-formats/k9/spec/K9-CONTRACT-SPEC.adoc[K9 contract spec]. Check with + `1-formats/k9/tools/k9-validate.sh --strict FILE`. + +| `coordination.k9` (repo root) +| Agent coordination rules. First line `K9!`, `schema_version: 1.1.1`. +| link:../2-protocols/k9-coordination/spec/abnf/coordination-k9-grammar_v1.1.abnf[`coordination-k9-grammar_v1.1.abnf`] + (prose: link:../2-protocols/k9-coordination/spec/COORDINATION-K9-SPEC.adoc[COORDINATION-K9-SPEC]). + No validator script exists yet, and a generic YAML parser does not conform. |=== +Where a former A2ML record's content goes is decided by the mapping specs in +link:../1-formats/deed/mappings/[`1-formats/deed/mappings/`]. Anything a +mapping spec does not list does not translate. + == Build System [cols="2,3"] @@ -70,4 +86,5 @@ When updating these files: * link:https://github.com/hyperpolymath/rhodium-standard-repositories[RSR (Rhodium Standard Repositories)] * link:https://github.com/hyperpolymath/mustfile[Mustfile Specification] -* link:https://github.com/hyperpolymath/standards/tree/main/meta-a2ml[A2ML Format Family] +* link:../1-formats/deed/README.adoc[deed format] +* link:../2-protocols/k9-coordination/spec/COORDINATION-K9-SPEC.adoc[K9 coordination protocol] diff --git a/0-AI-MANIFEST.a2ml b/0-AI-MANIFEST.a2ml index db71a6bbd..26654a3ca 100644 --- a/0-AI-MANIFEST.a2ml +++ b/0-AI-MANIFEST.a2ml @@ -8,7 +8,7 @@ thin pointer back to one of these two. ## WHAT IS THIS REPO? The organization-wide standards monorepo: ~30 specs that govern every -Hyperpolymath project — the A2ML metadata family, K9 self-validating +Hyperpolymath project — K9 self-validating components, the protocols, the readiness-grading frameworks (ARG/FRG/CRG/TRG), RSR compliance, and the enforcement/CI that makes them stick. @@ -16,7 +16,7 @@ RSR compliance, and the enforcement/CI that makes them stick. | If you want… | Go to | |---|---| -| A2ML / K9 foundation (Stream 1) | `a2ml/`, `1-formats/k9/`, `1-formats/contractiles/`, `*-a2ml/` | +| K9 foundation (Stream 1) | `1-formats/k9/`, `1-formats/contractiles/` | | Language policy (Stream 2) | `.claude/CLAUDE.md` | | Protocols | `*-protocol/` | | Readiness grades | `adoption-readiness-grades/`, `foundations-readiness-grades/`, `component-readiness-grades/`, `toolchain-readiness-grades/` | @@ -27,23 +27,6 @@ RSR compliance, and the enforcement/CI that makes them stick. | Current project state | `.machine_readable/descriptiles/STATE.a2ml` | | Education layer (deep docs, by audience) | `docs/wikis/` (Users / Developers / Maintainers); machine mirror `docs/wikis/0.2-AI-MANIFEST.a2ml` | -## CANONICAL LOCATIONS (UNIVERSAL RULE) - -### Machine-readable metadata lives in `.machine_readable/descriptiles/` ONLY - -The 7 A2ML files MUST exist under `.machine_readable/descriptiles/` (this repo's -absorbed-satellite layout), never in the repo root: - -1. **STATE.a2ml** — project state, progress, blockers -2. **META.a2ml** — architecture decisions, governance -3. **ECOSYSTEM.a2ml** — position in ecosystem, relationships -4. **AGENTIC.a2ml** — AI-agent interaction patterns -5. **NEUROSYM.a2ml** — neurosymbolic integration config -6. **PLAYBOOK.a2ml** — operational runbook -7. **ANCHOR.a2ml** — intervention/recalibration (under `.machine_readable/anchors/`) - -**CRITICAL:** if any of these appear in the repo root, that is an ERROR. - ## CORE INVARIANTS 1. **No A2ML duplication** — root must NOT contain STATE.a2ml, META.a2ml, etc. @@ -64,7 +47,7 @@ absorbed-satellite layout), never in the repo root: ## ATTESTATION After reading, state: **"I have read the standards manifest. The human front -door is README.adoc. A2ML state lives in .machine_readable/descriptiles/ only. +door is README.adoc. Licence/SPDX is Manual-Only — I will flag, never edit."** ## META diff --git a/AGENTS.adoc b/AGENTS.adoc index 6b5ba6115..d3a4a032a 100644 --- a/AGENTS.adoc +++ b/AGENTS.adoc @@ -18,6 +18,15 @@ directly. Preserve licences, coined names, MAA’s independent authority, and current language/build conventions. Do not add TypeScript or Deno, weaken validation, or describe draft/tested work as proven. -Run the relevant `+just+`/`+must+` targets, A2ML/Nickel/K9 validation -where applicable, link/canonical-name checks, and `+git diff --check+`. +A2ML is retired (D99, D269c, D312, D313). Never create, restore or extend a +`+.a2ml+` file. Repo metadata goes in `+_chora.deed+` clauses (grammar +`+1-formats/deed/spec/abnf/deed.abnf+`), contracts in `+*.k9.ncl+`, and agent +coordination in `+coordination.k9+` (grammar +`+2-protocols/k9-coordination/spec/abnf/coordination-k9-grammar_v1.1.abnf+`). +`+1-formats/deed/mappings/+` says where former A2ML content goes. + +Run the relevant `+just+`/`+must+` targets, deed validation +(`+bun 1-formats/deed/tools/deed_lint.js+`), Nickel/K9 validation +(`+1-formats/k9/tools/k9-validate.sh --strict+`) where applicable, +link/canonical-name checks, and `+git diff --check+`. Regenerate twice and require a clean second pass for generated outputs. diff --git a/README.adoc b/README.adoc index 902d65c91..4288e09f1 100644 --- a/README.adoc +++ b/README.adoc @@ -39,8 +39,8 @@ Every other "what is this repo" doc is now a thin pointer back to these two | The estate's highest rules, authority precedence, assurance constitution, and tension register | link:0-canon/constitution/[Constitutional district] -| The **A2ML / K9 foundation** (Stream 1) — the 7-format family, K9, contractiles -| link:a2ml/[a2ml/], link:1-formats/k9/[1-formats/k9/], link:1-formats/contractiles/[1-formats/contractiles/] and the `*-a2ml/` spec dirs +| The **deed / K9 foundation** (Stream 1) — repo metadata (deed), K9 contracts, the K9 coordination protocol, contractiles +| link:1-formats/deed/[1-formats/deed/], link:1-formats/k9/[1-formats/k9/], link:2-protocols/k9-coordination/[2-protocols/k9-coordination/], link:1-formats/contractiles/[1-formats/contractiles/] (see <>) | The **language policy** (Stream 2) — allowed/banned languages, AffineScript stance | link:.claude/CLAUDE.md[.claude/CLAUDE.md] (canonical) + the <> table below @@ -65,7 +65,7 @@ Every other "what is this repo" doc is now a thin pointer back to these two | link:TOPOLOGY.adoc[TOPOLOGY.adoc] (frozen 2026-10-09; no longer regenerated) | To **stand up a new repo** to these standards -| link:1-formats/A2ML-REPO-TEMPLATE.adoc[1-formats/A2ML-REPO-TEMPLATE.adoc] + <> +| https://github.com/hyperpolymath/rsr-template-repo[rsr-template-repo] + link:.meta/REQUIRED-FILES.adoc[.meta/REQUIRED-FILES.adoc] + <> | The **education layer** — audience-split deep docs (beyond quickstart) | link:docs/wikis/[docs/wikis/] — link:docs/wikis/users/index.adoc[Users] · link:docs/wikis/developers/index.adoc[Developers] · link:docs/wikis/maintainers/index.adoc[Maintainers] @@ -82,7 +82,7 @@ This repository serves as the canonical source for policies, templates, and spec * **Language Policy** -- Which languages and tools are permitted across the ecosystem * **Language-Maturation Grades** -- link:adoption-readiness-grades/[ARG (Adoption Readiness)] + link:foundations-readiness-grades/[FRG (Foundations Readiness)] per-language profile templates; aggregated into the link:https://github.com/hyperpolymath/nextgen-languages[nextgen-languages] dashboard. TRG (Trust) + CRG (Compliance) profile templates live under each framework's `templates/` directory. -* **Decriptiles Family** -- 7 machine-readable project metadata formats in A2ML (see link:1-formats/SATELLITES.a2ml[1-formats/SATELLITES.a2ml]) +* **Machine-readable metadata** -- repo facts as clauses of `_chora.deed` (grammar link:1-formats/deed/spec/abnf/deed.abnf[`deed.abnf`]), contracts as `*.k9.ncl`, agent coordination as `coordination.k9` (see <>) * **Build System** -- Mustfile/justfile (no Makefiles) * **Stable Release Gate** -- link:3-practice/release-pre-flight/V1-GATE.adoc[hard `v1.0.0` audit requirements] for all repos and multi-repo systems * **Publication Pre-Flight** -- link:3-practice/publication-pre-flight/PREFLIGHT.adoc[submission gate] plus link:3-practice/publication-pre-flight/HOL-SUITABILITY-CHECKLIST.adoc[HOL] and link:3-practice/publication-pre-flight/ZENODO-DEPOSIT-CHECKLIST.adoc[Zenodo] checklists @@ -95,8 +95,46 @@ This repository serves as the canonical source for policies, templates, and spec == Standards Ecosystem +=== Machine-Readable Metadata + +[IMPORTANT] +==== +A2ML is retired (owner rulings D99, D269c, D312, D313). Do not create, +restore or extend a `.a2ml` file, and do not write a "new" A2ML file in a +different shape. Machine-readable repo metadata has three forms, each with a +normative grammar in this repository. +==== + +[cols="2,3,3", options="header"] +|=== +|File |Purpose |Grammar and check + +|`_chora.deed`, at the repo root (one per repo, D312) +|Repo facts: identity, state, meta, ecosystem, agentic, neurosym and playbook, plus the `(bot-directives …)` and `(contractiles …)` clauses +|link:1-formats/deed/spec/abnf/deed.abnf[`deed.abnf`] (normative, D308). Check with `bun 1-formats/deed/tools/deed_lint.js FILE.deed`. + +|`*.k9.ncl` +|Contracts, attested by the deed's `(contractiles …)` clause +|link:1-formats/k9/spec/K9-CONTRACT-SPEC.adoc[K9 contract spec]. Check with `1-formats/k9/tools/k9-validate.sh --strict FILE`. + +|`coordination.k9`, at the repo root +|Agent coordination: first line `K9!`, `schema_version: 1.1.1` +|link:2-protocols/k9-coordination/spec/abnf/coordination-k9-grammar_v1.1.abnf[`coordination-k9-grammar_v1.1.abnf`] and link:2-protocols/k9-coordination/spec/COORDINATION-K9-SPEC.adoc[COORDINATION-K9-SPEC]. No validator script exists yet. +|=== + +The worked model is `rsr-template-repo_chora.deed` in +https://github.com/hyperpolymath/rsr-template-repo[rsr-template-repo]. The +mapping specs in link:1-formats/deed/mappings/[`1-formats/deed/mappings/`] +decide where former A2ML content goes; anything a mapping spec does not list +does not translate. Do not hand-convert A2ML in bulk: conversion becomes +kcX's first front end (D313). + === Monorepo Architecture +NOTE: This section is history. The A2ML formats specified under +`1-formats/a2ml/` are retired. Their specs stay in the tree for reference; do +not write new files against them. + As of 2026-02-08, all A2ML specification satellites have been absorbed into this monorepo as subdirectories. The previous hub-satellite architecture (with separate GitHub repos) has been consolidated here for easier maintenance and atomic cross-spec changes. @@ -140,70 +178,16 @@ RSR boilerplate (LICENSE, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, MAINTAINERS) |Standards update tooling and documentation |=== -For detailed repository structure requirements, see link:1-formats/A2ML-REPO-TEMPLATE.adoc[1-formats/A2ML-REPO-TEMPLATE.adoc]. +=== Retired: the A2ML family, its templates and its execution pipeline -=== A2ML Format Family (7 Formats) - -Every Hyperpolymath repository must include these machine-readable A2ML files in `.machine_readable/`: - -[cols="1,1,2,1", options="header"] -|=== -|File |Tier |Purpose |Specification - -|`META.a2ml` -|Primary -|Architecture decisions (ADRs), development practices -|link:1-formats/a2ml/meta/[meta-a2ml] - -|`STATE.a2ml` -|Primary -|Project state, phase, milestones, session history -|link:1-formats/a2ml/state/[state-a2ml] - -|`ECOSYSTEM.a2ml` -|Primary -|Ecosystem positioning, related projects -|link:1-formats/a2ml/ecosystem/[ecosystem-a2ml] - -|`PLAYBOOK.a2ml` -|Execution -|Executable plans, procedures, alerts -|link:1-formats/a2ml/playbook/[playbook-a2ml] - -|`AGENTIC.a2ml` -|Execution -|AI agent operational gating, entropy budgets -|link:1-formats/a2ml/agentic/[agentic-a2ml] - -|`NEUROSYM.a2ml` -|Execution -|Symbolic semantics, proof obligations -|link:1-formats/a2ml/neurosym/[neurosym-a2ml] - -|`ANCHOR.a2ml` -|Intervention -|Project recalibration/realignment -|link:1-formats/a2ml/anchor/[anchor-a2ml] -|=== - -Templates available in `1-formats/templates/` directory. - -=== Execution Pipeline - -All implementations MUST respect this ordering (defined in link:1-formats/SATELLITES.a2ml[1-formats/SATELLITES.a2ml]): - -[source] ----- -1. META validation <- Constitutional authority check -2. AGENTIC gating <- Operational safety -3. NEUROSYM semantics <- Proof obligations -4. PLAYBOOK derivation <- Build executable plan -5. Execution -6. ECOSYSTEM check <- Integrity verification -7. STATE update <- Record outcome - -INTERVENTION: ANCHOR.a2ml can override any level ----- +The seven A2ML files (`META`, `STATE`, `ECOSYSTEM`, `PLAYBOOK`, `AGENTIC`, +`NEUROSYM`, `ANCHOR`), the `*.a2ml.template` files in `1-formats/templates/`, +link:1-formats/A2ML-REPO-TEMPLATE.adoc[`1-formats/A2ML-REPO-TEMPLATE.adoc`] +and the execution pipeline that `1-formats/SATELLITES.a2ml` once ordered are +retired with A2ML. They stay in the tree as history only. No repository is +required to carry them, and no new file is written from them. Their content +goes into the forms in <>, as the mapping specs +decide. No execution ordering has been ruled for the deed era. === RSR (Rhodium Standard Repository) @@ -228,7 +212,7 @@ The Rhodium Standard Repository specification defines compliance requirements: === Document Formats -* https://github.com/hyperpolymath/standards/tree/main/a2ml[a2ml] -- Attested Markup Language (typed, verified documents) (`application/vnd.a2ml`, v0.6.0 draft) +* link:1-formats/deed/[deed] -- Repo metadata as s-expression deeds (grammar link:1-formats/deed/spec/abnf/deed.abnf[`deed.abnf`]); replaces A2ML, which is retired * https://github.com/hyperpolymath/standards/tree/main/k9-svc[k9-svc] -- Self-validating components (embedded contracts + deployment logic) * https://github.com/hyperpolymath/stateful-artefacts-for-gitforges[stateful-artefacts-for-gitforges] -- Metadata-driven documentation pipeline @@ -376,50 +360,50 @@ standards/ +-- hooks/ # Git hooks | +-- pre-commit # Language policy enforcement | +-- validate-*.sh # Validation scripts -+-- 1-formats/templates/ # A2ML file templates ++-- 1-formats/templates/ # Retired A2ML file templates (history only) | +-- STATE.a2ml.template | +-- META.a2ml.template | +-- ECOSYSTEM.a2ml.template | +-- AGENTIC.a2ml.template | +-- NEUROSYM.a2ml.template | +-- PLAYBOOK.a2ml.template -+-- 1-formats/a2ml/meta/ # META.a2ml specification (absorbed satellite) ++-- 1-formats/a2ml/meta/ # Retired META.a2ml specification (history only) | +-- README.adoc | +-- spec/ | +-- examples/ -+-- 1-formats/a2ml/playbook/ # PLAYBOOK.a2ml specification ++-- 1-formats/a2ml/playbook/ # Retired PLAYBOOK.a2ml specification (history only) | +-- README.adoc | +-- spec/ | +-- examples/ -+-- 1-formats/a2ml/agentic/ # AGENTIC.a2ml specification ++-- 1-formats/a2ml/agentic/ # Retired AGENTIC.a2ml specification (history only) | +-- README.adoc | +-- spec/ | +-- examples/ | +-- 1-formats/contractiles/ | +-- ncl/ -+-- 1-formats/a2ml/neurosym/ # NEUROSYM.a2ml specification ++-- 1-formats/a2ml/neurosym/ # Retired NEUROSYM.a2ml specification (history only) | +-- README.adoc | +-- spec/ | +-- examples/ | +-- ncl/ -+-- 1-formats/a2ml/anchor/ # ANCHOR.a2ml specification ++-- 1-formats/a2ml/anchor/ # Retired ANCHOR.a2ml specification (history only) | +-- README.adoc | +-- spec/ | +-- examples/ | +-- 1-formats/contractiles/ -+-- 1-formats/a2ml/state/ # STATE.a2ml specification ++-- 1-formats/a2ml/state/ # Retired STATE.a2ml specification (history only) | +-- README.adoc | +-- spec/ | +-- examples/ | +-- lib/ -+-- 1-formats/a2ml/ecosystem/ # ECOSYSTEM.a2ml specification ++-- 1-formats/a2ml/ecosystem/ # Retired ECOSYSTEM.a2ml specification (history only) | +-- README.adoc | +-- spec/ | +-- docs/ +-- standards-update/ # Standards update tooling | +-- README.adoc +-- 1-formats/SATELLITES.a2ml # Retired satellite registry (history only) -+-- 1-formats/A2ML-REPO-TEMPLATE.adoc # Canonical structure for -a2ml repos ++-- 1-formats/A2ML-REPO-TEMPLATE.adoc # Retired structure for -a2ml repos (history only) +-- CODE_OF_CONDUCT.md # Template +-- CONTRIBUTING.md # Template +-- 3-practice/SECURITY.md # Template @@ -433,7 +417,7 @@ standards/ === For New Hyperpolymath Projects 1. Copy governance templates to your repository -2. Create `.machine_readable/` with 7 A2ML files from templates +2. Create `_chora.deed` at the repo root, modelled on `rsr-template-repo_chora.deed` and checked with `deed_lint.js`; add `coordination.k9` and `*.k9.ncl` contracts where they apply (see <>). Do not create `.a2ml` files 3. Add `Mustfile` and `justfile` (from hyperpolymath/mustfile) 4. Add enforcement workflows to `.github/workflows/` 5. Install pre-commit hook @@ -452,8 +436,9 @@ standards/ * link:1-formats/SATELLITES.a2ml[1-formats/SATELLITES.a2ml] -- Retired satellite registry (history only) * link:docs/UX-standards/[docs/UX-standards] -- UX standards and E-Grade launcher specification +* link:standards-update/[standards-update] -- Standards update tooling -**A2ML Format Family (local subdirectories):** +**Retired A2ML specifications (history only; see <> for the live forms):** * link:1-formats/a2ml/meta/[meta-a2ml] -- META.a2ml, STATE.a2ml, ECOSYSTEM.a2ml (primary tier) * link:1-formats/a2ml/playbook/[playbook-a2ml] -- PLAYBOOK.a2ml (execution tier) @@ -462,7 +447,6 @@ standards/ * link:1-formats/a2ml/anchor/[anchor-a2ml] -- ANCHOR.a2ml (intervention tier) * link:1-formats/a2ml/state/[state-a2ml] -- STATE.a2ml (primary tier) * link:1-formats/a2ml/ecosystem/[ecosystem-a2ml] -- ECOSYSTEM.a2ml (primary tier) -* link:standards-update/[standards-update] -- Standards update tooling **RSR/Rhodium:**