diff --git a/README.md b/README.md
index 590fd6d..11dbf16 100644
--- a/README.md
+++ b/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.
diff --git a/docs/demo/huddle-evidence-desk.png b/docs/demo/huddle-evidence-desk.png
new file mode 100644
index 0000000..4472928
Binary files /dev/null and b/docs/demo/huddle-evidence-desk.png differ
diff --git a/docs/demo/huddle-workflow.gif b/docs/demo/huddle-workflow.gif
new file mode 100644
index 0000000..038e14e
Binary files /dev/null and b/docs/demo/huddle-workflow.gif differ
diff --git a/docs/demo/huddle-workflow.mp4 b/docs/demo/huddle-workflow.mp4
new file mode 100644
index 0000000..3a067f8
Binary files /dev/null and b/docs/demo/huddle-workflow.mp4 differ