diff --git a/README.md b/README.md
index 6b44407..99873a7 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,10 @@ agentic dev environment. Agents that run through Harness complete tasks with
 measurably higher accuracy because every write is scoped, every claim is gated,
 and nothing ships until an independent reviewer passes it.
 
+## Demo
+
+![Harness scan](docs/demo.svg)
+
 ## The problem
 
 AI coding agents produce plausible-looking code that passes CI but violates
diff --git a/docs/demo.svg b/docs/demo.svg
new file mode 100644
index 0000000..11a39d1
--- /dev/null
+++ b/docs/demo.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="840" height="581.04"><rect width="840" height="581.04" rx="5" ry="5" class="a"/><svg y="0%" x="0%"><circle cx="20" cy="20" r="6" fill="#ff5f58"/><circle cx="40" cy="20" r="6" fill="#ffbd2e"/><circle cx="60" cy="20" r="6" fill="#18c132"/></svg><svg height="521.04" viewBox="0 0 80 52.104" width="800" x="15" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" y="50"><style>@keyframes l{0%{transform:translateX(0)}1.5%{transform:translateX(-160px)}27.7%{transform:translateX(-240px)}34.3%{transform:translateX(-320px)}38.7%{transform:translateX(-400px)}43.1%{transform:translateX(-480px)}47.5%{transform:translateX(-560px)}51.9%{transform:translateX(-640px)}58.5%{transform:translateX(-720px)}65.1%{transform:translateX(-800px)}78.2%{transform:translateX(-880px)}to{transform:translateX(-960px)}}.a{fill:#282d35}.g,.h,.i{fill:#b9c0cb;white-space:pre}.h,.i{font-weight:700}.i{fill:#a8cc8c}</style><g font-family="Monaco,Consolas,Menlo,'Bitstream Vera Sans Mono','Powerline Symbols',monospace" font-size="1.67"><defs><symbol id="1"><text y="1.67" style="white-space:pre" fill="#66c2cd" font-weight="700">harness</text><text x="8.016" y="1.67" class="g">—</text><text x="10.02" y="1.67" class="g">local-first</text><text x="22.044" y="1.67" class="g">control</text><text x="30.06" y="1.67" class="g">plane</text><text x="36.072" y="1.67" class="g">for</text><text x="40.08" y="1.67" class="g">governed</text><text x="49.098" y="1.67" class="g">agentic</text><text x="57.114" y="1.67" class="g">dev</text></symbol><symbol id="2"><text y="1.67" class="g">Scanning</text><text x="9.018" y="1.67" class="g">a</text><text x="11.022" y="1.67" class="g">repo</text><text x="16.032" y="1.67" class="g">for</text><text x="20.04" y="1.67" class="g">agent-readiness...</text></symbol><symbol id="3"><text y="1.67" class="h">Stacks</text><text x="11.022" y="1.67" class="g">:</text><text x="13.026" y="1.67" class="g">python</text></symbol><symbol id="4"><text x="2.004" y="1.67" class="g">typecheck</text><text x="12.024" y="1.67" class="g">:</text><text x="14.028" y="1.67" class="g">mypy</text><text x="19.038" y="1.67" class="g">.</text></symbol><symbol id="5"><text x="2.004" y="1.67" class="g">lint</text><text x="12.024" y="1.67" class="g">:</text><text x="14.028" y="1.67" class="g">ruff</text><text x="19.038" y="1.67" class="g">check</text><text x="25.05" y="1.67" class="g">.</text></symbol><symbol id="6"><text x="2.004" y="1.67" class="g">unit</text><text x="12.024" y="1.67" class="g">:</text><text x="14.028" y="1.67" class="g">python3</text><text x="22.044" y="1.67" class="g">-m</text><text x="25.05" y="1.67" class="g">pytest</text><text x="32.064" y="1.67" class="g">-q</text></symbol><symbol id="7"><text x="2.004" y="1.67" class="g">build</text><text x="12.024" y="1.67" class="g">:</text><text x="14.028" y="1.67" class="g">-</text></symbol><symbol id="8"><text x="2.004" y="1.67" class="g">e2e</text><text x="12.024" y="1.67" class="g">:</text><text x="14.028" y="1.67" class="g">-</text></symbol><symbol id="9"><text y="1.67" class="h">CI</text><text x="11.022" y="1.67" class="g">:</text><text x="13.026" y="1.67" class="g">harness.yml,</text><text x="26.052" y="1.67" class="g">publish.yml</text></symbol><symbol id="10"><text y="1.67" class="h">Protected</text><text x="11.022" y="1.67" class="g">:</text><text x="13.026" y="1.67" class="g">.env*,</text><text x="20.04" y="1.67" class="g">*.pem,</text><text x="27.054" y="1.67" class="g">id_rsa*,</text><text x="36.072" y="1.67" class="g">secrets/**,</text><text x="48.096" y="1.67" class="g">.github/workflows/**</text></symbol><symbol id="11"><text y="1.67" class="i">Agent-readiness:</text><text x="17.034" y="1.67" class="i">80/100</text></symbol><symbol id="a"><path fill="transparent" d="M0 0h80v24H0z"/></symbol><symbol id="b"><path fill="#6f7683" d="M0 0h1.102v2.171H0z"/></symbol></defs><path class="a" d="M0 0h80v52.104H0z"/><g style="animation-duration:2.296129s;animation-iteration-count:infinite;animation-name:l;animation-timing-function:steps(1,end)"><svg width="1040"><svg><use xlink:href="#a"/><use xlink:href="#b" x="-.004"/></svg><svg x="80"><use xlink:href="#a"/><use xlink:href="#b" x="-.004"/></svg><svg x="160"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="6.488"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/></svg><svg x="240"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="8.659"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/></svg><svg x="320"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="10.83"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/><use xlink:href="#4" y="8.684"/></svg><svg x="400"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="13.001"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/><use xlink:href="#4" y="8.684"/><use xlink:href="#5" y="10.855"/></svg><svg x="480"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="15.172"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/><use xlink:href="#4" y="8.684"/><use xlink:href="#5" y="10.855"/><use xlink:href="#6" y="13.026"/></svg><svg x="560"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="17.343"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/><use xlink:href="#4" y="8.684"/><use xlink:href="#5" y="10.855"/><use xlink:href="#6" y="13.026"/><use xlink:href="#7" y="15.197"/></svg><svg x="640"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="19.514"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/><use xlink:href="#4" y="8.684"/><use xlink:href="#5" y="10.855"/><use xlink:href="#6" y="13.026"/><use xlink:href="#7" y="15.197"/><use xlink:href="#8" y="17.368"/></svg><svg x="720"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="21.685"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/><use xlink:href="#4" y="8.684"/><use xlink:href="#5" y="10.855"/><use xlink:href="#6" y="13.026"/><use xlink:href="#7" y="15.197"/><use xlink:href="#8" y="17.368"/><use xlink:href="#9" y="19.539"/></svg><svg x="800"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="23.856"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/><use xlink:href="#4" y="8.684"/><use xlink:href="#5" y="10.855"/><use xlink:href="#6" y="13.026"/><use xlink:href="#7" y="15.197"/><use xlink:href="#8" y="17.368"/><use xlink:href="#9" y="19.539"/><use xlink:href="#10" y="21.71"/></svg><svg x="880"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="28.198"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/><use xlink:href="#4" y="8.684"/><use xlink:href="#5" y="10.855"/><use xlink:href="#6" y="13.026"/><use xlink:href="#7" y="15.197"/><use xlink:href="#8" y="17.368"/><use xlink:href="#9" y="19.539"/><use xlink:href="#10" y="21.71"/><use xlink:href="#11" y="26.052"/></svg><svg x="960"><use xlink:href="#a"/><use xlink:href="#b" x="-.004" y="32.54"/><use xlink:href="#1"/><use xlink:href="#2" y="2.171"/><use xlink:href="#3" y="6.513"/><use xlink:href="#4" y="8.684"/><use xlink:href="#5" y="10.855"/><use xlink:href="#6" y="13.026"/><use xlink:href="#7" y="15.197"/><use xlink:href="#8" y="17.368"/><use xlink:href="#9" y="19.539"/><use xlink:href="#10" y="21.71"/><use xlink:href="#11" y="26.052"/><text y="32.064" class="g">#</text><text x="2.004" y="32.064" class="g">Next:</text><text x="8.016" y="32.064" class="g">harness</text><text x="16.032" y="32.064" class="g">init</text><text x="21.042" y="32.064" class="g">→</text><text x="23.046" y="32.064" class="g">harness</text><text x="31.062" y="32.064" class="g">task</text><text x="36.072" y="32.064" class="g">start</text><text x="42.084" y="32.064" class="g">→</text><text x="44.088" y="32.064" class="g">harness</text><text x="52.104" y="32.064" class="g">task</text><text x="57.114" y="32.064" class="g">run</text><text x="61.122" y="32.064" class="g">→</text><text x="63.126" y="32.064" class="g">harness</text><text x="71.142" y="32.064" class="g">verify</text></svg></svg></g></g></svg></svg>
\ No newline at end of file