diff --git a/CHANGELOG.md b/CHANGELOG.md
index 38801d5..80c6f41 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,6 +15,10 @@ per-file diff commands.
 
 ### Added
 
+- **README: video walkthrough link in Quick start** - The Next New Thing's hands-on
+  walkthrough of the workflow (recorded August 2026), for newcomers who want to see the
+  setup-to-application flow before reading. Docs only.
+
 - **Spec-pinning tests for the Language Gate's `/rank` contract** (#278) - four regression
   guards in `tests/test_rank_command.py` pinning the `language_gate`/`language_note` fields
   through Steps 2-5 of `/rank`, including the Step 4 persistence rule that was live-debugged
diff --git a/README.md b/README.md
index 2cf4338..cfff5fe 100644
--- a/README.md
+++ b/README.md
@@ -69,6 +69,8 @@ The framework encodes career guidance best practices, including structured evalu
 
 ## Quick start
 
+> 🎥 **Prefer to see it in action first?** [The Next New Thing did a hands-on walkthrough](https://www.youtube.com/watch?v=HoVxjMNFYv4) of how the workflow is actually used, from setup to a finished application (recorded August 2026 - commands may have evolved since).
+
 ### 1. Fork and clone
 
 ```bash