EXPLAINER TITLE

What this is: one-paragraph summary of what the explainer covers and who it's for.
Repo: github.com/OWNER/REPO

TL;DR. One-paragraph punchline that someone could quote back without reading the rest of the page.

The problem

Describe the problem in plain language. Lead with a concrete situation — "you have X, you need Y, but Z doesn't work." Avoid abstract framing until you've grounded the reader in something real.

The answer

Walk through the insight. Every paragraph should either introduce a concept, name a mechanism, or show a concrete example.

Aha. The single sentence the reader should take away from this section.

Scenarios

Embedded transcripts from reproducible scripts in scripts/. Each <details> block shows one scenario, fetched at load time from transcripts/NN-name.txt so the page stays authoritative after you rerun the scripts.

1. Scenario name — what it shows

One-sentence description of what the scenario demonstrates.

Loading…

Running the scenarios yourself

git clone https://github.com/OWNER/REPO.git
cd REPO
./scripts/run-all.sh                 # generates transcripts/

Research notes

findings.md — the full writeup from the research session that preceded this page
mental-model.md — one-page cheat sheet for someone who already knows a related concept