From bf4a04cb44f5f9aaae7b09ba704f9123e96d1590 Mon Sep 17 00:00:00 2001
From: Kiliaan Vanvoorden <kiliaanv2@gmail.com>
Date: Sun, 11 Oct 2026 13:23:48 +0200
Subject: [PATCH] docs: add terminal demo recording to README

Animated SVG showing harness scan detecting stacks, CI, protected paths,
and computing agent-readiness score. Recorded with asciinema, converted
to SVG.
---
 README.md     | 4 ++++
 docs/demo.svg | 1 +
 2 files changed, 5 insertions(+)
 create mode 100644 docs/demo.svg

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