docs: add sanitized Huddle demo recording

README.md

@@ -8,6 +8,20 @@ The portfolio demo is deliberately narrow: sign in, upload one fixed CSV, valida
 refresh, inspect the ranked Evidence Desk, expand one exact-evidence disclosure, and see the report
 acknowledged. It is not a diagnosis product and makes **no accuracy claim**.
 
+## Demo
+
+[![Silent synthetic Huddle walkthrough: ranked attention queue, import and refresh, then a teacher conversation plan](docs/demo/huddle-workflow.gif)](docs/demo/huddle-workflow.gif)
+
+*25-second silent walkthrough using only synthetic data: the attention queue, import/refresh, and one
+student report with teacher action guidance.* [Open the GIF](docs/demo/huddle-workflow.gif) ·
+[MP4 fallback](docs/demo/huddle-workflow.mp4) ·
+[Try the live reviewer demo](https://huddle-tsa-portfolio-demo.vercel.app)
+
+![Synthetic Huddle Evidence Desk showing the ranked attention queue and one AI-assisted conversation plan](docs/demo/huddle-evidence-desk.png)
+
+*Static synthetic-data detail: one ranked report with likely explanation, opening question,
+confident/struggling branches, listen-for cue, and suggested teaching move.*
+
 ## Why this is useful at TSA
 
 - **Guide utility:** one deterministic queue turns attempt-level activity into a short morning plan.