chore(docs): repo-wide doc tidy + .machine_readable canonical layout

Root-level reconciliation:
- Move dated session reports to docs/archive/ (BOT-ENHANCEMENTS,
  DOGFOODING-ANALYSIS, FLEET-DEPLOYMENT-STATUS, NEW-PATTERNS-DEPLOYMENT,
  OUTSTANDING-WORK) with a docs/archive/README.md index recording why
  each one is kept.
- Move long-form BOT-OPERATIONS.md under docs/.
- Drop near-duplicate llm-warmup-{dev,user}.md stubs (16-line identical
  copies); the same information is in README.adoc + EXPLAINME.adoc.
- Rewrite README.adoc: remove duplicate "== Architecture" section,
  expand bot table to all 11 bots, point at docs/ARCHITECTURE.md as
  the single source of truth, add a Documentation section listing the
  authoritative pointers.
- Add docs/README.md as the docs index.

.machine_readable/ taxonomy fix per A2ML-REPO-TEMPLATE
(hyperpolymath/standards):
- Flatten .machine_readable/6a2/*.a2ml up to .machine_readable/*.a2ml
  (AGENTIC, ECOSYSTEM, META, NEUROSYM, PLAYBOOK, STATE).
- Flatten .machine_readable/anchors/ANCHOR.a2ml up to
  .machine_readable/ANCHOR.a2ml.
- The seven canonical files now sit directly under .machine_readable/
  exactly as the template specifies.

Add docs/ARCHITECTURE.md as the single source of truth for the
pipeline, components, and critical invariants. The repo-root
README.adoc + .claude/CLAUDE.md both link here.

Refresh .claude/CLAUDE.md: drop the stale ".machine_readable/6scm/"
invariant and point at the new docs/ARCHITECTURE.md + docs/archive/
locations.

Add docs/wiki-source/ with Markdown for the GitHub wiki (Home,
Architecture, Safety-Triangle, Build-and-Run, Bot-Operations, plus
_Sidebar and _Footer). The repo is the source of truth; the wiki is a
publication target — docs/README.md documents the sync command.

Author: claude

.claude/CLAUDE.md

@@ -1,21 +1,28 @@
 # SPDX-License-Identifier: PMPL-1.0-or-later
 
-# CLAUDE.md - Gitbot Fleet
+# CLAUDE.md — Gitbot Fleet
 
 ## Project Overview
 
-Gitbot Fleet is the bot orchestration hub for automated repository quality enforcement across 500+ hyperpolymath repositories. It coordinates multiple bots through a shared-context system with safety-triangle-aware routing.
+Gitbot Fleet is the bot orchestration hub for automated repository
+quality enforcement across ~500 hyperpolymath repositories. It
+coordinates 11 bots through a shared-context system with safety-triangle
+-aware routing.
 
-## Architecture
+The authoritative architecture document is [`docs/ARCHITECTURE.md`](../docs/ARCHITECTURE.md).
+The repo-root `README.adoc` is the entry point for humans.
+
+## Architecture (summary — see `docs/ARCHITECTURE.md` for the full pipeline)
 
 ```
 hypatia (scanner)  →  findings JSONL  →  fleet-coordinator.sh  →  dispatch-runner.sh
-                                               ↓
+                                               │
                                     ┌──────────┼──────────┐
                                     ▼          ▼          ▼
-                               rhodibot   echidnabot  sustainabot
-                               (git ops)  (quality)   (deps)
-                                    ↓
+                               rhodibot   echidnabot  sustainabot   ... + 8 more
+                               (git ops)  (quality)   (eco/econ)
+                                    │
+                                    ▼
                         robot-repo-automaton
                         (scan → fix → commit → PR)
 ```
@@ -24,18 +31,20 @@ hypatia (scanner)  →  findings JSONL  →  fleet-coordinator.sh  →  dispatch
 
 | Component | Location | Purpose |
 |-----------|----------|---------|
-| fleet-coordinator.sh | root | Orchestrates bot dispatching |
-| dispatch-runner.sh | scripts/ | Reads JSONL manifests, executes fixes |
-| process-review-findings.sh | scripts/ | Creates GitHub issues for review-tier |
-| fix-*.sh | scripts/ | 7 fix scripts for eliminate-tier patterns |
-| shared-context/ | shared-context/ | Rust crate for inter-bot communication |
-| robot-repo-automaton/ | robot-repo-automaton/ | Rust CLI: scan, fix, PR creation |
+| `fleet-coordinator.sh` | repo root | Orchestrates bot dispatching |
+| `dispatch-runner.sh` | `scripts/` | Reads JSONL manifests, executes fixes |
+| `process-review-findings.sh` | `scripts/` | Opens GitHub issues for review-tier findings |
+| `fix-*.sh` | `scripts/` | ~50 fix scripts for eliminate-tier patterns |
+| `shared-context/` | `shared-context/` | Rust crate for inter-bot communication |
+| `robot-repo-automaton/` | `robot-repo-automaton/` | Rust CLI: scan, fix, PR creation |
 
 ## Build & Run
 
 ```bash
 # Shell scripts (no build needed)
 bash fleet-coordinator.sh --help
+just maintenance-hard-pass /absolute/path/to/repo
+just scan-supervised
 
 # Robot-repo-automaton (Rust)
 cd robot-repo-automaton
@@ -48,8 +57,8 @@ OPENSSL_NO_VENDOR=1 cargo build --release
 
 ```
 Eliminate (auto_execute >= 0.95)  →  Direct fix, no review
-Substitute (review >= 0.85)      →  proven module replacement, needs review
-Control (report < 0.85)          →  Human review required
+Substitute (review >= 0.85)       →  Proven module replacement, needs review
+Control    (report < 0.85)        →  Human review required
 ```
 
 ## Code Style
@@ -62,8 +71,20 @@ Control (report < 0.85)          →  Human review required
 
 ## Critical Invariants
 
-1. SCM files ONLY in `.machine_readable/6scm/` (never root)
-2. All shell scripts must validate untrusted input before use
-3. No hardcoded secrets — use env vars with `${VAR:-}` defaults
-4. Fix scripts must be idempotent (safe to run multiple times)
-5. Confidence thresholds gate all automated actions
+1. The seven canonical A2ML files (`STATE`, `META`, `ECOSYSTEM`,
+   `AGENTIC`, `NEUROSYM`, `PLAYBOOK`, `ANCHOR`) live directly under
+   `.machine_readable/`, per the `A2ML-REPO-TEMPLATE` in
+   `hyperpolymath/standards`. (Earlier versions of this CLAUDE.md
+   referenced a `.machine_readable/6scm/` subdir; that layout has been
+   retired.)
+2. All shell scripts validate untrusted input before use.
+3. No hardcoded secrets — use env vars with `${VAR:-}` defaults.
+4. Fix scripts must be idempotent (safe to run multiple times).
+5. Confidence thresholds gate all automated actions.
+
+## Repo health
+
+- Open PRs / issues, dated session reports, and historical status
+  snapshots: see [`docs/archive/`](../docs/archive/).
+- Component readiness (CRG grades + evidence): [`READINESS.md`](../READINESS.md).
+- Roadmap (all 11 bots): [`ROADMAP.adoc`](../ROADMAP.adoc).

.machine_readable/6a2/AGENTIC.a2ml .machine_readable/AGENTIC.a2ml.machine_readable/6a2/AGENTIC.a2ml renamed to .machine_readable/AGENTIC.a2ml

@@ -1,119 +1,135 @@
-image:https://img.shields.io/badge/License-PMPL--1.0-blue.svg[License: PMPL-1.0,link="https://github.com/hyperpolymath/palimpsest-license"]
-
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// SPDX-FileCopyrightText: 2025 hyperpolymath
-
-= Gitbot Fleet
-
+// SPDX-FileCopyrightText: 2025-2026 Jonathan D.A. Jewell
 
+image:https://img.shields.io/badge/License-PMPL--1.0-blue.svg[License: PMPL-1.0,link="https://github.com/hyperpolymath/palimpsest-license"]
 
-:toc: auto
+= Gitbot Fleet
+:toc: macro
 :toclevels: 2
+:icons: font
 
-Bot fleet for repository quality enforcement across the Hyperpolymath ecosystem.
+Bot orchestration hub for automated repository quality enforcement across the Hyperpolymath ecosystem (~500 repos).
+
+toc::[]
 
 == Overview
 
-Gitbot Fleet is the central orchestration repository for all quality-enforcement bots in the Hyperpolymath ecosystem. Each bot specializes in a specific aspect of repository health and compliance.
+Gitbot Fleet coordinates 11 specialised bots through a shared-context layer. The
+`fleet-coordinator` dispatches Hypatia scanner findings to bots based on
+the **safety triangle**:
 
-== Maintenance Gate Operations
+* **Eliminate** (`auto_execute >= 0.95`) — direct fix, no review
+* **Substitute** (`review >= 0.85`) — proven module replacement, needs review
+* **Control** (`report < 0.85`) — human review required
 
-Use these commands to run maintenance gating across repos:
+== Architecture
 
-[source,bash]
+[source]
 ----
-just maintenance-hard-pass /absolute/path/to/repo
-just enroll-repos
-just scan-supervised
+hypatia (scanner)  →  findings JSONL  →  fleet-coordinator.sh  →  dispatch-runner.sh
+                                              │
+              ┌───────────────────────────────┼───────────────────────────────┐
+              ▼                               ▼                               ▼
+        rhodibot                       echidnabot                       sustainabot
+        (git ops, RSR)                 (quality, proofs)                (deps, eco/econ)
+              │                               │                               │
+              └─────────► shared-context layer ◄────────┐                     │
+                                                        ▼                     ▼
+                                                  robot-repo-automaton  (scan → fix → PR)
 ----
 
-`maintenance-hard-pass` enforces fail-on-warn release gating using the target repo maintenance script.
-
-`enroll-repos` refreshes repository coverage metadata for gitbot-fleet and hypatia. Use `just enroll-repos /var$REPOS_DIR true` to also write enrollment directives into repos that already have `.machine_readable/`.
-
-`scan-supervised` runs Hypatia across the supervised inventory (`~/.git-private-farm.scm`, `~/.git-private-repos`, or enrollment registry) and then processes findings for fleet dispatch.
+A full architecture map with completion state lives in
+link:docs/ARCHITECTURE.md[docs/ARCHITECTURE.md] (single source of truth).
+The historical `TOPOLOGY.md` dashboard is at the repo root.
 
 == Bot Roster
 
 [cols="1,3,1"]
 |===
-|Bot |Purpose |Status
+| Bot | Purpose | Status
+
+| **rhodibot** | Git ops, RSR (Rhodium Standard Repositories) enforcement | Active
+| **echidnabot** | Formal verification, multi-prover dispatch, security fuzzing | Active
+| **sustainabot** | Eco/econ + technical-debt scoring; carbon-intensity gates | Active
+| **glambot** | Presentation: visual polish, WCAG accessibility, SEO, machine-readability | Active
+| **seambot** | Integration seam health, cross-component contracts, end-to-end flows | Active
+| **finishingbot** | Release readiness: placeholder removal, license + claim verification | Active
+| **accessibilitybot** | Accessibility-rule enforcement (WCAG, ARIA, contrast) | Active
+| **cipherbot** | Crypto + secret hygiene; policy-driven cipher checks | Active
+| **gsbot** | General-services: backup/load/export fixtures and operational scripts | Active
+| **panicbot** | Panic + crash-capture surfaces; surfaces broken assumptions | Active
+| **the-hotchocolabot** | Comfort / human-facing channels; non-blocking advisory output | Active
+|===
 
-|**rhodibot**
-|RSR (Rhodium Standard Repositories) compliance validation. Structural checks, file presence, directory layout.
-|Active
+The component-readiness assessment (CRG grades, evidence) lives in
+link:READINESS.md[READINESS.md].
 
-|**echidnabot**
-|Formal mathematical/statistical verification. Security fuzzing as secondary function.
-|Active
+== Build & Run
 
-|**sustainabot**
-|Ecological and economic code standards. Carbon intensity, resource efficiency, technical debt modeling.
-|Active
+Maintenance gating commands:
 
-|**glambot**
-|Presentation quality. Visual polish, accessibility (WCAG), SEO, machine-readability for AI/bots.
-|Complete
+[source,bash]
+----
+just maintenance-hard-pass /absolute/path/to/repo
+just enroll-repos
+just scan-supervised
+----
 
-|**seambot**
-|Integration health testing. Cross-component communication, API contracts, end-to-end flows.
-|Active
+`maintenance-hard-pass` enforces fail-on-warn release gating using the
+target repo's maintenance script. `enroll-repos` refreshes repository
+coverage metadata; pass `/var$REPOS_DIR true` to also write enrollment
+directives into repos that already have `.machine_readable/`.
+`scan-supervised` runs Hypatia across the supervised inventory
+(`~/.git-private-farm.scm`, `~/.git-private-repos`, or the enrollment
+registry) and processes findings for fleet dispatch.
 
-|**finishbot**
-|Release readiness. Placeholder removal, license validation, claim verification, execution testing.
-|Complete
-|===
+Other useful `just` recipes: `setup`, `build`, `test`, `doctor`, `heal`,
+`hypatia-scan`, `panic-scan`, `crg-grade`.
 
-== Architecture
+For the Rust executor:
 
-[source]
+[source,bash]
 ----
-                     GITBOT FLEET
-   ┌──────────────────────────────────────────┐
-   │                                          │
-   │  ┌─────────┐  ┌─────────┐  ┌─────────┐  │
-   │  │ rhodibot│  │echidna  │  │  sustainabot  │  │
-   │  │(RSR     │  │(verify) │  │(eco/    │  │
-   │  │ struct) │  │         │  │ econ)   │  │
-   │  └────┬────┘  └────┬────┘  └────┬────┘  │
-   │       │            │            │        │
-   │       ▼            ▼            ▼        │
-   │  ┌─────────────────────────────────────┐ │
-   │  │        SHARED CONTEXT LAYER         │ │
-   │  └─────────────────────────────────────┘ │
-   │       │            │            │        │
-   │       ▼            ▼            ▼        │
-   │  ┌─────────┐  ┌─────────┐  ┌─────────┐  │
-   │  │ glambot │  │ seambot │  │finishing│  │
-   │  │(present │  │(integr) │  │  -bot   │  │
-   │  │ ation)  │  │         │  │(release)│  │
-   │  └─────────┘  └─────────┘  └─────────┘  │
-   │                                          │
-   └──────────────────────────────────────────┘
+cd robot-repo-automaton
+OPENSSL_NO_VENDOR=1 cargo build --release
+./target/release/robot-repo-automaton scan /path/to/repo
+./target/release/robot-repo-automaton fix /path/to/repo --create-pr
 ----
 
-== Relationship to git-dispatcher
+== Documentation
 
-This repository is a **satellite** of `git-dispatcher`, the central coordination hub for all Git automation in the Hyperpolymath ecosystem.
+Authoritative documents:
 
-== License
+* link:EXPLAINME.adoc[EXPLAINME.adoc] — long-form architecture and rationale
+* link:ROADMAP.adoc[ROADMAP.adoc] — forward plan, all 11 bots
+* link:READINESS.md[READINESS.md] — Component Readiness Grades (CRG) assessment
+* link:docs/[docs/] — operational guides, performance notes, branch protection
+* link:docs/archive/[docs/archive/] — historical session reports kept for audit
+* link:docs/wiki-source/[docs/wiki-source/] — repo source for the GitHub wiki
 
-PMPL-1.0-or-later - See LICENSE file.
+Quickstart guides:
 
-image:https://img.shields.io/badge/License-PMPL--1.0-blue.svg[License: PMPL-1.0,link="https://github.com/hyperpolymath/palimpsest-license"]
+* link:QUICKSTART-DEV.adoc[For developers]
+* link:QUICKSTART-USER.adoc[For users]
+* link:QUICKSTART-MAINTAINER.adoc[For maintainers]
+
+== Relationship to git-dispatcher and OPSM
 
-== OPSM Link
+This repository is a **satellite** of `git-dispatcher`, the central
+coordination hub for all Git automation in the Hyperpolymath ecosystem.
+Within OPSM (Operational Process State Management), gitbot-fleet is the
+execution fleet for batch operations:
 
 [source]
 ----
 OPSM Core
-  |
-  v
+  │
+  ▼
 gitbot-fleet (execution fleet for OPSM batch operations)
-
 ----
 
+== License
 
-== Architecture
+PMPL-1.0-or-later — see link:LICENSE[LICENSE] and link:NOTICE[NOTICE].
 
-See link:TOPOLOGY.md[TOPOLOGY.md] for a visual architecture map and completion dashboard.
+image:https://img.shields.io/badge/License-PMPL--1.0-blue.svg[License: PMPL-1.0,link="https://github.com/hyperpolymath/palimpsest-license"]

.machine_readable/anchors/ANCHOR.a2ml .machine_readable/ANCHOR.a2ml.machine_readable/anchors/ANCHOR.a2ml renamed to .machine_readable/ANCHOR.a2ml

@@ -0,0 +1,75 @@
+<!-- SPDX-License-Identifier: PMPL-1.0-or-later -->
+<!-- SPDX-FileCopyrightText: 2025-2026 Jonathan D.A. Jewell -->
+
+# Gitbot Fleet — Architecture
+
+This is the **single source of truth** for the gitbot-fleet architecture.
+The repo-root README links here; the `TOPOLOGY.md` dashboard at the repo
+root tracks live completion state.
+
+## Pipeline
+
+```
+hypatia (scanner)
+   │
+   ▼  findings.jsonl
+fleet-coordinator.sh        ← orchestrator, root of the repo
+   │
+   ▼  dispatch manifest
+dispatch-runner.sh          ← scripts/dispatch-runner.sh
+   │
+   ├──────────────┬──────────────┬─────────────────────┐
+   ▼              ▼              ▼                     ▼
+rhodibot     echidnabot     sustainabot          ... 8 more bots
+(git ops)    (verify)       (eco/econ)
+   │              │              │
+   └──────────────┴──────────────┴────► shared-context layer
+                                        (shared-context/, Rust crate)
+                                                │
+                                                ▼
+                                       robot-repo-automaton
+                                       (scan → fix → commit → PR)
+```
+
+## Components
+
+| Component | Path | Language | Purpose |
+|---|---|---|---|
+| `fleet-coordinator.sh` | repo root | bash | Orchestrates bot dispatching; reads Hypatia findings, builds manifests, dispatches per-bot |
+| `dispatch-runner.sh` | `scripts/` | bash | Reads JSONL manifests, executes per-finding fixes via `fix-*.sh` |
+| `process-review-findings.sh` | `scripts/` | bash | Opens GitHub issues for review-tier findings (Substitute / Control) |
+| `fix-*.sh` (~50 files) | `scripts/` | bash | One-shot fixers for eliminate-tier patterns (e.g. SPDX header, license file) |
+| `shared-context/` | `shared-context/` | Rust | Crate for inter-bot communication (RPC + state-sharing) |
+| `robot-repo-automaton/` | `robot-repo-automaton/` | Rust | CLI: scan, fix, PR creation |
+| `bots/*` | `bots/` | mostly Rust, AffineScript in sustainabot | Per-bot specialised logic |
+
+## Safety triangle
+
+```
+Eliminate (auto_execute >= 0.95)  →  Direct fix, no review
+Substitute (review >= 0.85)       →  Proven-module replacement, needs review
+Control (report < 0.85)           →  Human review required
+```
+
+The thresholds gate every automated action: a fix script is only run when
+the upstream Hypatia finding's confidence meets the eliminate threshold;
+substitute-tier findings open PRs with a `needs-review` label; control-tier
+findings file issues.
+
+## Critical invariants
+
+1. **Machine-readable files** live in `.machine_readable/` (the canonical
+   A2ML files — `STATE`, `META`, `ECOSYSTEM`, `AGENTIC`, `NEUROSYM`,
+   `PLAYBOOK`, `ANCHOR` — sit directly there). See the
+   `A2ML-REPO-TEMPLATE` in `hyperpolymath/standards`.
+2. **Shell scripts** validate untrusted input before use.
+3. **Secrets** come from env vars with `${VAR:-}` defaults — never
+   hardcoded.
+4. **Fix scripts must be idempotent** (safe to run multiple times).
+5. **Confidence thresholds** gate every automated action.
+
+## Repository position
+
+Gitbot Fleet is a satellite of `git-dispatcher` (central Git-automation
+coordination) and the execution fleet for OPSM (Operational Process State
+Management) batch operations.