crabbuild · forhappy · Oct 4, 2026 · Oct 4, 2026 · Oct 4, 2026
diff --git a/DESIGN.md b/DESIGN.md
diff --git a/README.md b/README.md
@@ -14,6 +14,7 @@ This page keeps the project overview, setup path, and first repository workflow.
 | You want to… | Start with |
 | --- | --- |
 | Understand the storage model | [How Canopy stores a repository](#how-canopy-stores-a-repository) |
+| Understand the design and control flow | [Canopy design](DESIGN.md) and [architecture gallery](diagram/canopy-architecture/index.html) |
 | Navigate the Rust crates | [Rust workspace](docs/workspace.md) |
 | Run a development node | [Run a local node](#run-a-local-node) |
 | Start an isolated local server and test a Kubernetes-sized repository | [Local evaluation and real-repository benchmark](deploy/local-evaluation.md) |

diff --git a/diagram/canopy-architecture/01-system-overview.svg b/diagram/canopy-architecture/01-system-overview.svg
diff --git a/diagram/canopy-architecture/01-system-overview@2x.png b/diagram/canopy-architecture/01-system-overview@2x.png