Skip to content

Commit da5123d

Browse files
hyperpolymathclaude
andcommitted
fix: EXPLAINME.adoc — quote README claims, brief format, evidence table
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent da7810d commit da5123d

1 file changed

Lines changed: 32 additions & 15 deletions

File tree

EXPLAINME.adoc

Lines changed: 32 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,44 @@
1-
= Standards — EXPLAINME
2-
:toc: preamble
1+
// SPDX-License-Identifier: PMPL-1.0-or-later
32

4-
This document backs up the claims made in README with evidence and rationale.
3+
= Hyperpolymath Standards — EXPLAINME
54

6-
== What Is This?
5+
== "Canonical source for policies, templates, and specifications"
76

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+
____
911

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

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

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
1619

17-
=== Architecture
20+
[cols="2,3", options="header"]
21+
|===
22+
| Path | Proves
1823

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
2026

21-
== Alternatives Considered
27+
| `meta-a2ml/`
28+
| META.a2ml, STATE.a2ml, ECOSYSTEM.a2ml specs and IANA registration drafts
2229

23-
(To be filled in as the project matures.)
30+
| `agentic-a2ml/`
31+
| AGENTIC.a2ml spec -- AI agent interaction patterns
2432

25-
== Proof of Claims
33+
| `contractiles/`
34+
| Contractile system (must/trust/dust/intend/k9) -- policy enforcement primitives
2635

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

Comments
 (0)