|
1 | | -= Standards — EXPLAINME |
2 | | -:toc: preamble |
| 1 | +// SPDX-License-Identifier: PMPL-1.0-or-later |
3 | 2 |
|
4 | | -This document backs up the claims made in README with evidence and rationale. |
| 3 | += Hyperpolymath Standards — EXPLAINME |
5 | 4 |
|
6 | | -== What Is This? |
| 5 | +== "Canonical source for policies, templates, and specifications" |
7 | 6 |
|
8 | | -Standards is a hyperpolymath project. See README.adoc for usage. |
| 7 | +[quote, README.adoc] |
| 8 | +____ |
| 9 | +Organization-wide standards, specifications, and governance templates for the Hyperpolymath ecosystem. |
| 10 | +____ |
9 | 11 |
|
10 | | -== Why These Choices? |
| 12 | +This monorepo consolidates the A2ML specification family, governance templates, protocol definitions, and enforcement tooling that all Hyperpolymath projects must follow. |
| 13 | +Former satellite repos (meta-a2ml, playbook-a2ml, agentic-a2ml, etc.) were absorbed into subdirectories as of 2026-02-08. |
| 14 | +See link:README.adoc[] for the full directory map and specification list. |
11 | 15 |
|
12 | | -=== Language |
| 16 | +**Caveat:** Standards are prescriptive -- not every downstream repo is fully compliant yet. Enforcement is via CI workflows and Hypatia scanning, not manual audit. |
13 | 17 |
|
14 | | -The language(s) used in this project were chosen per the hyperpolymath |
15 | | -language policy (see CLAUDE.md for the full list of allowed/banned languages). |
| 18 | +=== Evidence |
16 | 19 |
|
17 | | -=== Architecture |
| 20 | +[cols="2,3", options="header"] |
| 21 | +|=== |
| 22 | +| Path | Proves |
18 | 23 |
|
19 | | -Architecture decisions are documented in `.machine_readable/` checkpoint files. |
| 24 | +| `a2ml/` |
| 25 | +| A2ML format specification -- the machine-readable metadata format used across all repos |
20 | 26 |
|
21 | | -== Alternatives Considered |
| 27 | +| `meta-a2ml/` |
| 28 | +| META.a2ml, STATE.a2ml, ECOSYSTEM.a2ml specs and IANA registration drafts |
22 | 29 |
|
23 | | -(To be filled in as the project matures.) |
| 30 | +| `agentic-a2ml/` |
| 31 | +| AGENTIC.a2ml spec -- AI agent interaction patterns |
24 | 32 |
|
25 | | -== Proof of Claims |
| 33 | +| `contractiles/` |
| 34 | +| Contractile system (must/trust/dust/intend/k9) -- policy enforcement primitives |
26 | 35 |
|
27 | | -(Link formal verification results from the `proven` repo where applicable.) |
| 36 | +| `axel-protocol/` |
| 37 | +| Axel protocol specification -- cross-forge automation standard |
| 38 | + |
| 39 | +| `groove-protocol/` |
| 40 | +| Groove universal plug-and-play protocol -- inter-service communication |
| 41 | + |
| 42 | +| `hooks/` |
| 43 | +| Pre-commit and CI hooks -- the enforcement layer that makes standards stick |
| 44 | +|=== |
0 commit comments