Merge pull request #55 from ozzgurr/fix/broken-links-and-stale-docs

Fix broken lecture-05 links in P07 pages and locale README links

Author: sanbuphy

CLAUDE.md

@@ -16,7 +16,7 @@ npm run docs:build      # Production build
 npm run docs:preview    # Preview built site
 
 # Run lecture code examples
-npx tsx docs/lectures/<lecture-dir>/code/<file>.ts
+npx tsx docs/en/lectures/<lecture-dir>/code/<file>.ts
 
 # Project Electron apps (from each project directory)
 cd projects/project-NN/starter  # or solution/
@@ -30,16 +30,17 @@ npm run test:watch       # Vitest watch mode
 ## Repository Structure
 
 - `docs/` — VitePress documentation site (lectures, projects, resources)
-- `docs/.vitepress/config.mts` — Nav/sidebar config for all 13 locales (en, zh, zh-TW, ja, ko, es, fr, ru, de, ar, vi, uz, tr)
-- `docs/lectures/` — 12 lectures, each with `index.md` + `code/` examples
-- `docs/projects/` — 6 project descriptions
+- `docs/.vitepress/config.mts` — Nav/sidebar config for all 15 locales (en, zh, zh-TW, ja, ko, es, fr, ru, de, ar, vi, uz, tr, uk, pt-BR)
+- `docs/<lang>/lectures/` — 13 lectures, each with `index.md` + `code/` examples
+- `docs/<lang>/projects/` — 7 project descriptions
 - `docs/<lang>/resources/` — localized templates, references, OpenAI advanced pack
+- `docs-readme/` — localized README translations (one directory per locale)
 - `projects/shared/` — Shared Electron + TypeScript + React foundation
-- `projects/project-NN/` — Per-project `starter/` and `solution/` directories
+- `projects/project-NN/` — Per-project `starter/` and `solution/` directories (project-01 through project-06; project-07 is docs-only so far)
 
 ## Architecture
 
-The course revolves around an Electron knowledge-base desktop app that evolves across 6 projects:
+The course revolves around an Electron knowledge-base desktop app that evolves across the projects:
 - **Main process** (`src/main/`): Window management, IPC handlers, service initialization
 - **Preload** (`src/preload/`): contextBridge exposing typed API to renderer
 - **Renderer** (`src/renderer/`): React UI with document list, Q&A panel, status bar

docs-readme/pt-BR/README.md

@@ -36,7 +36,7 @@ Aprenda Engenharia de Harness é um curso dedicado à engenharia de agentes de c
 - [Anthropic: Design de Harness para desenvolvimento de aplicativos de longa duração](https://www.anthropic.com/engineering/harness-design-long-running-apps)
 - [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
 
-> **Início rápido?** A skill [`skills/harness-creator/`](./skills/harness-creator/) pode ajudá-lo a estruturar um harness de nível de produção (AGENTS.md, listas de recursos, init.sh, fluxos de verificação) para seu próprio projeto em minutos.
+> **Início rápido?** A skill [`skills/harness-creator/`](../../skills/harness-creator/) pode ajudá-lo a estruturar um harness de nível de produção (AGENTS.md, listas de recursos, init.sh, fluxos de verificação) para seu próprio projeto em minutos.
 
 ---
 
@@ -77,7 +77,7 @@ O repositório agora inclui um pipeline de construção de PDF para o conteúdo
 - Execute `npm run pdf:build` para gerar localmente os livros do curso em PDF configurados atualmente.
 - Os arquivos de saída são gravados em `artifacts/pdfs/`.
 - Execute `npm run screenshots:readme` se desejar atualizar as imagens de prévia do README.
-- O fluxo de trabalho do GitHub Actions [`release-course-pdfs.yml`](./.github/workflows/release-course-pdfs.yml) pode construir os PDFs e publicá-los no GitHub Releases.
+- O fluxo de trabalho do GitHub Actions [`release-course-pdfs.yml`](../../.github/workflows/release-course-pdfs.yml) pode construir os PDFs e publicá-los no GitHub Releases.
 
 ---
 

docs-readme/uk-UA/README.md

@@ -37,7 +37,7 @@ Learn Harness Engineering — курс, присвячений інженері
 - [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)
 
-> **Швидкий старт?** Навичка [`skills/harness-creator/`](./skills/harness-creator/) допоможе вам за лічені хвилини підготувати harness виробничого рівня (AGENTS.md, списки функцій, init.sh, процеси верифікації) для вашого власного проєкту.
+> **Швидкий старт?** Навичка [`skills/harness-creator/`](../../skills/harness-creator/) допоможе вам за лічені хвилини підготувати harness виробничого рівня (AGENTS.md, списки функцій, init.sh, процеси верифікації) для вашого власного проєкту.
 
 ---
 
@@ -78,7 +78,7 @@ Learn Harness Engineering — курс, присвячений інженері
 - Запустіть `npm run pdf:build`, щоб локально згенерувати поточно налаштовані PDF-підручники.
 - Вихідні файли записуються до `artifacts/pdfs/`.
 - Запустіть `npm run screenshots:readme`, якщо потрібно оновити зображення попереднього перегляду README.
-- Робочий процес GitHub Actions [`release-course-pdfs.yml`](./.github/workflows/release-course-pdfs.yml) може збирати PDF та публікувати їх у GitHub Releases.
+- Робочий процес GitHub Actions [`release-course-pdfs.yml`](../../.github/workflows/release-course-pdfs.yml) може збирати PDF та публікувати їх у GitHub Releases.
 
 ---
 
@@ -327,29 +327,29 @@ Harness складається з п'яти підсистем:
 
 | Сесія | Питання | Основна ідея |
 |-------|---------|--------------|
-| [L01](./docs/en/lectures/lecture-01-why-capable-agents-still-fail/index.md) | Чому потужні моделі все одно провалюються на реальних завданнях? | Розрив між можливостями на бенчмарках і реальною інженерією |
-| [L02](./docs/en/lectures/lecture-02-what-a-harness-actually-is/index.md) | Що насправді означає «harness»? | П'ять підсистем: інструкції, стан, верифікація, обсяг, життєвий цикл |
-| [L03](./docs/en/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md) | Чому репозиторій має бути єдиним джерелом правди? | Якщо агент не може це побачити — цього не існує |
-| [L04](./docs/en/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md) | Чому один гігантський файл інструкцій не працює? | Прогресивне розкриття: дайте карту, а не енциклопедію |
-| [L05](./docs/en/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) | Чому тривалі завдання втрачають безперервність? | Зберігайте прогрес на диску; продовжуйте з того місця, де зупинились |
-| [L06](./docs/en/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md) | Чому ініціалізація потребує окремої фази? | Перевіряйте справність середовища перед початком роботи агента |
-| [L07](./docs/en/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md) | Чому агенти виходять за рамки та не доводять справу до кінця? | Одна функція за раз; явне визначення критерію завершення |
-| [L08](./docs/en/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md) | Чому списки функцій є примітивами harness? | Машиночитабельні межі обсягу, які агент не може ігнорувати |
-| [L09](./docs/en/lectures/lecture-09-why-agents-declare-victory-too-early/index.md) | Чому агенти передчасно оголошують перемогу? | Прогалини у верифікації: впевненість ≠ коректність |
-| [L10](./docs/en/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md) | Чому наскрізне тестування змінює результати? | Лише повний запуск конвеєру вважається реальною верифікацією |
-| [L11](./docs/en/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) | Чому спостережуваність має бути всередині harness? | Якщо ви не бачите, що зробив агент, ви не можете виправити те, що він зламав |
-| [L12](./docs/en/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) | Чому кожна сесія має залишати чистий стан? | Успіх наступної сесії залежить від прибирання в поточній |
+| [L01](../../docs/en/lectures/lecture-01-why-capable-agents-still-fail/index.md) | Чому потужні моделі все одно провалюються на реальних завданнях? | Розрив між можливостями на бенчмарках і реальною інженерією |
+| [L02](../../docs/en/lectures/lecture-02-what-a-harness-actually-is/index.md) | Що насправді означає «harness»? | П'ять підсистем: інструкції, стан, верифікація, обсяг, життєвий цикл |
+| [L03](../../docs/en/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md) | Чому репозиторій має бути єдиним джерелом правди? | Якщо агент не може це побачити — цього не існує |
+| [L04](../../docs/en/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md) | Чому один гігантський файл інструкцій не працює? | Прогресивне розкриття: дайте карту, а не енциклопедію |
+| [L05](../../docs/en/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) | Чому тривалі завдання втрачають безперервність? | Зберігайте прогрес на диску; продовжуйте з того місця, де зупинились |
+| [L06](../../docs/en/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md) | Чому ініціалізація потребує окремої фази? | Перевіряйте справність середовища перед початком роботи агента |
+| [L07](../../docs/en/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md) | Чому агенти виходять за рамки та не доводять справу до кінця? | Одна функція за раз; явне визначення критерію завершення |
+| [L08](../../docs/en/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md) | Чому списки функцій є примітивами harness? | Машиночитабельні межі обсягу, які агент не може ігнорувати |
+| [L09](../../docs/en/lectures/lecture-09-why-agents-declare-victory-too-early/index.md) | Чому агенти передчасно оголошують перемогу? | Прогалини у верифікації: впевненість ≠ коректність |
+| [L10](../../docs/en/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md) | Чому наскрізне тестування змінює результати? | Лише повний запуск конвеєру вважається реальною верифікацією |
+| [L11](../../docs/en/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) | Чому спостережуваність має бути всередині harness? | Якщо ви не бачите, що зробив агент, ви не можете виправити те, що він зламав |
+| [L12](../../docs/en/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) | Чому кожна сесія має залишати чистий стан? | Успіх наступної сесії залежить від прибирання в поточній |
 
 ### Проєкти — 6 практичних проєктів із застосуванням методів лекцій на тому самому Electron-застосунку
 
 | Проєкт | Що ви робите | Механізм harness |
 |--------|-------------|-----------------|
-| [P01](./docs/en/projects/project-01-baseline-vs-minimal-harness/index.md) | Виконайте одне й те саме завдання двічі: лише промпт vs. правила на першому місці | Мінімальний harness: AGENTS.md + init.sh + feature_list.json |
-| [P02](./docs/en/projects/project-02-agent-readable-workspace/index.md) | Реструктуруйте репозиторій так, щоб агент міг його читати | Агентне робоче середовище + постійні файли стану |
-| [P03](./docs/en/projects/project-03-multi-session-continuity/index.md) | Змусьте агента продовжувати з того місця, де він зупинився | Журнал прогресу + передача між сесіями + безперервність кількох сесій |
-| [P04](./docs/en/projects/project-04-incremental-indexing/index.md) | Зупиніть агента від надмірної або недостатньої роботи | Runtime-зворотний зв'язок + контроль обсягу + інкрементальна індексація |
-| [P05](./docs/en/projects/project-05-grounded-qa-verification/index.md) | Змусьте агента верифікувати власну роботу | Самоверифікація + обґрунтований Q&A + завершення на основі доказів |
-| [P06](./docs/en/projects/project-06-runtime-observability-and-debugging/index.md) | Побудуйте повноцінний harness з нуля (підсумковий проєкт) | Повний harness: усі механізми + спостережуваність + дослідження абляції |
+| [P01](../../docs/en/projects/project-01-baseline-vs-minimal-harness/index.md) | Виконайте одне й те саме завдання двічі: лише промпт vs. правила на першому місці | Мінімальний harness: AGENTS.md + init.sh + feature_list.json |
+| [P02](../../docs/en/projects/project-02-agent-readable-workspace/index.md) | Реструктуруйте репозиторій так, щоб агент міг його читати | Агентне робоче середовище + постійні файли стану |
+| [P03](../../docs/en/projects/project-03-multi-session-continuity/index.md) | Змусьте агента продовжувати з того місця, де він зупинився | Журнал прогресу + передача між сесіями + безперервність кількох сесій |
+| [P04](../../docs/en/projects/project-04-incremental-indexing/index.md) | Зупиніть агента від надмірної або недостатньої роботи | Runtime-зворотний зв'язок + контроль обсягу + інкрементальна індексація |
+| [P05](../../docs/en/projects/project-05-grounded-qa-verification/index.md) | Змусьте агента верифікувати власну роботу | Самоверифікація + обґрунтований Q&A + завершення на основі доказів |
+| [P06](../../docs/en/projects/project-06-runtime-observability-and-debugging/index.md) | Побудуйте повноцінний harness з нуля (підсумковий проєкт) | Повний harness: усі механізми + спостережуваність + дослідження абляції |
 
 ```text
     PROJECT EVOLUTION
@@ -524,7 +524,7 @@ npm run docs:preview    # Preview built site
 - [Thoughtworks / Martin Fowler: Harness engineering for coding agent users](https://martinfowler.com/articles/harness-engineering.html)
 - [Cursor: Continually improving our agent harness](https://cursor.com/blog/continually-improving-agent-harness)
 
-Повний багаторівневий список джерел дивіться у [`docs/en/resources/reference/`](./docs/en/resources/reference/index.md).
+Повний багаторівневий список джерел дивіться у [`docs/en/resources/reference/`](../../docs/en/resources/reference/index.md).
 
 ---
 
@@ -567,7 +567,7 @@ learn-harness-engineering/
 
 Цей репозиторій також включає багаторазові навички AI-агентів, які можна встановити безпосередньо у ваш IDE або агентне робоче середовище.
 
-- [**harness-creator**](./skills/harness-creator/): Навичка, яка допомагає за лічені хвилини підготувати harness виробничого рівня для вашого власного проєкту.
+- [**harness-creator**](../../skills/harness-creator/): Навичка, яка допомагає за лічені хвилини підготувати harness виробничого рівня для вашого власного проєкту.
 
 ---
 

docs/ar/projects/project-07-loop-engineering-first-loop/index.md

@@ -144,4 +144,4 @@
 - [المحاضرة 13 — لماذا تحتاج إلى التوقف عن مطالبة وكيلك](../../lectures/lecture-13-loop-engineering/index.md)
 - [المحاضرة 12 — لماذا يجب أن تترك كل جلسة حالة نظيفة](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (كل جولة من الحلقة تحتاج إلى حالة نظيفة)
 - [المحاضرة 11 — لماذا تنتمي إمكانية الملاحظة داخل الـ Harness](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (تحتاج إلى رؤية ما يحدث داخل الحلقة)
-- [المحاضرة 05 — لماذا تعد ملفات الحالة هي عمود الفقار للاستمرارية](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (ملفات حالة الحلقة هي امتداد لملفات الحالة)
+- [المحاضرة 05 — لماذا تعد ملفات الحالة هي عمود الفقار للاستمرارية](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (ملفات حالة الحلقة هي امتداد لملفات الحالة)