diff --git a/README.md b/README.md
index 76c2e50..3a54c1e 100644
--- a/README.md
+++ b/README.md
@@ -55,6 +55,12 @@ tracer.py                    Logs traced variables to .mat files (for
                              offline analysis/tuning in MATLAB/Octave,
                              see results.m / results_tc.m).
 
+scripts/demos/               Standalone, eyeballed-plot demos (matplotlib)
+                             exercising components/* in isolation — pid/,
+                             plant/, and a full mash-schedule run in sud/.
+                             Not used at runtime; run directly, e.g.
+                             `python -m scripts.demos.sud.demo_sud`.
+
 sude/                        Mash schedules ("Sud" = brew/wort), each a
                              JSON list of temperature rests ("Rasten")
                              with target temperature, heat rate, and