Skip to content

EXPLAINME.adoc

Latest commit

 

History

History
65 lines (48 loc) · 2.92 KB

EXPLAINME.adoc

File metadata and controls

65 lines (48 loc) · 2.92 KB
Raw

Hyperpolymath Standards — EXPLAINME

Note

This is a thin pointer, not an entry point. The canonical front doors are:

This file used to carry its own hand-maintained spec inventory, which drifted (it listed ReScript as a primary language — banned 2026-04-30 in favour of AffineScript — and referenced 2-protocols/groove/ and palimpsest-license/ as local directories that do not exist in this monorepo). That inventory now lives in the generated, CI-verified registry instead, so it can no longer go stale.

What this repo is

The organization-wide standards monorepo: the A2ML metadata family, K9 self-validating components, the protocols, the readiness-grading frameworks (ARG/FRG/CRG/TRG), RSR compliance, and the enforcement/CI that makes them stick. Former satellite repos were absorbed as subdirectories on 2026-02-08.

For the full, verifiable list of specs and where each one lives, read REGISTRY.a2ml (or the human prose in REGISTRY.adoc).

Architecture decisions (the durable ones)

Decision Rationale

AsciiDoc-first documentation

Semantic structure + cross-references; .md only for GitHub-required files.

Justfile over Makefiles

Cross-platform recipes without tab sensitivity; Makefiles are banned org-wide.

Language policy

AffineScript (primary), Rust/SPARK, Zig, Gleam, Elixir, Idris2/Agda. Banned: TypeScript, ReScript, Python, Go, Java/Kotlin/Swift, V-lang, Makefiles. Canonical statement + carve-outs: .claude/CLAUDE.md.

A2ML over YAML/JSON for metadata

Machine-readable, versionable, semantically typed. Each repo declares state in .machine_readable/.

SHA-pinned GitHub Actions

Prevents supply-chain attacks from mutable tags.

Guix-first package management

Reproducible builds via Guix.

Elegance is the default arm (proposed)

Provisional methodology pending the ratification record in 0-canon/RSR-PHILOSOPHY.adoc; it is not yet an effective architecture decision.

How to use this repo

  1. New project? See 1-formats/A2ML-REPO-TEMPLATE.adoc and the Usage section of README.adoc.

  2. Looking for a specific spec? REGISTRY.a2ml.

  3. Language question? .claude/CLAUDE.md.

  4. CI / enforcement? .github/workflows/ + hooks/.

  5. Build / test? just build, just test (see Justfile).