githubnext · Krzysztof-Cieslak · Sep 2, 2026 · Sep 2, 2026
diff --git 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
diff --git a/docs/images_videos/chopin-research.mp4 b/docs/images_videos/chopin-research.mp4
diff --git a/docs/images_videos/chopin-tour.mp4 b/docs/images_videos/chopin-tour.mp4