@@ -108,6 +108,14 @@ Each module has its own objectives, story-focused scenario, numbered instruction
 3. **Always include alt text.** Starlight treats the alt text as required.
 4. **Preview locally** to confirm the image resolves.
 
+### Add a tutorial video
+
+Keep videos optional and retain the written instructions. Add a `## Video walkthrough` section with a descriptive reference-style YouTube link and an HTML `<iframe>`; the link also serves readers on github.com, which does not render embedded players, and readers whose networks block YouTube.
+
+Use the privacy-enhanced URL `https://www.youtube-nocookie.com/embed/VIDEO_ID?cc_load_policy=1`, a descriptive `title`, `loading="lazy"`, `referrerpolicy="strict-origin-when-cross-origin"`, `allowfullscreen`, and `style="display: block; width: 100%; aspect-ratio: 16 / 9; border: 0;"`. Do not enable autoplay. Privacy-enhanced mode still contacts YouTube when the player loads; it is not a consent gate.
+
+Before publishing, confirm the video allows embedding and has accurate captions in YouTube Studio. The `cc_load_policy=1` parameter requests captions when available; it does not create them. Check playback on the rendered site and at a narrow viewport.
+
 ### Edit an existing lesson
 
 1. **Find the file** under `docs/` (use the published URL as a hint — `/real-world-development/cli/3-agent-modes/` lives at `docs/real-world-development/cli/3-agent-modes.md`).
 
@@ -13,6 +13,12 @@ next:
 
 This optional journey adds a **Backer Concierge** to Tailspin Toys using Microsoft Foundry Canvas in the GitHub Copilot app. It moves from a catalog-grounded model experiment to a hosted agent and then a local website integration.
 
+## Video walkthrough
+
+Follow the [Copilot app and Foundry Canvas video walkthrough on YouTube][video-walkthrough] alongside the written modules below. You can also use that link if the embedded player is unavailable.
+
+<iframe src="https://www.youtube-nocookie.com/embed/AT3EltQ4gTM?cc_load_policy=1" title="Video walkthrough: Build a Backer Concierge with the Copilot app and Microsoft Foundry Canvas" loading="lazy" referrerpolicy="strict-origin-when-cross-origin" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen style="display: block; width: 100%; aspect-ratio: 16 / 9; border: 0;"></iframe>
+
 ## The journey
 
 Each module ends with a checkpoint and a safe stopping point. The same Tailspin Toys repository, worktree branch, issue-linked session, Foundry project, and model deployment carry through the journey.
@@ -83,6 +89,7 @@ The Microsoft documentation describes Canvas, hosted deployments, and their perm
 [module-2]: ./2-build-and-deploy/
 [module-3]: ./3-connect-to-site/
 [core-review]: ../10-review/
+[video-walkthrough]: https://www.youtube.com/watch?v=AT3EltQ4gTM
 [foundry-canvas]: https://learn.microsoft.com/azure/foundry/agents/concepts/foundry-canvas
 [hosted-agent-quickstart]: https://learn.microsoft.com/azure/foundry/agents/quickstarts/quickstart-hosted-agent?pivots=canvas
 [hosted-agent-permissions]: https://learn.microsoft.com/azure/foundry/agents/concepts/hosted-agent-permissions
@@ -15,6 +15,12 @@ In this series, you will:
 - scaffold, test, and deploy a hosted Backer Concierge agent.
 - connect the agent to the website through a local server-side proxy and chat widget.
 
+## Video walkthrough
+
+Follow the [Copilot CLI and Foundry video walkthrough on YouTube][video-walkthrough] alongside the written modules below. You can also use that link if the embedded player is unavailable.
+
+<iframe src="https://www.youtube-nocookie.com/embed/l37ZnSjKRxo?cc_load_policy=1" title="Video walkthrough: Build a Backer Concierge with Copilot CLI and Microsoft Foundry" loading="lazy" referrerpolicy="strict-origin-when-cross-origin" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen style="display: block; width: 100%; aspect-ratio: 16 / 9; border: 0;"></iframe>
+
 ## Scenario
 
 Tailspin Toys backers can browse games by category and publisher, but those filters don't help everyone find their next game. Some backers have questions such as *Which games would suit someone who loves Git puns?* Those questions don't have dropdown answers.
@@ -76,6 +82,7 @@ When you're done experimenting at any checkpoint, remove the Azure resources to
 [connect-site]: 3-connect-to-site/
 [review]: ../10-review/
 [cleanup]: #clean-up-your-resources
+[video-walkthrough]: https://www.youtube.com/watch?v=l37ZnSjKRxo
 [azure-skills]: https://github.com/microsoft/azure-skills#github-copilot-cli
 [foundry-skill]: https://learn.microsoft.com/azure/foundry/how-to/develop/use-microsoft-foundry-skill?tabs=copilot-cli
 [hosted-agent-quickstart]: https://learn.microsoft.com/azure/foundry/agents/quickstarts/quickstart-hosted-agent?pivots=foundry-skills
 
@@ -12,6 +12,12 @@ lastUpdated: 2026-09-16
 
 The required VS Code harness is complete after Exercise 6. This optional extension uses GitHub Copilot Chat and Microsoft Foundry Toolkit in VS Code to turn the Tailspin catalog into a Backer Concierge, deploy it as a hosted agent, and connect it to the site through a local proxy.
 
+## Video walkthrough
+
+Follow the [VS Code and Foundry Toolkit video walkthrough on YouTube][video-walkthrough] alongside the written modules below. You can also use that link if the embedded player is unavailable.
+
+<iframe src="https://www.youtube-nocookie.com/embed/rfBulzrp5wY?cc_load_policy=1" title="Video walkthrough: Build a Backer Concierge with VS Code and Microsoft Foundry Toolkit" loading="lazy" referrerpolicy="strict-origin-when-cross-origin" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen style="display: block; width: 100%; aspect-ratio: 16 / 9; border: 0;"></iframe>
+
 ## Scenario
 
 Backers ask questions that filters cannot answer: which game suits someone who loves git puns, or what makes one puzzle game a better fit than another? Tailspin Toys needs a concierge that recommends real catalog titles, asks a clarifying question when needed, and earns trust by admitting when funding numbers or other facts are unavailable.
@@ -93,5 +99,6 @@ When you're done experimenting at any checkpoint, remove the Azure resources to
 [module-2]: 2-build-and-deploy/
 [module-3]: 3-connect-to-site/
 [cleanup]: #clean-up-your-resources
+[video-walkthrough]: https://www.youtube.com/watch?v=rfBulzrp5wY
 [foundry-toolkit]: https://code.visualstudio.com/docs/intelligentapps/overview
 [foundry-extension]: https://learn.microsoft.com/azure/developer/azure-developer-cli/extensions/azure-ai-foundry-extension