wikis

Standards Wiki — the education layer

This directory is the long-form, audience-segmented education layer for hyperpolymath/standards. It is deliberately deeper than the QUICKSTART-.adoc files: those get you set up and running; these explain the *why, the model, and how to engage with the materials fully.

Important

Status: scaffold. This is a starting skeleton (standards#docs-wiki-audit). Each track below has a structured learning path and links to the canonical sources, with TODO markers where prose still needs writing. It is honest about being incomplete — contributions fill the gaps, they do not start from zero.

Table of Contents

• The two front doors (unchanged)
• Tracks by audience
• Format & sync rules
• TODO (scaffold → complete)

The two front doors (unchanged)

The wiki does not replace the canonical front doors — it teaches them:

• Human front door: README.adoc

• Machine front door: 0-AI-MANIFEST.a2ml

• Verifiable index of every spec: .machine_readable/REGISTRY.a2ml

Tracks by audience

Track	For whom	Start
Users	People consuming / adopting the standards in their own repos — reusable workflows, A2ML artefacts, the policies, the readiness grades.	QUICKSTART-USER
Developers	People building to the standards, or extending the tooling — language policy, A2ML/K9 authoring, Hypatia rules, the CI gates.	QUICKSTART-DEV
Maintainers	People evolving this repo — the registry generator, the guardrails, the licence policy, the drift/staleness automation, the innervation stack.	QUICKSTART-MAINTAINER

Format & sync rules

• Primary format is AsciiDoc (.adoc) (estate doc policy; no .md duplicates).

• The machine mirror of this track is 0.2-AI-MANIFEST.a2ml in this directory — keep it in step when tracks are added.

• If/when a forge-hosted wiki (GitHub/GitLab) is adopted, this directory is the source of truth and is synced out to the forge, never hand-edited there. (Mirrors the estate pattern in k9-svc/*/docs/wikis/.)

TODO (scaffold → complete)

• ❏ Flesh out each track’s "core concepts" prose beyond the link lists.

• ❏ Decide forge-wiki vs in-repo-only hosting.

• ❏ Add a "glossary" page (A2ML, K9, RSR, CRG, contractile, innervation, 6a2).

• ❏ Add worked examples per track (adopt a repo / write a rule / cut a change).