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:**