juliamuiruri4 · Nov 2, 2026 · Nov 2, 2026 · Nov 2, 2026 · Nov 2, 2026
diff --git a/AUTHORING.md b/AUTHORING.md
@@ -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`).

diff --git a/docs/es-es/real-world-development/app/8-foundry-canvas/README.md b/docs/es-es/real-world-development/app/8-foundry-canvas/README.md
@@ -13,6 +13,12 @@ next:
 
 Este recorrido opcional añade un **Backer Concierge** a Tailspin Toys mediante Microsoft Foundry Canvas en la aplicación GitHub Copilot. Parte de un experimento con un modelo basado en el catálogo, continúa con un agente hospedado y termina con una integración local en el sitio web.
 
+## Tutorial en vídeo
+
+Sigue el [tutorial en vídeo de la aplicación GitHub Copilot y Foundry Canvas en YouTube][video-walkthrough] junto con los módulos escritos que aparecen a continuación.
+
+<iframe src="https://www.youtube-nocookie.com/embed/AT3EltQ4gTM?cc_load_policy=1" title="Tutorial en vídeo: crea un Backer Concierge con la aplicación GitHub Copilot y 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>
+
 ## El recorrido
 
 Cada módulo termina con un punto de control y un punto seguro para detenerte. Durante todo el recorrido se mantienen el mismo repositorio de Tailspin Toys, la misma rama del worktree, la misma sesión vinculada a la incidencia, el mismo proyecto de Foundry y la misma implementación del modelo.
@@ -86,3 +92,4 @@ La documentación de Microsoft describe Canvas, las implementaciones hospedadas
 [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
+[video-walkthrough]: https://www.youtube.com/watch?v=AT3EltQ4gTM
diff --git a/docs/es-es/real-world-development/cli/8-foundry-agent/README.md b/docs/es-es/real-world-development/cli/8-foundry-agent/README.md
@@ -15,6 +15,12 @@ En esta serie:
 - generarás la estructura de un agente Backer Concierge hospedado, lo probarás y lo desplegarás.
 - conectarás el agente al sitio web mediante un proxy local del lado del servidor y un widget de chat.
 
+## Tutorial en vídeo
+
+Sigue el [tutorial en vídeo de Copilot CLI y Foundry en YouTube][video-walkthrough] junto con los módulos escritos que aparecen a continuación.
+
+<iframe src="https://www.youtube-nocookie.com/embed/l37ZnSjKRxo?cc_load_policy=1" title="Tutorial en vídeo: crea un Backer Concierge con Copilot CLI y 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>
+
 ## Escenario
 
 Quienes apoyan los juegos de Tailspin Toys pueden explorarlos por categoría y editorial, pero esos filtros no ayudan a todo el mundo a encontrar su próximo juego. Algunas personas tienen preguntas como *¿Qué juegos serían adecuados para alguien a quien le encantan los juegos de palabras sobre Git?* Esas preguntas no se responden con un menú desplegable.
@@ -80,3 +86,4 @@ Cuando termines de experimentar en cualquiera de los puntos de comprobación, el
 [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
 [hosted-agent-permissions]: https://learn.microsoft.com/azure/foundry/agents/concepts/hosted-agent-permissions
+[video-walkthrough]: https://www.youtube.com/watch?v=l37ZnSjKRxo
diff --git a/docs/es-es/real-world-development/vscode/7-foundry-toolkit/README.md b/docs/es-es/real-world-development/vscode/7-foundry-toolkit/README.md
@@ -12,6 +12,12 @@ lastUpdated: 2026-09-16
 
 El itinerario obligatorio de VS Code termina con el ejercicio 6. Esta ampliación opcional utiliza GitHub Copilot Chat y Microsoft Foundry Toolkit en VS Code para convertir el catálogo de Tailspin en un Backer Concierge, implementarlo como agente hospedado y conectarlo al sitio a través de un proxy local.
 
+## Tutorial en vídeo
+
+Sigue el [tutorial en vídeo de VS Code y Foundry Toolkit en YouTube][video-walkthrough] junto con los módulos escritos que aparecen a continuación.
+
+<iframe src="https://www.youtube-nocookie.com/embed/rfBulzrp5wY?cc_load_policy=1" title="Tutorial en vídeo: crea un Backer Concierge con VS Code y 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>
+
 ## Escenario
 
 Los patrocinadores hacen preguntas que los filtros no pueden responder: ¿qué juego encaja con alguien a quien le encantan los juegos de palabras sobre git, o qué hace que un juego de puzles sea más adecuado que otro? Tailspin Toys necesita un asistente que recomiende títulos reales del catálogo, haga una pregunta aclaratoria cuando sea necesario y se gane la confianza de los usuarios al reconocer que las cifras de financiación u otros datos no están disponibles.
@@ -95,3 +101,4 @@ Cuando termines de experimentar en cualquier punto de control, elimina los recur
 [cleanup]: #eliminar-los-recursos
 [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
+[video-walkthrough]: https://www.youtube.com/watch?v=rfBulzrp5wY
diff --git a/docs/ja-jp/real-world-development/app/8-foundry-canvas/README.md b/docs/ja-jp/real-world-development/app/8-foundry-canvas/README.md
@@ -13,6 +13,12 @@ next:
 
 このオプションの学習では、GitHub Copilot app の Microsoft Foundry Canvas を使い、Tailspin Toys に **Backer Concierge** を追加します。カタログに基づくモデルの実験から始め、ホステッド エージェントの構築、ローカル Web サイトへの統合へと進みます。
 
+## 動画チュートリアル
+
+以下の各モジュールの手順と合わせて、[GitHub Copilot app と Foundry Canvas の動画チュートリアル（YouTube）][video-walkthrough]をご覧ください。
+
+<iframe src="https://www.youtube-nocookie.com/embed/AT3EltQ4gTM?cc_load_policy=1" title="動画チュートリアル: GitHub Copilot app と Microsoft Foundry Canvas で Backer Concierge を構築する" 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>
+
 ## 学習の流れ
 
 各モジュールの最後にはチェックポイントがあり、安全に中断できます。学習全体を通じて、同じ Tailspin Toys リポジトリ、worktree ブランチ、Issue にリンクされたセッション、Foundry プロジェクト、モデルデプロイを使用します。
@@ -86,3 +92,4 @@ Microsoft のドキュメントで、Canvas、ホステッド エージェント
 [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
+[video-walkthrough]: https://www.youtube.com/watch?v=AT3EltQ4gTM
diff --git a/docs/ja-jp/real-world-development/cli/8-foundry-agent/README.md b/docs/ja-jp/real-world-development/cli/8-foundry-agent/README.md
@@ -15,6 +15,12 @@ lastUpdated: 2026-09-16
 - ホスト型の Backer Concierge エージェントのひな形を作成し、テストしてデプロイする。
 - ローカルのサーバー側プロキシとチャット ウィジェットを通じて、エージェントを Web サイトに接続する。
 
+## 動画チュートリアル
+
+以下の各モジュールの手順と合わせて、[Copilot CLI と Foundry の動画チュートリアル（YouTube）][video-walkthrough]をご覧ください。
+
+<iframe src="https://www.youtube-nocookie.com/embed/l37ZnSjKRxo?cc_load_policy=1" title="動画チュートリアル: Copilot CLI と Microsoft Foundry で Backer Concierge を構築する" 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>
+
 ## シナリオ
 
 Tailspin Toys の支援者はカテゴリやパブリッシャーでゲームを探せますが、それらのフィルターだけでは、誰もが次に遊ぶゲームを見つけられるとは限りません。たとえば、*Git の言葉遊びが好きな人には、どのゲームが向いているだろう？*と考える支援者もいます。こうした質問には、ドロップダウンの選択肢だけでは答えられません。
@@ -80,3 +86,4 @@ Tailspin Toys は、会話を通じて支援者がゲームを見つけられる
 [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
 [hosted-agent-permissions]: https://learn.microsoft.com/azure/foundry/agents/concepts/hosted-agent-permissions
+[video-walkthrough]: https://www.youtube.com/watch?v=l37ZnSjKRxo
diff --git a/docs/ja-jp/real-world-development/vscode/7-foundry-toolkit/README.md b/docs/ja-jp/real-world-development/vscode/7-foundry-toolkit/README.md
@@ -12,6 +12,12 @@ lastUpdated: 2026-09-16
 
 必須の VS Code コースは演習 6 で完了です。この省略可能な拡張演習では、VS Code の GitHub Copilot Chat と Microsoft Foundry Toolkit を使って Tailspin のカタログを Backer Concierge に活用し、ホスト型エージェントとしてデプロイして、ローカルプロキシ経由でサイトに接続します。
 
+## 動画チュートリアル
+
+以下の各モジュールの手順と合わせて、[VS Code と Foundry Toolkit の動画チュートリアル（YouTube）][video-walkthrough]をご覧ください。
+
+<iframe src="https://www.youtube-nocookie.com/embed/rfBulzrp5wY?cc_load_policy=1" title="動画チュートリアル: VS Code と Microsoft Foundry Toolkit で Backer Concierge を構築する" 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>
+
 ## シナリオ
 
 支援者からは、フィルターでは答えられない質問が寄せられます。git の言葉遊びが好きな人に合うゲームはどれか、あるパズルゲームが別のゲームより自分に向いている理由は何か、といった質問です。Tailspin Toys には、カタログに実在するタイトルを勧め、必要に応じて確認の質問をし、資金調達額などの情報がないときはそのことを率直に伝えて信頼を得るコンシェルジュが必要です。
@@ -95,3 +101,4 @@ lastUpdated: 2026-09-16
 [cleanup]: #リソースをクリーンアップする
 [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
+[video-walkthrough]: https://www.youtube.com/watch?v=rfBulzrp5wY
diff --git a/docs/ko-kr/real-world-development/app/8-foundry-canvas/README.md b/docs/ko-kr/real-world-development/app/8-foundry-canvas/README.md
@@ -13,6 +13,12 @@ next:
 
 이 선택 실습 과정에서는 GitHub Copilot app의 Microsoft Foundry Canvas를 사용하여 Tailspin Toys에 **Backer Concierge**를 추가합니다. 카탈로그에 근거한 모델 실험으로 시작하여 호스팅 에이전트를 구축한 다음 로컬 웹사이트에 통합합니다.
 
+## 동영상 안내
+
+아래 문서 모듈과 함께 [GitHub Copilot app 및 Foundry Canvas YouTube 동영상 안내][video-walkthrough]를 따라 진행합니다.
+
+<iframe src="https://www.youtube-nocookie.com/embed/AT3EltQ4gTM?cc_load_policy=1" title="동영상 안내: GitHub Copilot app 및 Microsoft Foundry Canvas로 Backer Concierge 구축하기" 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>
+
 ## 실습 과정
 
 각 모듈은 체크포인트와 안전하게 작업을 마칠 수 있는 지점으로 끝납니다. 전체 과정에서 동일한 Tailspin Toys 리포지토리, 워크트리(Worktree) 브랜치, 이슈에 연결된 세션, Foundry 프로젝트, 모델 배포를 계속 사용합니다.
@@ -86,3 +92,4 @@ Microsoft 문서에서는 Canvas, 호스팅 배포, 관련 권한을 설명합
 [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
+[video-walkthrough]: https://www.youtube.com/watch?v=AT3EltQ4gTM
diff --git a/docs/ko-kr/real-world-development/cli/8-foundry-agent/README.md b/docs/ko-kr/real-world-development/cli/8-foundry-agent/README.md
@@ -15,6 +15,12 @@ lastUpdated: 2026-09-16
 - 호스트된 Backer Concierge 에이전트를 스캐폴드(Scaffold)하고 테스트 및 배포합니다.
 - 로컬 서버 측 프록시(Proxy)와 채팅 위젯을 통해 에이전트를 웹사이트에 연결합니다.
 
+## 동영상 안내
+
+아래 문서 모듈과 함께 [Copilot CLI 및 Foundry YouTube 동영상 안내][video-walkthrough]를 따라 진행합니다.
+
+<iframe src="https://www.youtube-nocookie.com/embed/l37ZnSjKRxo?cc_load_policy=1" title="동영상 안내: Copilot CLI 및 Microsoft Foundry로 Backer Concierge 구축하기" 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>
+
 ## 시나리오
 
 Tailspin Toys의 후원자는 카테고리와 퍼블리셔별로 게임을 탐색할 수 있지만, 이러한 필터만으로는 모든 후원자가 다음에 즐길 게임을 찾기 어렵습니다. *Git 말장난을 좋아하는 사람에게는 어떤 게임이 어울릴까요?* 같은 질문을 하는 후원자도 있습니다. 이런 질문에는 드롭다운으로 답할 수 없습니다.
@@ -80,3 +86,4 @@ Tailspin Toys는 후원자가 대화를 통해 게임을 찾도록 돕는 **Back
 [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
 [hosted-agent-permissions]: https://learn.microsoft.com/azure/foundry/agents/concepts/hosted-agent-permissions
+[video-walkthrough]: https://www.youtube.com/watch?v=l37ZnSjKRxo
diff --git a/docs/ko-kr/real-world-development/vscode/7-foundry-toolkit/README.md b/docs/ko-kr/real-world-development/vscode/7-foundry-toolkit/README.md
@@ -12,6 +12,12 @@ lastUpdated: 2026-09-16
 
 필수 VS Code 과정은 실습 6에서 완료됩니다. 이 선택 확장 과정에서는 VS Code의 GitHub Copilot Chat과 Microsoft Foundry Toolkit을 사용하여 Tailspin 카탈로그를 기반으로 Backer Concierge를 만들고, 호스팅 에이전트(Hosted agent)로 배포한 뒤 로컬 프록시(Proxy)를 통해 사이트에 연결합니다.
 
+## 동영상 안내
+
+아래 문서 모듈과 함께 [VS Code 및 Foundry Toolkit YouTube 동영상 안내][video-walkthrough]를 따라 진행합니다.
+
+<iframe src="https://www.youtube-nocookie.com/embed/rfBulzrp5wY?cc_load_policy=1" title="동영상 안내: VS Code 및 Microsoft Foundry Toolkit으로 Backer Concierge 구축하기" 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>
+
 ## 시나리오
 
 후원자는 필터만으로는 답할 수 없는 질문을 합니다. git 말장난을 좋아하는 사람에게 어떤 게임이 어울리는지, 특정 퍼즐 게임이 다른 게임보다 더 잘 맞는 이유는 무엇인지 궁금해합니다. Tailspin Toys에는 실제 카탈로그의 게임을 추천하고, 필요할 때 명확히 하기 위한 질문을 하며, 모금액이나 기타 정보를 알 수 없을 때 이를 솔직히 인정하여 신뢰를 얻는 안내 도우미가 필요합니다.
@@ -95,3 +101,4 @@ lastUpdated: 2026-09-16
 [cleanup]: #리소스-정리
 [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
+[video-walkthrough]: https://www.youtube.com/watch?v=rfBulzrp5wY
diff --git a/docs/pt-br/real-world-development/app/8-foundry-canvas/README.md b/docs/pt-br/real-world-development/app/8-foundry-canvas/README.md
@@ -13,6 +13,12 @@ next:
 
 Este percurso opcional adiciona um **Backer Concierge** à Tailspin Toys usando o Microsoft Foundry Canvas no aplicativo GitHub Copilot. Ele começa com um experimento de modelo baseado no catálogo, avança para um agente hospedado e termina com uma integração local ao site.
 
+## Passo a passo em vídeo
+
+Acompanhe o [passo a passo em vídeo do aplicativo GitHub Copilot e do Foundry Canvas no YouTube][video-walkthrough] junto com os módulos escritos abaixo.
+
+<iframe src="https://www.youtube-nocookie.com/embed/AT3EltQ4gTM?cc_load_policy=1" title="Passo a passo em vídeo: crie um Backer Concierge com o aplicativo GitHub Copilot e o 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>
+
 ## O percurso
 
 Cada módulo termina com um ponto de verificação e um ponto seguro para encerrar. O mesmo repositório Tailspin Toys, branch do worktree, sessão vinculada à issue, projeto do Foundry e implantação de modelo são mantidos ao longo do percurso.
@@ -86,3 +92,4 @@ A documentação da Microsoft descreve o Canvas, as implantações hospedadas e
 [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
+[video-walkthrough]: https://www.youtube.com/watch?v=AT3EltQ4gTM