// SPDX-License-Identifier: CC-BY-SA-4.0
// SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath)
= Developers track — building to the standards
:toc:
:toc-placement: preamble
:status: Scaffold v0.1.0 (2026-06-21)

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`.

== 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, `a2ml-templates/`.
* K9 self-validating components: `k9-svc/`, `k9-coordination-protocol/`.
* TODO: "write a valid STATE/META set and pass Validate A2ML".

=== 4. The protocols

* `avow-protocol/`, `axel-protocol/`, `overlay-protocol/`,
  `0-ai-gatekeeper-protocol/`. (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 — link:../../decisions/ADR-003-workflow-pin-staleness-window.adoc[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`.
