diff --git a/README.md b/README.md
index f7ada58..12ca82b 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,10 @@ steplock sits on top of the [polyhook](https://github.com/tupe12334/polyhook) SD
 
 **[Installation →](Installation.md)** · **[Architecture →](Architecture.md)** · **[Contributing →](CONTRIBUTING.md)**
 
+[![Watch how steplock works: the agent runs git push, steplock blocks it and asks "Did you run the tests?"](docs/media/steplock-explained-poster.png)](docs/media/steplock-explained.mp4)
+
+▶ **[Watch: how steplock works](docs/media/steplock-explained.mp4)** (1.5 min, narrated, with subtitles)
+
 ---
 
 ## The Problem
diff --git a/docs/media/steplock-explained-poster.png b/docs/media/steplock-explained-poster.png
new file mode 100644
index 0000000..04aa803
Binary files /dev/null and b/docs/media/steplock-explained-poster.png differ
diff --git a/docs/media/steplock-explained.mp4 b/docs/media/steplock-explained.mp4
new file mode 100644
index 0000000..0bf85f5
Binary files /dev/null and b/docs/media/steplock-explained.mp4 differ