docs: complete multilingual translations for all 11 locales

Translate all remaining English placeholder content across ar, de, es, fr, ja, ko, ru, uz, vi, zh, zh-TW locales. Includes lecture index files, code examples, templates, references, and skills docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: sanbuphy

CLAUDE.md

@@ -33,7 +33,7 @@ npm run test:watch       # Vitest watch mode
 - `docs/.vitepress/config.mts` — Nav/sidebar config for both EN and ZH locales
 - `docs/lectures/` — 12 lectures, each with `index.md` + `code/` examples
 - `docs/projects/` — 6 project descriptions
-- `docs/resources/` — Bilingual (en/zh) templates, references, OpenAI advanced pack
+- `docs/<lang>/resources/` — localized templates, references, OpenAI advanced pack
 - `projects/shared/` — Shared Electron + TypeScript + React foundation
 - `projects/project-NN/` — Per-project `starter/` and `solution/` directories
 
@@ -57,6 +57,6 @@ Each project's starter/solution is a complete copy of the Electron app at that e
 - Progressive disclosure: short AGENTS.md entrypoint linking to focused docs
 - Each project has two tsconfigs: `tsconfig.json` (renderer) and `tsconfig.node.json` (main/preload)
 
-## Bilingual Content
+## Multilingual Content
 
-All content exists in both English and Chinese. Documentation lives in shared `docs/lectures/` and `docs/projects/` dirs (content is bilingual within each file). Resources have separate `docs/resources/en/` and `docs/resources/zh/` directories. Keep both in sync.
+Course documentation is organized by locale under `docs/<lang>/`. Keep English as the structural source of truth, keep localized directories in sync, and preserve runnable code examples across languages.

README-CN.md

@@ -11,7 +11,7 @@ Learn Harness Engineering 是一门专注于 AI 编程智能体工程化落地
 - [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
 - [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
 
-[**官方网站及文档 (English & 中文)**](https://walkinglabs.github.io/learn-harness-engineering/) | [**English README**](./README.md)
+[**官方网站及多语言文档**](https://walkinglabs.github.io/learn-harness-engineering/) | [**English README**](./README.md)
 
 > **快速上手？** [`skills/harness-creator/`](./skills/) 技能可以帮你在几分钟内为自己的项目搭建一套生产级的 harness（AGENTS.md、功能清单、init.sh、验证工作流）。
 
@@ -51,7 +51,7 @@ Learn Harness Engineering 是一门专注于 AI 编程智能体工程化落地
 
 仓库里现在已经补上了课程 PDF 的构建链路。
 
-- 本地执行 `npm run pdf:build`，会生成中英文两份课程 PDF。
+- 本地执行 `npm run pdf:build`，会生成当前脚本配置的课程 PDF。
 - 输出目录是 `artifacts/pdfs/`。
 - 如果需要刷新 README 里的截图，执行 `npm run screenshots:readme`。
 - GitHub Actions 工作流 [`release-course-pdfs.yml`](./.github/workflows/release-course-pdfs.yml) 可以自动构建 PDF，并把产物上传到 GitHub Release。
@@ -498,7 +498,7 @@ npm run docs:preview    # 预览构建结果
 ```text
 learn-harness-engineering/
 ├── docs/                          # VitePress 文档站
-│   ├── index.md                   # 语言选择页（中文 / English）
+│   ├── index.md                   # 语言选择页
 │   ├── zh/                        # 中文完整内容
 │   │   ├── lectures/              # 12 个讲义（index.md + code/ 示例）
 │   │   ├── projects/              # 6 个项目

README-KO.md

@@ -36,7 +36,7 @@ Learn Harness Engineering은 AI 코딩 에이전트 공학에 전념하는 강
 
 저장소에는 강의 콘텐츠를 위한 PDF 빌드 파이프라인이 포함되어 있습니다.
 
-- `npm run pdf:build` 명령으로 영어·중국어 PDF를 로컬에서 생성할 수 있습니다.
+- `npm run pdf:build` 명령으로 현재 스크립트에 설정된 강의 PDF를 로컬에서 생성할 수 있습니다.
 - 출력 파일은 `artifacts/pdfs/`에 저장됩니다.
 - README 미리보기 이미지를 갱신하려면 `npm run screenshots:readme`를 실행하십시오.
 - GitHub Actions 워크플로우 [`release-course-pdfs.yml`](./.github/workflows/release-course-pdfs.yml)을 통해 PDF를 빌드하고 GitHub Releases에 게시할 수 있습니다.

README.md

@@ -1,4 +1,17 @@
-[English](https://walkinglabs.github.io/learn-harness-engineering/en/) · [中文](https://walkinglabs.github.io/learn-harness-engineering/zh/) · [Русский](https://walkinglabs.github.io/learn-harness-engineering/ru/) · [Tiếng Việt](https://walkinglabs.github.io/learn-harness-engineering/vi/) · [한국어](https://walkinglabs.github.io/learn-harness-engineering/ko/) · [Oʻzbekcha](https://walkinglabs.github.io/learn-harness-engineering/uz/)
+<p align="center">
+  <a href="README.md"><img alt="English" src="https://img.shields.io/badge/English-d9d9d9"></a>
+  <a href="docs-readme/zh-CN/README.md"><img alt="简体中文" src="https://img.shields.io/badge/简体中文-d9d9d9"></a>
+  <a href="docs-readme/zh-TW/README.md"><img alt="繁體中文" src="https://img.shields.io/badge/繁體中文-d9d9d9"></a>
+  <a href="docs-readme/ja-JP/README.md"><img alt="日本語" src="https://img.shields.io/badge/日本語-d9d9d9"></a>
+  <a href="docs-readme/es-ES/README.md"><img alt="Español" src="https://img.shields.io/badge/Español-d9d9d9"></a>
+  <a href="docs-readme/fr-FR/README.md"><img alt="Français" src="https://img.shields.io/badge/Français-d9d9d9"></a>
+  <a href="docs-readme/ko-KR/README.md"><img alt="한국어" src="https://img.shields.io/badge/한국어-d9d9d9"></a>
+  <a href="docs-readme/ar-SA/README.md"><img alt="العربية" src="https://img.shields.io/badge/العربية-d9d9d9"></a>
+  <a href="docs-readme/vi-VN/README.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
+  <a href="docs-readme/de-DE/README.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
+  <a href="https://walkinglabs.github.io/learn-harness-engineering/ru/"><img alt="Русский" src="https://img.shields.io/badge/Русский-d9d9d9"></a>
+  <a href="https://walkinglabs.github.io/learn-harness-engineering/uz/"><img alt="Oʻzbekcha" src="https://img.shields.io/badge/Oʻzbekcha-d9d9d9"></a>
+</p>
 
 # Learn Harness Engineering
 
@@ -49,7 +62,7 @@ Learn Harness Engineering is a course dedicated to the engineering of AI coding
 
 The repository now includes a PDF build pipeline for the course content.
 
-- Run `npm run pdf:build` to generate English and Chinese PDFs locally.
+- Run `npm run pdf:build` to generate the currently configured PDF coursebooks locally.
 - Output files are written to `artifacts/pdfs/`.
 - Run `npm run screenshots:readme` if you want to refresh the README preview images.
 - GitHub Actions workflow [`release-course-pdfs.yml`](./.github/workflows/release-course-pdfs.yml) can build the PDFs and publish them to GitHub Releases.

docs/.vitepress/config.mts

@@ -228,6 +228,96 @@ const koSkillItems = [
   { text: "스킬 개요", link: "/ko/skills/" }
 ];
 
+const relinkItems = (items: Array<{ text: string; link: string }>, locale: string) =>
+  items.map((item) => ({
+    ...item,
+    link: item.link.replace(/^\/(en|zh|vi|ko|uz|ru)\//, `/${locale}/`)
+  }));
+
+const createLocaleTheme = (
+  locale: string,
+  sourceItems: {
+    lectures: Array<{ text: string; link: string }>;
+    projects: Array<{ text: string; link: string }>;
+    resources: Array<{ text: string; link: string }>;
+    skills: Array<{ text: string; link: string }>;
+  },
+  labels: {
+    lectures: string;
+    projects: string;
+    resources: string;
+    skills: string;
+    resourceLibrary: string;
+    tryHarness: string;
+    outline?: string;
+    prev?: string;
+    next?: string;
+    lastUpdated?: string;
+    returnToTop?: string;
+    sidebarMenu?: string;
+    darkModeSwitch?: string;
+    lightModeSwitchTitle?: string;
+    darkModeSwitchTitle?: string;
+  }
+) => {
+  const lectures = relinkItems(sourceItems.lectures, locale);
+  const projects = relinkItems(sourceItems.projects, locale);
+  const resources = relinkItems(sourceItems.resources, locale);
+  const skills = relinkItems(sourceItems.skills, locale);
+
+  return {
+    nav: [
+      { text: labels.lectures, link: lectures[1].link, activeMatch: `^/${locale}/(lectures/.*)?$` },
+      { text: labels.projects, link: projects[0].link, activeMatch: `^/${locale}/projects/` },
+      { text: labels.resources, link: `/${locale}/resources/`, activeMatch: `^/${locale}/resources/` },
+      { text: labels.skills, link: `/${locale}/skills/`, activeMatch: `^/${locale}/skills/` },
+      {
+        text: labels.tryHarness,
+        link: `https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/${locale}/resources/templates/index.md`,
+        target: "_blank",
+        rel: "noopener noreferrer"
+      }
+    ],
+    sidebar: {
+      [`/${locale}/projects/`]: [{ text: labels.projects, items: projects }],
+      [`/${locale}/resources/`]: [{ text: labels.resourceLibrary, items: resources }],
+      [`/${locale}/skills/`]: [{ text: labels.skills, items: skills }],
+      [`/${locale}/`]: [{ text: labels.lectures, items: lectures }]
+    },
+    outline: {
+      level: [2, 3],
+      ...(labels.outline ? { label: labels.outline } : {})
+    },
+    docFooter: {
+      prev: labels.prev || "Previous",
+      next: labels.next || "Next"
+    },
+    lastUpdated: {
+      text: labels.lastUpdated || "Last updated"
+    },
+    returnToTopLabel: labels.returnToTop || "Return to top",
+    sidebarMenuLabel: labels.sidebarMenu || "Menu",
+    darkModeSwitchLabel: labels.darkModeSwitch || "Theme",
+    lightModeSwitchTitle: labels.lightModeSwitchTitle || "Switch to light theme",
+    darkModeSwitchTitle: labels.darkModeSwitchTitle || "Switch to dark theme",
+    socialLinks: [{ icon: "github", link: githubRepoTreeLink }]
+  };
+};
+
+const enSourceItems = {
+  lectures: enLectureItems,
+  projects: enProjectItems,
+  resources: enResourceItems,
+  skills: enSkillItems
+};
+
+const zhSourceItems = {
+  lectures: zhLectureItems,
+  projects: zhProjectItems,
+  resources: zhResourceItems,
+  skills: zhSkillItems
+};
+
 export default withMermaid(
   defineConfig({
     base: docsBase,
@@ -332,6 +422,137 @@ export default withMermaid(
           socialLinks: [{ icon: "github", link: githubRepoTreeLink }]
         }
       },
+      "zh-TW": {
+        label: "繁體中文",
+        lang: "zh-TW",
+        link: "/zh-TW/",
+        themeConfig: createLocaleTheme("zh-TW", zhSourceItems, {
+          lectures: "講義",
+          projects: "專案",
+          resources: "資源庫",
+          skills: "技能",
+          resourceLibrary: "資源庫",
+          tryHarness: "Try Harness ↗",
+          prev: "上一篇",
+          next: "下一篇",
+          lastUpdated: "最後更新於",
+          returnToTop: "回到頂部",
+          sidebarMenu: "選單",
+          darkModeSwitch: "主題",
+          lightModeSwitchTitle: "切換到淺色模式",
+          darkModeSwitchTitle: "切換到深色模式"
+        })
+      },
+      ja: {
+        label: "日本語",
+        lang: "ja-JP",
+        link: "/ja/",
+        themeConfig: createLocaleTheme("ja", enSourceItems, {
+          lectures: "講義",
+          projects: "プロジェクト",
+          resources: "リソース",
+          skills: "スキル",
+          resourceLibrary: "リソースライブラリ",
+          tryHarness: "Try Harness ↗",
+          outline: "このページ",
+          prev: "前へ",
+          next: "次へ",
+          lastUpdated: "最終更新",
+          returnToTop: "トップへ戻る",
+          sidebarMenu: "メニュー",
+          darkModeSwitch: "テーマ",
+          lightModeSwitchTitle: "ライトモードに切り替え",
+          darkModeSwitchTitle: "ダークモードに切り替え"
+        })
+      },
+      es: {
+        label: "Español",
+        lang: "es-ES",
+        link: "/es/",
+        themeConfig: createLocaleTheme("es", enSourceItems, {
+          lectures: "Lecciones",
+          projects: "Proyectos",
+          resources: "Biblioteca",
+          skills: "Skills",
+          resourceLibrary: "Biblioteca de recursos",
+          tryHarness: "Try Harness ↗",
+          outline: "En esta página",
+          prev: "Anterior",
+          next: "Siguiente",
+          lastUpdated: "Última actualización",
+          returnToTop: "Volver arriba",
+          sidebarMenu: "Menú",
+          darkModeSwitch: "Tema",
+          lightModeSwitchTitle: "Cambiar a tema claro",
+          darkModeSwitchTitle: "Cambiar a tema oscuro"
+        })
+      },
+      fr: {
+        label: "Français",
+        lang: "fr-FR",
+        link: "/fr/",
+        themeConfig: createLocaleTheme("fr", enSourceItems, {
+          lectures: "Cours",
+          projects: "Projets",
+          resources: "Bibliothèque",
+          skills: "Skills",
+          resourceLibrary: "Bibliothèque de ressources",
+          tryHarness: "Try Harness ↗",
+          outline: "Sur cette page",
+          prev: "Précédent",
+          next: "Suivant",
+          lastUpdated: "Dernière mise à jour",
+          returnToTop: "Retour en haut",
+          sidebarMenu: "Menu",
+          darkModeSwitch: "Thème",
+          lightModeSwitchTitle: "Passer au thème clair",
+          darkModeSwitchTitle: "Passer au thème sombre"
+        })
+      },
+      de: {
+        label: "Deutsch",
+        lang: "de-DE",
+        link: "/de/",
+        themeConfig: createLocaleTheme("de", enSourceItems, {
+          lectures: "Lektionen",
+          projects: "Projekte",
+          resources: "Bibliothek",
+          skills: "Skills",
+          resourceLibrary: "Ressourcenbibliothek",
+          tryHarness: "Try Harness ↗",
+          outline: "Auf dieser Seite",
+          prev: "Zurück",
+          next: "Weiter",
+          lastUpdated: "Zuletzt aktualisiert",
+          returnToTop: "Nach oben",
+          sidebarMenu: "Menü",
+          darkModeSwitch: "Theme",
+          lightModeSwitchTitle: "Zum hellen Theme wechseln",
+          darkModeSwitchTitle: "Zum dunklen Theme wechseln"
+        })
+      },
+      ar: {
+        label: "العربية",
+        lang: "ar-SA",
+        link: "/ar/",
+        themeConfig: createLocaleTheme("ar", enSourceItems, {
+          lectures: "المحاضرات",
+          projects: "المشاريع",
+          resources: "المكتبة",
+          skills: "المهارات",
+          resourceLibrary: "مكتبة الموارد",
+          tryHarness: "Try Harness ↗",
+          outline: "في هذه الصفحة",
+          prev: "السابق",
+          next: "التالي",
+          lastUpdated: "آخر تحديث",
+          returnToTop: "العودة إلى الأعلى",
+          sidebarMenu: "القائمة",
+          darkModeSwitch: "السمة",
+          lightModeSwitchTitle: "التبديل إلى السمة الفاتحة",
+          darkModeSwitchTitle: "التبديل إلى السمة الداكنة"
+        })
+      },
       vi: {
         label: "Tiếng Việt",
         lang: "vi-VN",

docs/ar/index.md

@@ -0,0 +1,73 @@
+# مرحبًا بك في Learn Harness Engineering
+
+Learn Harness Engineering هو مساق مخصص لهندسة وكلاء البرمجة بالذكاء الاصطناعي. درسنا و لخصنا مجموعة من أكثر نظريات وممارسات Harness Engineering تقدمًا في الصناعة. تشمل مراجعنا الأساسية:
+- [OpenAI: Harness engineering: leveraging Codex in an agent-first world](https://openai.com/index/harness-engineering/)
+- [Anthropic: Effective harnesses for long-running agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents)
+- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
+- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
+
+من خلال تصميم البيئة، وإدارة الحالة، والتحقق، وأنظمة التحكم بطريقة منهجية، يوضح هذا المساق كيف تجعل أدوات البرمجة الوكيلية مثل Codex و Claude Code موثوقة فعليًا. ستتعلم كيف تبني الميزات، وتصلح الأخطاء، وتؤتمت مهام التطوير عبر تقييد مساعد البرمجة بالذكاء الاصطناعي بقواعد وحدود صريحة.
+
+## ابدأ
+
+اختر مسار التعلم المناسب لك. ينقسم المساق إلى محاضرات نظرية، ومشاريع عملية، ومكتبة موارد جاهزة للنسخ.
+
+<div class="card-grid">
+  <a href="./lectures/lecture-01-why-capable-agents-still-fail/" class="card">
+    <h3>المحاضرات</h3>
+    <p>افهم لماذا تفشل النماذج القوية أحيانًا، وتعلم النظرية وراء harnesses الفعالة.</p>
+  </a>
+  <a href="./projects/" class="card">
+    <h3>المشاريع</h3>
+    <p>تدريب عملي على بناء بيئة وكيلية موثوقة من الصفر.</p>
+  </a>
+  <a href="./resources/" class="card">
+    <h3>مكتبة الموارد</h3>
+    <p>قوالب جاهزة للنسخ مثل AGENTS.md و feature_list.json لاستخدامها في مستودعاتك.</p>
+  </a>
+</div>
+
+## الآلية الأساسية للـ harness
+
+الـ harness لا "يجعل النموذج أذكى"؛ بل ينشئ **نظام عمل** مغلق الحلقة للنموذج. يمكنك فهم التدفق الأساسي من خلال هذا المخطط:
+
+```mermaid
+graph TD
+    A["Clear Objective<br/>AGENTS.md"] --> B("Initialization<br/>init.sh")
+    B --> C{"Run Tasks<br/>AI Agent"}
+    C -->|Encounter Issues| D["Runtime Feedback<br/>CLI / Logs"]
+    D -->|Auto-fix| C
+    C -->|Code Completed| E{"Verify & QA<br/>Test suite"}
+    E -->|Failed| D
+    E -->|Passed| F["Cleanup & Handoff<br/>claude-progress.md"]
+    
+    classDef primary fill:#D95C41,stroke:#C14E36,color:#fff,font-weight:bold;
+    classDef process fill:#F4F3EE,stroke:#D1D1D1,color:#1A1A1A;
+    classDef check fill:#EAE8E1,stroke:#B3B3B3,color:#1A1A1A;
+    
+    class A,F primary;
+    class B,D process;
+    class C,E check;
+```
+
+## ما الذي ستتعلمه
+
+هذه بعض المفاهيم الأساسية التي ستتقنها:
+
+<ul class="index-list">
+  <li><strong>تقييد سلوك الوكيل</strong> بقواعد وحدود صريحة.</li>
+  <li><strong>الحفاظ على السياق</strong> عبر المهام الطويلة ومتعددة الجلسات.</li>
+  <li><strong>منع الوكلاء</strong> من إعلان النجاح مبكرًا.</li>
+  <li><strong>التحقق من العمل</strong> باستخدام اختبارات pipeline كاملة ومراجعة ذاتية.</li>
+  <li><strong>جعل runtime قابلًا للملاحظة</strong> وأسهل في التصحيح.</li>
+</ul>
+
+## الخطوات التالية
+
+بعد فهم المفاهيم الأساسية، تساعدك هذه الأدلة على التعمق:
+
+<ul class="index-list">
+  <li><a href="./lectures/lecture-01-why-capable-agents-still-fail/">المحاضرة 01: لماذا تفشل الوكلاء القادرة أحيانًا</a>: ابدأ بالنظرية وراء harness engineering.</li>
+  <li><a href="./projects/project-01-baseline-vs-minimal-harness/">المشروع 01: baseline مقابل harness بسيط</a>: نفذ أول مهمة عملية حقيقية.</li>
+  <li><a href="./resources/templates/">القوالب</a>: احصل على حزمة harness بسيطة لاستخدامها في مشاريعك.</li>
+</ul>