Skip to content

Commit 69561fc

Browse files
hyperpolymathclaude
andcommitted
docs(explainme): improve completeness per README-EXPLAINME-STANDARD
Add :toc: preamble and :icons: font attributes. Add dogfooding table (7 rows) mapping estate-wide mandates to live code examples across gossamer, burble, hypatia, typed-wasm and 300+ downstream repos. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 4654541 commit 69561fc

File tree

1 file changed

+39
-0
lines changed

1 file changed

+39
-0
lines changed

EXPLAINME.adoc

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
// SPDX-License-Identifier: PMPL-1.0-or-later
22

33
= Hyperpolymath Standards — EXPLAINME
4+
:toc: preamble
5+
:icons: font
46

57
== Canonical source for policies, templates, and specifications
68

@@ -112,6 +114,43 @@ See link:README.adoc[] for the full directory map and specification list.
112114
| **Total** | | **160+**
113115
|===
114116

117+
=== Dogfooded Across The Account
118+
119+
The patterns mandated here are applied everywhere — not prescribed then ignored:
120+
121+
[cols="1,2,2", options="header"]
122+
|===
123+
| Standard | Where Mandated | Live Examples
124+
125+
| A2ML machine-readable metadata
126+
| link:a2ml/[a2ml/] spec (7 formats)
127+
| Every RSR repo's `.machine_readable/`; link:meta-a2ml/[meta-a2ml] spec + IANA draft
128+
129+
| SHA-pinned GitHub Actions
130+
| link:.github/workflows/workflow-linter.yml[workflow-linter.yml] CI gate
131+
| All 23 workflows in `.github/workflows/` pin by SHA; enforced in >300 downstream repos
132+
133+
| Contractile / K9 enforcement
134+
| link:contractiles/CANONICAL-TEMPLATES.adoc[contractiles/] + link:k9-svc/[k9-svc/]
135+
| hypatia, gossamer, burble, proven, proven-servers (105+ repos carry k9 guards)
136+
137+
| Groove inter-service protocol
138+
| link:groove-protocol/[groove-protocol/] spec
139+
| gossamer (src/core/Groove.eph), burble (bridges), hypatia (dispatch connectors)
140+
141+
| Idris2 ABI + Zig FFI standard
142+
| link:ABI-FFI-README.md[ABI-FFI-README.md] + rsr-template-repo reference
143+
| ephapax (idris2/), gossamer (src/interface/abi/), burble (src/Burble/ABI/), verisimdb, typed-wasm
144+
145+
| Guix-first package management
146+
| CCCP language policy (CLAUDE.md)
147+
| guix.scm at root; flake.nix as fallback — both present in this repo
148+
149+
| PMPL-1.0-or-later licence
150+
| link:palimpsest-license/[palimpsest-license/] + licence policy
151+
| SPDX header on every source file estate-wide; link:LICENSE[LICENSE] here
152+
|===
153+
115154
=== Roadmap Phases
116155

117156
* **Phase A (Innervation):** Wire k9 coordination across all repos, replace static 6a2 files with derived STATE.

0 commit comments

Comments
 (0)