diff --git a/README.md b/README.md
index a9b42cb..35ed782 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,36 @@
 <!-- SPDX-License-Identifier: Apache-2.0 -->
-# Trinity
+<div align="center">
+
+<img src="docs/assets/trinity-icon.png" alt="" width="132">
+
+<picture>
+  <source media="(max-width: 600px)" srcset="docs/assets/wordmark-sm.svg">
+  <img src="docs/assets/wordmark.svg" alt="TRINITY" width="520">
+</picture>
+
+### A personal AI agent that runs on your own machine
+
+It remembers you, learns procedures, acts through tools under a permission gate,<br>
+reaches you on whatever surface you are using, and does not lose your work when something crashes.
+
+<br>
 
 [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/14772/badge)](https://www.bestpractices.dev/projects/14772)
+[![Gate](https://img.shields.io/github/actions/workflow/status/ScriptKittyOS/Trinity/gate.yml?branch=main&style=flat-square&label=gate&labelColor=1b2420&color=2ea043)](https://github.com/ScriptKittyOS/Trinity/actions/workflows/gate.yml)
+[![License](https://img.shields.io/badge/license-Apache--2.0-2ea043?style=flat-square&labelColor=1b2420)](LICENSE)
+[![Elixir](https://img.shields.io/badge/Elixir%20%2F%20OTP-on%20the%20BEAM-2ea043?style=flat-square&labelColor=1b2420)](#why-the-beam)
+
+<br>
+
+**[Quick start](#running-from-source)** &nbsp;·&nbsp;
+**[Architecture](docs/01-architecture.md)** &nbsp;·&nbsp;
+**[Security model](docs/07-security-model.md)** &nbsp;·&nbsp;
+**[Assurance case](docs/10-assurance-case.md)** &nbsp;·&nbsp;
+**[Roadmap](ROADMAP.md)**
+
+</div>
 
-A personal AI agent that runs on your own machine. It remembers you, learns procedures, acts
-through tools under a permission gate, reaches you on whatever surface you are using, and does
-not lose your work when something crashes.
+---
 
 Trinity is built on Elixir and the BEAM, with Phoenix LiveView for the interface, and ships as a
 desktop application. Apache-2.0, developed in the open from the first commit.
@@ -14,8 +39,9 @@ desktop application. Apache-2.0, developed in the open from the first commit.
 
 Pre-alpha, and usable from source. Milestones M0 to M4 are approved, **M5a Automates** with them
 (050, the scheduler; 059, the MCP measurement; 060, the MCP client; 061, the MCP server; 062, MCP
-authorization), and the first slice of M5b (070, the gateway core): 25 slices, each merged with a
-merge commit and tagged `slice/NNN` (`git tag -l 'slice/*' | wc -l` → 25, on 2026-09-23). What
+authorization), and the first slice of M5b (070, the gateway core), with 002 (the supply chain
+slice) beside them: 26 slices, each merged with a merge commit and tagged `slice/NNN`
+(`git tag -l 'slice/*' | wc -l` → 26, on 2026-09-23). What
 that means in practice:
 
 **Assessed against a recognised baseline.** Trinity holds the
diff --git a/docs/assets/trinity-icon-128.png b/docs/assets/trinity-icon-128.png
new file mode 100644
index 0000000..b1667bf
Binary files /dev/null and b/docs/assets/trinity-icon-128.png differ
diff --git a/docs/assets/trinity-icon.png b/docs/assets/trinity-icon.png
new file mode 100644
index 0000000..a16e7e0
Binary files /dev/null and b/docs/assets/trinity-icon.png differ
diff --git a/docs/assets/wordmark-sm.svg b/docs/assets/wordmark-sm.svg
new file mode 100644
index 0000000..f3d66b3
--- /dev/null
+++ b/docs/assets/wordmark-sm.svg
@@ -0,0 +1,67 @@
+<!-- SPDX-FileCopyrightText: Sudo Apt Holdings LLC -->
+<!-- SPDX-License-Identifier: Apache-2.0 -->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 744 128" width="744" height="128" role="img" aria-label="TRINITY">
+  <title>TRINITY</title>
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#c2ff57"/>
+      <stop offset="45%" stop-color="#5ae62a"/>
+      <stop offset="100%" stop-color="#1f9c0d"/>
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-50%" width="140%" height="200%">
+      <feGaussianBlur stdDeviation="3.4" result="b"/>
+      <feMerge><feMergeNode in="b"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+  </defs>
+  <g filter="url(#glow)" fill="url(#g)">
+      <rect x="2" y="14" width="100" height="20"/>
+      <rect x="122" y="14" width="80" height="20"/>
+      <rect x="242" y="14" width="60" height="20"/>
+      <rect x="442" y="14" width="60" height="20"/>
+      <rect x="522" y="14" width="100" height="20"/>
+      <rect x="322" y="34" width="40" height="20"/>
+      <rect x="122" y="54" width="80" height="20"/>
+      <rect x="382" y="74" width="40" height="20"/>
+      <rect x="242" y="94" width="60" height="20"/>
+      <rect x="442" y="94" width="60" height="20"/>
+      <rect x="2" y="14" width="20" height="20"/>
+      <rect x="22" y="14" width="20" height="20"/>
+      <rect x="42" y="14" width="20" height="100"/>
+      <rect x="62" y="14" width="20" height="20"/>
+      <rect x="82" y="14" width="20" height="20"/>
+      <rect x="122" y="14" width="20" height="100"/>
+      <rect x="142" y="14" width="20" height="20"/>
+      <rect x="142" y="54" width="20" height="20"/>
+      <rect x="162" y="14" width="20" height="20"/>
+      <rect x="162" y="54" width="20" height="20"/>
+      <rect x="182" y="14" width="20" height="20"/>
+      <rect x="182" y="54" width="20" height="40"/>
+      <rect x="202" y="34" width="20" height="20"/>
+      <rect x="202" y="94" width="20" height="20"/>
+      <rect x="242" y="14" width="20" height="20"/>
+      <rect x="242" y="94" width="20" height="20"/>
+      <rect x="262" y="14" width="20" height="100"/>
+      <rect x="282" y="14" width="20" height="20"/>
+      <rect x="282" y="94" width="20" height="20"/>
+      <rect x="322" y="14" width="20" height="100"/>
+      <rect x="342" y="34" width="20" height="20"/>
+      <rect x="362" y="54" width="20" height="20"/>
+      <rect x="382" y="74" width="20" height="20"/>
+      <rect x="402" y="14" width="20" height="100"/>
+      <rect x="442" y="14" width="20" height="20"/>
+      <rect x="442" y="94" width="20" height="20"/>
+      <rect x="462" y="14" width="20" height="100"/>
+      <rect x="482" y="14" width="20" height="20"/>
+      <rect x="482" y="94" width="20" height="20"/>
+      <rect x="522" y="14" width="20" height="20"/>
+      <rect x="542" y="14" width="20" height="20"/>
+      <rect x="562" y="14" width="20" height="100"/>
+      <rect x="582" y="14" width="20" height="20"/>
+      <rect x="602" y="14" width="20" height="20"/>
+      <rect x="642" y="14" width="20" height="20"/>
+      <rect x="662" y="34" width="20" height="20"/>
+      <rect x="682" y="54" width="20" height="60"/>
+      <rect x="702" y="34" width="20" height="20"/>
+      <rect x="722" y="14" width="20" height="20"/>
+  </g>
+</svg>
diff --git a/docs/assets/wordmark.svg b/docs/assets/wordmark.svg
new file mode 100644
index 0000000..eb0002c
--- /dev/null
+++ b/docs/assets/wordmark.svg
@@ -0,0 +1,67 @@
+<!-- SPDX-FileCopyrightText: Sudo Apt Holdings LLC -->
+<!-- SPDX-License-Identifier: Apache-2.0 -->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 550 102" width="550" height="102" role="img" aria-label="TRINITY">
+  <title>TRINITY</title>
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#c2ff57"/>
+      <stop offset="45%" stop-color="#5ae62a"/>
+      <stop offset="100%" stop-color="#1f9c0d"/>
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-50%" width="140%" height="200%">
+      <feGaussianBlur stdDeviation="2.6" result="b"/>
+      <feMerge><feMergeNode in="b"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+  </defs>
+  <g filter="url(#glow)" fill="url(#g)">
+      <rect x="16" y="16" width="70" height="14"/>
+      <rect x="100" y="16" width="56" height="14"/>
+      <rect x="184" y="16" width="42" height="14"/>
+      <rect x="324" y="16" width="42" height="14"/>
+      <rect x="380" y="16" width="70" height="14"/>
+      <rect x="240" y="30" width="28" height="14"/>
+      <rect x="100" y="44" width="56" height="14"/>
+      <rect x="282" y="58" width="28" height="14"/>
+      <rect x="184" y="72" width="42" height="14"/>
+      <rect x="324" y="72" width="42" height="14"/>
+      <rect x="16" y="16" width="14" height="14"/>
+      <rect x="30" y="16" width="14" height="14"/>
+      <rect x="44" y="16" width="14" height="70"/>
+      <rect x="58" y="16" width="14" height="14"/>
+      <rect x="72" y="16" width="14" height="14"/>
+      <rect x="100" y="16" width="14" height="70"/>
+      <rect x="114" y="16" width="14" height="14"/>
+      <rect x="114" y="44" width="14" height="14"/>
+      <rect x="128" y="16" width="14" height="14"/>
+      <rect x="128" y="44" width="14" height="14"/>
+      <rect x="142" y="16" width="14" height="14"/>
+      <rect x="142" y="44" width="14" height="28"/>
+      <rect x="156" y="30" width="14" height="14"/>
+      <rect x="156" y="72" width="14" height="14"/>
+      <rect x="184" y="16" width="14" height="14"/>
+      <rect x="184" y="72" width="14" height="14"/>
+      <rect x="198" y="16" width="14" height="70"/>
+      <rect x="212" y="16" width="14" height="14"/>
+      <rect x="212" y="72" width="14" height="14"/>
+      <rect x="240" y="16" width="14" height="70"/>
+      <rect x="254" y="30" width="14" height="14"/>
+      <rect x="268" y="44" width="14" height="14"/>
+      <rect x="282" y="58" width="14" height="14"/>
+      <rect x="296" y="16" width="14" height="70"/>
+      <rect x="324" y="16" width="14" height="14"/>
+      <rect x="324" y="72" width="14" height="14"/>
+      <rect x="338" y="16" width="14" height="70"/>
+      <rect x="352" y="16" width="14" height="14"/>
+      <rect x="352" y="72" width="14" height="14"/>
+      <rect x="380" y="16" width="14" height="14"/>
+      <rect x="394" y="16" width="14" height="14"/>
+      <rect x="408" y="16" width="14" height="70"/>
+      <rect x="422" y="16" width="14" height="14"/>
+      <rect x="436" y="16" width="14" height="14"/>
+      <rect x="464" y="16" width="14" height="14"/>
+      <rect x="478" y="30" width="14" height="14"/>
+      <rect x="492" y="44" width="14" height="42"/>
+      <rect x="506" y="30" width="14" height="14"/>
+      <rect x="520" y="16" width="14" height="14"/>
+  </g>
+</svg>