Problem
A new reader can grok what gates exist (HARNESS.md inventories them) but has no quick experiential path to feel them working. The "harness IS the product" claim is asserted, not demonstrated.
Proposed solution
Add DEMO.md at the repo root with a ~60-second walkthrough:
- Clone + bootstrap (link to DEVELOPMENT.md, don't duplicate).
- Add a deliberately bad change (e.g. a reverse import from
tools to models, or an untyped public function).
- Run
just check (or push a branch) and show the exact gate output that catches it.
- Fix the change, re-run, show green.
Keep prose minimal — code blocks and a short caption per step.
Acceptance criteria
Priority rationale
Polish — turns the harness story from an assertion into something a reader can run in a minute.
Problem
A new reader can grok what gates exist (HARNESS.md inventories them) but has no quick experiential path to feel them working. The "harness IS the product" claim is asserted, not demonstrated.
Proposed solution
Add
DEMO.mdat the repo root with a ~60-second walkthrough:toolstomodels, or an untyped public function).just check(or push a branch) and show the exact gate output that catches it.Keep prose minimal — code blocks and a short caption per step.
Acceptance criteria
DEMO.mdexists at repo rootPriority rationale
Polish — turns the harness story from an assertion into something a reader can run in a minute.