57 lines (40 loc) · 2.26 KB

Developers track — building to the standards

For developers writing repos, tools, or rules that must comply with and extend the standards. You author code/metadata that the gates will judge.

Note	Scaffold. The link spine is complete; the connective prose is `TODO`.

Table of Contents

Learning path

Learning path

1. The language policy (read first)

.claude/CLAUDE.md (canonical) — allowed/banned languages, the AffineScript stance, the carve-out tables (TS/ReScript/npm/JS exemptions).
TODO: "choosing a language for a new component" decision flow.

2. Build system

Mustfile / justfile (no Makefiles): https://github.com/hyperpolymath/mustfile
Justfile here — just --list; package mgmt via Guix → Nix → Deno.
TODO: "wire a new sub-project into the monorepo build/test".

3. Author the machine-readable metadata

A2ML family: a2ml/, the *-a2ml/ homes, 1-formats/templates/.
K9 self-validating components: 1-formats/k9/, 2-protocols/k9-coordination/.
TODO: "write a valid STATE/META set and pass Validate A2ML".

4. The protocols

2-protocols/avow/, 2-protocols/axel/, 2-protocols/overlay/, 2-protocols/0-ai-gatekeeper/. (Consent-Aware Web was extracted to metadatastician/consent-aware-web on 2026-08-07.)
TODO: per-protocol "when would I implement this" summary.

5. Write & extend Hypatia rules

hypatia-rules/ (e.g. HYP-S006 registry-staleness) — the estate-side detection rules and the hybrid automation router (:auto_execute vs :review, with licence findings capped to :review).
TODO: "anatomy of a rule + how to add one".

6. The CI gates (what blocks a bad change)

.github/workflows/ + hooks/.
The workflow-pin staleness gate: scripts/check-workflow-staleness.sh (recency window — ADR-003).
Registry/topology sync, language policy, no-JS, secret scanning, SPARK gate.
TODO: "decode a red gate and the fastest green path".

7. Reference

QUICKSTART-DEV.adoc, llm-warmup-dev.md, CONTRIBUTING.md, docs/decisions/ (ADRs), docs/*-POLICY.adoc.