diff --git a/docs/wiki/Architecture.md b/docs/wiki/Architecture.md
index ea95877..ac9716a 100644
--- a/docs/wiki/Architecture.md
+++ b/docs/wiki/Architecture.md
@@ -1,53 +1,3 @@
 # Architecture
 
-## Schema versioning + Pages registry publishing pipeline
-
-```mermaid
-flowchart TD
-    Dev["Schema author\n(schemas/vMAJOR.MINOR/*.schema.json)"] -->|"npm test"| Validate["Draft 2020-12 compile\n+ example validation\n+ lifecycle correlation"]
-    Validate --> Tag["git tag vMAJOR.MINOR.PATCH"]
-    Tag --> Push["push to main / tag push"]
-    Push --> Pages["pages.yml (sole Pages owner)"]
-    subgraph Pages["Deploy Pages workflow"]
-        Docs["mkdocs build\n(documentation site)"]
-        Registry["build-registry.mjs per tag\n-> registry/vMAJOR.MINOR\n-> registry/releases/vMAJOR.MINOR.PATCH"]
-        ValidateReg["validate:registry"]
-        Merge["cp registry/ into site/registry/\n(single artifact, no CNAME clash)"]
-    end
-    Docs --> Merge
-    Registry --> ValidateReg --> Merge
-    Merge --> Deploy["actions/deploy-pages\ncoding-autopilot-system.github.io/cas-contracts/registry/"]
-    Deploy --> Consumers["Consumers (gsd-orchestrator, autogen, cas-evals)\nfetch registry/index.json, vMAJOR.MINOR/*, releases/*"]
-```
-
-<!-- codex:generate-image prompt="A printing-press pipeline: a schema document enters a validation gate, gets stamped with a version tag, then travels down a single conveyor belt that merges with a documentation-site stream before both are printed onto one large publication board reading REGISTRY; several small robot consumers below reach up and pull dated copies off the board; isometric, enterprise blue/graphite palette" style="isometric, enterprise, clean" replaces="mermaid-above" -->
-
-## Publishing pipeline detail
-
-`.github/workflows/pages.yml` is the **sole owner** of the GitHub Pages deployment — it builds
-the mkdocs documentation site and the schema registry into one artifact so a docs push and a
-schema release tag can never clobber each other on the single Pages origin. It runs on pushes
-to `main`/`master` and on `v[0-9]+.[0-9]+.[0-9]+` tags. For each existing release tag it
-archives `schemas/vMAJOR.MINOR/` at that tag, runs `scripts/build-registry.mjs` to produce
-`registry/vMAJOR.MINOR` (stable, receives compatible patches) and
-`registry/releases/vMAJOR.MINOR.PATCH` (immutable) trees, validates the assembled registry,
-strips any `CNAME` (the registry is a Pages sub-path, not its own origin), and deploys via
-`actions/deploy-pages`.
-
-## Schema identity vs. distribution — currently in transition
-
-`docs/DISTRIBUTION.md` already states the accurate contract: schema `$id` values reserve the
-canonical namespace `https://schemas.coding-autopilot.dev/`, but that domain is not currently
-resolvable, so **the GitHub Pages registry is the authoritative, resolvable distribution
-endpoint today**. PR #18 (`fix(registry): rewrite schema $id to the resolvable Pages registry
-URL`) is rewriting all 22 schemas' `$id` values to match this reality directly; it is open and
-not yet merged — see [Decisions](./Decisions.md).
-
-## Lifecycle contract
-
-Every record carries `correlationId`, `promptId`, `runId`, structured `actor`, RFC 3339
-`timestamp`, explicit `schemaVersion`, and W3C `traceparent`/`tracestate`, so an
-`EvaluationResult` can be traced back through `VerificationResult`, `ArtifactManifest`, and
-`RunEvent[]` to the originating `PromptEnvelope`.
-
-<!-- docs-verified: 991c3606b148ab42134e505f4cf110afb8cb8e6b 2026-07-08 -->
+![Architecture Diagram](assets/arch.png)
diff --git a/docs/wiki/assets/arch.png b/docs/wiki/assets/arch.png
new file mode 100644
index 0000000..32b99b7
Binary files /dev/null and b/docs/wiki/assets/arch.png differ