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

For maintainers of **this repo** — the people who change the standards, run
the generators, and uphold the guardrails. Highest blast radius; read the
guardrails before touching anything.

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

== Guardrails (non-negotiable, read first)

=== Licence is Manual-Only for agents

* `.claude/CLAUDE.md` (§License Policy) + `LICENCE-POLICY.adoc`.
* Never sweep SPDX/licence headers; licence-drift findings are *flag-only*.
  New files may carry correct SPDX from birth, matching the repo's
  classification. (Root cause: neurophone#99.)
* TODO: the five-way classification cheat-sheet (MPL / ARR / AGPL / forks / PMPL).

=== Generated files are never hand-edited

* `.machine_readable/REGISTRY.a2ml` and `TOPOLOGY.md` are *generated* by
  `scripts/build-registry.sh` (`just registry`); edit the `SPECS` table in the
  generator, then regenerate. CI `registry-verify.yml` fails on drift.
* TODO: "add a new spec home end-to-end".

== Learning path

=== 1. The registry + topology pipeline

* `scripts/build-registry.sh`, `just registry` / `just registry-check`,
  `REGISTRY.adoc`, `TOPOLOGY.md` (derived).

=== 2. Drift / staleness automation

* HYP-S006 `registry-staleness` (`hypatia-rules/`) — the time-window idiom.
* Reusable-pin freshness: link:../../decisions/ADR-003-workflow-pin-staleness-window.adoc[ADR-003],
  `scripts/check-workflow-staleness.sh`, `scripts/propagate-workflow-pins.sh`.
* Deferred cross-repo auto-bump: `docs/FUTURE-WORK.adoc` (#16).

=== 3. Readiness-grade governance

* `component-readiness-grades/` (+ ARG/FRG/TRG), `CRG-SELF-ASSESSMENT.adoc`,
  the demotion/overclaim detectors in `hypatia-rules/`.

=== 4. Decision records & policy

* `docs/decisions/` (ADR process), the `*-POLICY.adoc` set
  (DEPENDABOT, TRUSTED-BASE, REMOTE-URL, CODEOWNERS, TOOLING-VERSION-INTEGRITY).
* TODO: "when to write an ADR vs a policy".

=== 5. The innervation / contractile stack (6a2)

* `.machine_readable/6a2/` (STATE/META/…), `contractiles/`, `contractile.just`,
  `coordination.k9`, `.verisimdb/`, and Hypatia as the estate-side analyser.
* TODO: "how a contractile is registered and fires"; whether estate scripts
  (e.g. the staleness/propagation pair) should be registered as contractiles.

=== 6. Release & ownership

* `release-pre-flight/`, `publication-pre-flight/`, `just v1-audit`,
  `MAINTAINERS.adoc`, `CODEOWNERS-POLICY.adoc`, `SECURITY.md`.
