Skip to content

Commit 2b933ae

Browse files
hyperpolymathclaude
andcommitted
feat: add Hyperpolymath Immaculate Guide + CRG-D gate
Add IMMACULATE-GUIDE.adoc — a bespoke adaptation of the Immaculate Guide to Forging & Distribution for the hyperpolymath ecosystem. Replaces generic examples (Docker, ad-hoc asdf) with the actual stack: Podman/Chainguard/ Stapeln containers, asdf .tool-versions chain, Idris2 ABI + Zig FFI discovery, panic-attack pre-commit gate, Groove-first comms, VeriSimDB persistence, BoJ cartridge distribution, and A2ML manifests. Update COMPONENT-READINESS-GRADES.md (v2.0 → v2.1): Immaculate Guide compliance is now a hard requirement for CRG Grade D on all hyperpolymath projects. Evidence must be recorded in STATE.a2ml under (immaculate-guide-compliance ...). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 728a37b commit 2b933ae

2 files changed

Lines changed: 556 additions & 1 deletion

File tree

component-readiness-grades/COMPONENT-READINESS-GRADES.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,13 @@ but it is not yet safe enough to be called stable even in the home context.
193193
expected at grade D).
194194
- RSR compliance, or a documented equivalent repository discipline, so that
195195
the component is at least inspectable and auditable while still unstable.
196+
- **Immaculate Guide compliance** (hyperpolymath projects): The repository MUST
197+
satisfy the nine principles of the Hyperpolymath Immaculate Guide
198+
(`immaculate-guide/IMMACULATE-GUIDE.adoc`). Evidence recorded in
199+
`.machine_readable/STATE.a2ml` under `(immaculate-guide-compliance ...)`.
200+
Specifically at minimum: `0-AI-MANIFEST.a2ml` present, `.tool-versions`
201+
pins all tools, `just build` works from a clean `asdf install`, and
202+
`panic-attack assail` passes (no Critical/High findings).
196203

197204
### 4.5. Grade C — Self-Validated
198205

@@ -389,7 +396,7 @@ When grading a component, answer these questions in order:
389396
2. **Does it cause harm, waste resources, or duplicate something better?** (Yes → F)
390397
3. **Does it do something, however slight?** (Barely → E)
391398
4. **Does it work on some things but not others?** (Partial → D)
392-
5. **Is the repository auditable enough to deserve D at all?** (RSR-compliant or equivalent)
399+
5. **Is the repository auditable enough to deserve D at all?** (RSR-compliant or equivalent; Immaculate Guide compliant for hyperpolymath projects)
393400
6. **Does it work reliably on our own project, and is it deeply annotated?** (Dogfooded → C)
394401
7. **Has it been tested on 6+ diverse external targets?** (Broad → B)
395402
8. **Do external users confirm it works and is useful?** (Field-proven → A)
@@ -586,6 +593,9 @@ A project conforms to CRG if:
586593
5. Release stages respect the minimum grade thresholds in section 5.
587594
6. Components graded D or above satisfy RSR compliance or a documented
588595
equivalent repository discipline.
596+
6a. Components graded D or above in hyperpolymath projects satisfy the
597+
Immaculate Guide (`immaculate-guide/IMMACULATE-GUIDE.adoc`) with
598+
compliance evidence in `.machine_readable/STATE.a2ml`.
589599
7. Components graded C or above have deep code and folder annotation.
590600
8. Non-abstract publication claims about implementation-facing work are not
591601
made below grade B.
@@ -636,5 +646,6 @@ requirement is missing.
636646

637647
| Version | Date | Author | Changes |
638648
|---------|------------|-------------------------|------------------|
649+
| 2.1 | 2026-04-03 | Jonathan D.A. Jewell | Added Immaculate Guide compliance as Grade D gate requirement for hyperpolymath projects |
639650
| 2.0 | 2026-03-30 | Jonathan D.A. Jewell | Raised bar for alpha/beta/publication, added RSR and deep-annotation requirements, added v2 sign-off and challenge posture |
640651
| 1.0 | 2026-02-28 | Jonathan D.A. Jewell | Initial release |

0 commit comments

Comments
 (0)