QUICKSTART-USER.adoc

standards — Quick Start for Consumers

Table of Contents

• What is standards?
• Apply the standards to your repo
• Find a specific spec
• Get help

Note	This is a specs monorepo, not an application to install and run. "Using" it means applying the standards to your own repository. The canonical front door is README.adoc; the machine index is REGISTRY.a2ml.

What is standards?

The organization-wide source of truth for Hyperpolymath policies, the A2ML metadata family, K9 components, the protocols, the readiness-grading frameworks (ARG/FRG/CRG/TRG), RSR compliance, and the enforcement/CI that makes them stick. See README.adoc for the full overview and the "if you want X, go here" routing table.

Apply the standards to your repo

git clone https://github.com/hyperpolymath/standards.git

1. Scaffold a compliant repo: follow A2ML-REPO-TEMPLATE.adoc and the Usage section of README.adoc.

2. Add the 7 A2ML files: copy from a2ml-templates/ into your repo’s .machine_readable/.

3. Adopt enforcement: copy the relevant workflows and hooks (language policy, doc-format, Makefile blocker, registry-verify).

4. Follow the language + licence policy: .claude/CLAUDE.md.

Find a specific spec

Use the registry — it routes you from a spec id to its home and the one doc to read first:

• Machine index: .machine_readable/REGISTRY.a2ml

• Prose + drift automation: REGISTRY.adoc

Get help

• Routing: the table at the top of README.adoc

• Report a problem: https://github.com/hyperpolymath/standards/issues

• Architecture map (derived): TOPOLOGY.md