diff --git a/README.md b/README.md
index 921ea6e8..2949ea45 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,8 @@ changes, and asks the team when the code cannot settle a choice.
 > production-ready service. Expect incomplete workflows, operational limits,
 > and breaking changes.
 
+![Chopin Overview](docs/images_videos/chopin-tour.mp4)
+
 ## What Chopin explores
 
 A channel combines one repository-connected document with its collaboration
@@ -28,12 +30,16 @@ context:
   separately from the prose they produced, so a later rewrite cannot silently
   change what the team decided.
 
+![Chopin Comments](docs/images_videos/chopin-comments.mp4)
+
 Typing `/research` in a document starts one durable request from the exact brief
 and leaves an inline progress card in place. Completed research publishes as an
 ordinary child document beneath its parent, with its own document,
 Chat, and Decisions. Pending, failed, and cancelled requests never
 appear as documents in navigation.
 
+![Chopin Research](docs/images_videos/chopin-research.mp4)
+
 The Planner can inspect the selected GitHub repository and its pull requests
 through bounded, read-only tools, then co-author the document. It cannot write to
 GitHub, edit a checkout, or implement code. A separate coding agent can connect
diff --git a/docs/images_videos/chopin-comments.mp4 b/docs/images_videos/chopin-comments.mp4
new file mode 100644
index 00000000..cb535d20
Binary files /dev/null and b/docs/images_videos/chopin-comments.mp4 differ
diff --git a/docs/images_videos/chopin-research.mp4 b/docs/images_videos/chopin-research.mp4
new file mode 100644
index 00000000..8af81608
Binary files /dev/null and b/docs/images_videos/chopin-research.mp4 differ
diff --git a/docs/images_videos/chopin-tour.mp4 b/docs/images_videos/chopin-tour.mp4
new file mode 100644
index 00000000..90df8be7
Binary files /dev/null and b/docs/images_videos/chopin-tour.mp4 differ