chore(meta+grades): fix .scm/.a2ml + .md/.adoc + 17/4 workflow-count drift (#33)

## Summary

Three doc-drift corrections across `.meta/REQUIRED-FILES`, the
immaculate guide, and the readiness-grades suite — all aligning prose
docs with the canonical *machine-readable* rules.

### 1. `.scm` → `.a2ml` for the 6a2 metadata files

`.meta/REQUIRED-FILES.md` listed `META.scm` / `STATE.scm` /
`ECOSYSTEM.scm` / `PLAYBOOK.scm` / `AGENTIC.scm` / `NEUROSYM.scm` under
"Mandatory SCM Files." The actual canonical extension is `.a2ml`.

Confirmed by user 2026-04-30: *"a2ml for sure scm is removed except for
guix related."*

Consistent with this repo's own `.machine_readable/6a2/AGENTIC.a2ml`
etc. (which use `.a2ml`, contradicting the doc) and with
`hypatia-rules/rsr-self-compliance.a2ml @forbidden_files`:

```
- glob: "STATE.a2ml"
  at: "/"
  reason: "A2ML files go in .machine_readable/ only"
```

`.scm` is now reserved exclusively for Guix-related files (`guix.scm`,
`.guix-channel`).

### 2. `.md` → `.adoc` for `REQUIRED-FILES` itself

Per the hyperpolymath convention (AsciiDoc by default; Markdown only for
files GitHub's community-health rules special-case by name),
`.meta/REQUIRED-FILES.md` is internal documentation — it should be
`.adoc`. Same syntax-conversion approach as PR
`hyperpolymath/rsr-template-repo#28`.

### 3. "17 / 19 RSR workflows" → reference the canonical
machine-readable rule

The actual machine-readable list of required workflows lives in
`hypatia-rules/rsr-self-compliance.a2ml @required_workflows` and
currently names **4** workflows:

```a2ml
@required_workflows:
- name: "hypatia-scan.yml"
  reason: "RSR R-050 (self-scan)"
- name: "mirror.yml"
  reason: "RSR R-051 (forge mirroring)"
- name: "scorecard.yml"
  reason: "RSR R-052 (OpenSSF Scorecard)"
- name: "rsr-antipattern.yml"
  reason: "RSR R-053 (antipattern check)"
@EnD
```

But several prose docs claimed "17 RSR workflows" (or "19 CI
workflows"):

| File | Old claim | Now |
|---|---|---|
| `immaculate-guide/IMMACULATE-GUIDE.adoc:130` | "17 required workflows"
| references `@required_workflows` (currently 4) + broader adoptable set
|
| `immaculate-guide/IMMACULATE-GUIDE.adoc:267` | "17 required workflows
from rsr-template-repo" | enumerates the 4 mandated by name + notes
broader optional set |
| `toolchain-readiness-grades/TOOLCHAIN-READINESS-GRADES.adoc:228` |
"all 17 RSR workflows present" | references `@required_workflows` |
| `toolchain-readiness-grades/TOOLCHAIN-READINESS-GRADES.adoc:443` |
"All 17 RSR workflows present" | references `@required_workflows` |
| `toolchain-readiness-grades/TOOLCHAIN-READINESS-GRADES.a2ml:56` |
"RSR-FULL all 17 workflows green" | "RSR-FULL all required workflows
green (per …@required_workflows)" |
| `toolchain-readiness-grades/SELF-ASSESSMENT.adoc:74` | "all 17 RSR
workflows present" | references `@required_workflows` |
| `component-readiness-grades/SELF-ASSESSMENT.adoc:32` | "19 CI
workflows" | "RSR-required CI workflows (per …@required_workflows) +
adopted optional set" |

Replacing the hard count with a reference to the machine-readable rule
makes the prose durable: if the canonical-required set changes from 4 to
N tomorrow, the prose stays correct without further editing.

## Why this matters

The numeric drift was visible to anyone reading: the prose docs claim 17
(or 19); the machine-readable rule says 4; this repo's own
`.github/workflows/` has 21; `rsr-template-repo`'s has 25. None of the
prose numbers matched the actual rule. With this PR, prose now points at
the rule rather than restating an out-of-date count.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: hyperpolymath

.meta/REQUIRED-FILES.adoc

@@ -0,0 +1,73 @@
+// SPDX-License-Identifier: PMPL-1.0-or-later
+= Required Repository Files
+
+The following files *MUST* be present and kept up-to-date in every repository:
+
+== Mandatory Dotfiles
+
+[cols="2,3"]
+|===
+| File | Purpose
+
+| `.gitignore` | Exclude build artifacts, secrets, and temp files
+| `.gitattributes` | Enforce LF line endings and diff settings
+| `.editorconfig` | Consistent editor settings across IDEs
+| `.tool-versions` | asdf version pinning for reproducible builds
+|===
+
+== Mandatory A2ML Files
+
+[NOTE]
+====
+These files use the `.a2ml` extension. Earlier versions of this doc
+listed them as `.scm`; that was stale drift. `.scm` is reserved exclusively
+for Guix-related files (`guix.scm`, `.guix-channel`). All 6a2 metadata
+files use `.a2ml`.
+====
+
+[cols="2,3"]
+|===
+| File | Purpose
+
+| `META.a2ml` | Architecture decisions, development practices
+| `STATE.a2ml` | Project state, phase, milestones
+| `ECOSYSTEM.a2ml` | Ecosystem positioning, related projects
+| `PLAYBOOK.a2ml` | Executable plans, procedures
+| `AGENTIC.a2ml` | AI agent operational gating
+| `NEUROSYM.a2ml` | Symbolic semantics, proof obligations
+|===
+
+== Build System
+
+[cols="2,3"]
+|===
+| File | Purpose
+
+| `justfile` | Task runner (replaces Makefile)
+| `Mustfile` | Deployment state contract
+|===
+
+*IMPORTANT*: Makefiles are FORBIDDEN. Use `just` for all tasks.
+
+== Validation
+
+These files are checked by:
+
+* CI workflow validation
+* Pre-commit hooks (when configured)
+* Repository standardization scripts
+
+== Updates
+
+When updating these files:
+
+. Use templates from `rsr-template-repo` as reference
+. Ensure SPDX license header is present
+. Test changes locally before pushing
+. Keep language-specific sections relevant to the repo
+
+== See Also
+
+* link:https://github.com/hyperpolymath/rhodium-standard-repositories[RSR (Rhodium Standard Repositories)]
+* link:https://github.com/hyperpolymath/mustfile[Mustfile Specification]
+* link:https://github.com/hyperpolymath/standards/tree/main/meta-a2ml[A2ML Format Family]

.meta/REQUIRED-FILES.md

@@ -29,7 +29,7 @@ Assessed: 2026-04-04
 
 |**D (RSR-Compliant)**
 |PASSED
-|RSR scaffolding complete: LICENSE, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, MAINTAINERS.adoc, 19 CI workflows, .machine_readable/, 0-AI-MANIFEST.a2ml, Justfile/Mustfile
+|RSR scaffolding complete: LICENSE, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, MAINTAINERS.adoc, RSR-required CI workflows (per `hypatia-rules/rsr-self-compliance.a2ml @required_workflows`) + adopted optional set, .machine_readable/, 0-AI-MANIFEST.a2ml, Justfile/Mustfile
 
 |**C (Self-Validated)**
 |PASSED

component-readiness-grades/SELF-ASSESSMENT.adoc

@@ -127,7 +127,7 @@ fi
 === rsr-template-repo as Canonical Start
 
 Every new repository MUST start from `rsr-template-repo`, not from scratch.
-This ensures the 17 required workflows, the `.machine_readable/` directory,
+This ensures the RSR-required workflows (per `hypatia-rules/rsr-self-compliance.a2ml @required_workflows` — currently 4 mandated, plus the broader adoptable set), the `.machine_readable/` directory,
 and the `justfile` scaffold are present from day one.
 
 [source,bash]
@@ -264,7 +264,7 @@ before every merge._
 
 === The Hyperpolymath CI Stack
 
-Every repo uses the 17 required workflows from `rsr-template-repo`.
+Every repo uses the RSR workflows from `rsr-template-repo` — 4 mandated by `hypatia-rules/rsr-self-compliance.a2ml @required_workflows` (`hypatia-scan.yml`, `mirror.yml`, `scorecard.yml`, `rsr-antipattern.yml`), plus the broader optional adoptable set.
 The three that act as truth validators are:
 
 [source,bash]

immaculate-guide/IMMACULATE-GUIDE.adoc

@@ -71,7 +71,7 @@ The next non-trivial promotion. Requires:
   is now at `templates/CANONICAL-PROOF-SUITE.adoc` (v1.0, 15 entries).
 . *2 fully-proven programs* per §6.2, each cross-validated by at
   least one qualifying prover from `templates/QUALIFYING-PROVERS.adoc`.
-. *RSR-FULL* — all 17 RSR workflows present, SHA-pinned, and currently
+. *RSR-FULL* — all RSR-required workflows (per `hypatia-rules/rsr-self-compliance.a2ml @required_workflows`) plus the broader adopted set present, SHA-pinned, and currently
   green. Standards repo is RSR-compliant; need to verify the same for
   the host repo of the audited component.
 . *Banned constructs ZERO* — verified by `panic-attack assail` clean

toolchain-readiness-grades/SELF-ASSESSMENT.adoc

@@ -53,7 +53,7 @@
     (stability-posture "not-yet-releasable")
     (ordinal 3)
     (description "All Must + Should + Canonical Proof Suite. RSR-FULL. panic-attack zero across all severities. Fuzzing harness exists. 2 fully-proven programs.")
-    (evidence-required "all E + canonical M/S/E proof suite passing + RSR-FULL all 17 workflows green + panic-attack zero all severities + fuzz harness exists + 2 fully-proven programs each by >=1 qualifying prover")
+    (evidence-required "all E + canonical M/S/E proof suite passing + RSR-FULL all required workflows green (per hypatia-rules/rsr-self-compliance.a2ml @required_workflows) + panic-attack zero all severities + fuzz harness exists + 2 fully-proven programs each by >=1 qualifying prover")
     (minimum-for #f))
   (grade
     (code C)

toolchain-readiness-grades/TOOLCHAIN-READINESS-GRADES.a2ml

@@ -225,7 +225,7 @@ NOTE: D is *not* the alpha gate. Alpha begins at C. D is the
 
 [horizontal]
 Tier gate:: All *Must* AND all *Should* rows PASSED.
-Repository discipline:: RSR-FULLY-compliant — all 17 RSR workflows present,
+Repository discipline:: RSR-FULLY-compliant — all RSR-required workflows (per `hypatia-rules/rsr-self-compliance.a2ml @required_workflows`) plus the broader adopted set present,
         SHA-pinned, and *currently green*. (Promoted from B to D because
         a toolchain component without RSR-full is just an unaudited binary
         in disguise.) All grade-E requirements carried forward.
@@ -440,7 +440,7 @@ estate standard at the time of assessment. Specifically and without
 exception:
 
 [horizontal]
-RSR:: All 17 RSR workflows present, SHA-pinned, and *green for at least
+RSR:: All RSR-required workflows (per `hypatia-rules/rsr-self-compliance.a2ml @required_workflows`) plus the broader adopted set present, SHA-pinned, and *green for at least
       90 consecutive days*. Zero workflow flakes in that window.
 Branch protection:: per `feedback_branch_protection.md` —
                     PR-required, signatures-required, linear history,