Harness engineering beginner tutorial, from 0 to 1
TypeScript agentagenticagentic-aiaiai-agentai-agentsdshdsh-pluginharnessharness-engineeringharness-frameworkllm
Fix broken lecture-05 link in P07 pages, locale README links, and stale CLAUDE.md
Özgür Sarıyarlı97660a66380b
diff --git a/CLAUDE.md b/CLAUDE.mdindex 4ca05c2..84e348f 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -16,7 +16,7 @@ npm run docs:build # Production buildnpm 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 bardiff --git a/docs-readme/pt-BR/README.md b/docs-readme/pt-BR/README.mdindex 88aff18..03da505 100644--- a/docs-readme/pt-BR/README.md+++ b/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.---diff --git a/docs-readme/uk-UA/README.md b/docs-readme/uk-UA/README.mdindex 37fd823..43ceadc 100644--- a/docs-readme/uk-UA/README.md+++ b/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: усі механізми + спостережуваність + дослідження абляції |```textPROJECT 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 виробничого рівня для вашого власного проєкту.---diff --git a/docs/ar/projects/project-07-loop-engineering-first-loop/index.md b/docs/ar/projects/project-07-loop-engineering-first-loop/index.mdindex 38512a5..b12aba4 100644--- a/docs/ar/projects/project-07-loop-engineering-first-loop/index.md+++ b/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) (ملفات حالة الحلقة هي امتداد لملفات الحالة)diff --git a/docs/de/projects/project-07-loop-engineering-first-loop/index.md b/docs/de/projects/project-07-loop-engineering-first-loop/index.mdindex 0acfc8a..0037ad8 100644--- a/docs/de/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/de/projects/project-07-loop-engineering-first-loop/index.md@@ -144,4 +144,4 @@ Das ist das wichtigste der drei Experimente. Du baust **einen vollständigen Loo- [Lektion 13 — Warum du aufhören solltest, deinen Agenten zu prompten](../../lectures/lecture-13-loop-engineering/index.md)- [Lektion 12 — Warum jede Session einen sauberen Zustand hinterlassen muss](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (jede Runde eines Loops braucht sauberen State)- [Lektion 11 — Warum Beobachtbarkeit ins Harness gehört](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (du musst sehen, was im Inneren des Loops passiert)-- [Lektion 05 — Warum State-Dateien das Rückgrat der Kontinuität sind](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (Loop-State-Dateien sind eine Erweiterung von State-Dateien)+- [Lektion 05 — Warum State-Dateien das Rückgrat der Kontinuität sind](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (Loop-State-Dateien sind eine Erweiterung von State-Dateien)diff --git a/docs/en/projects/project-07-loop-engineering-first-loop/index.md b/docs/en/projects/project-07-loop-engineering-first-loop/index.mdindex 8466cbc..621a117 100644--- a/docs/en/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/en/projects/project-07-loop-engineering-first-loop/index.md@@ -142,4 +142,4 @@ This is the most important of the three experiments. You'll build a **complete l- [Lecture 13 — Why You Need to Stop Prompting Your Agent](../../lectures/lecture-13-loop-engineering/index.md)- [Lecture 12 — Why Every Session Must Leave a Clean State](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (every round of a loop needs clean state)- [Lecture 11 — Why Observability Belongs Inside the Harness](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (you need to see what's happening inside the loop)-- [Lecture 05 — Why State Files Are the Backbone of Continuity](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (loop state files are an extension of state files)+- [Lecture 05 — Why State Files Are the Backbone of Continuity](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (loop state files are an extension of state files)diff --git a/docs/es/projects/project-07-loop-engineering-first-loop/index.md b/docs/es/projects/project-07-loop-engineering-first-loop/index.mdindex 6e6edc3..5d96ca1 100644--- a/docs/es/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/es/projects/project-07-loop-engineering-first-loop/index.md@@ -144,4 +144,4 @@ Este es el más importante de los tres experimentos. Construirás un **loop comp- [Lección 13 — Por Qué Necesitas Dejar de Hacerle Prompting a Tu Agente](../../lectures/lecture-13-loop-engineering/index.md)- [Lección 12 — Por Qué Cada Sesión Debe Dejar un Estado Limpio](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (cada ronda de un loop necesita estado limpio)- [Lección 11 — Por Qué la Observabilidad Pertenece Dentro del Harness](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (necesitas ver qué está pasando dentro del loop)-- [Lección 05 — Por Qué los Archivos de Estado Son la Columna Vertebral de la Continuidad](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (los archivos de estado de loop son una extensión de los archivos de estado)+- [Lección 05 — Por Qué los Archivos de Estado Son la Columna Vertebral de la Continuidad](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (los archivos de estado de loop son una extensión de los archivos de estado)diff --git a/docs/fr/projects/project-07-loop-engineering-first-loop/index.md b/docs/fr/projects/project-07-loop-engineering-first-loop/index.mdindex 3945e0d..65167da 100644--- a/docs/fr/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/fr/projects/project-07-loop-engineering-first-loop/index.md@@ -144,4 +144,4 @@ C'est la plus importante des trois expériences. Vous allez construire **une bou- [Cours 13 — Pourquoi vous devez arrêter de faire du prompting à votre agent](../../lectures/lecture-13-loop-engineering/index.md)- [Cours 12 — Pourquoi chaque session doit laisser un état propre](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (chaque tour d'une boucle a besoin d'un état propre)- [Cours 11 — Pourquoi l'observabilité appartient à l'intérieur du harness](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (vous avez besoin de voir ce qui se passe à l'intérieur de la boucle)-- [Cours 05 — Pourquoi les fichiers d'état sont l'épine dorsale de la continuité](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (les fichiers d'état de boucle sont une extension des fichiers d'état)+- [Cours 05 — Pourquoi les fichiers d'état sont l'épine dorsale de la continuité](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (les fichiers d'état de boucle sont une extension des fichiers d'état)diff --git a/docs/ja/projects/project-07-loop-engineering-first-loop/index.md b/docs/ja/projects/project-07-loop-engineering-first-loop/index.mdindex 1eb2ff8..193ca92 100644--- a/docs/ja/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/ja/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回 — なぜ観測可能性はハーネスの内部にあるべきか](../../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)(ループ状態ファイルは状態ファイルの拡張)diff --git a/docs/ko/projects/project-07-loop-engineering-first-loop/index.md b/docs/ko/projects/project-07-loop-engineering-first-loop/index.mdindex 198020a..85cfc15 100644--- a/docs/ko/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/ko/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강 — 왜 관찰 가능성은 하네스 내부에 속하는가](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (루프 내부에서 무슨 일이 일어나는지 볼 수 있어야 합니다)-- [5강 — 왜 상태 파일은 연속성의 중심인가](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (루프 상태 파일은 상태 파일의 확장입니다)+- [5강 — 왜 상태 파일은 연속성의 중심인가](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (루프 상태 파일은 상태 파일의 확장입니다)diff --git a/docs/pt-BR/projects/project-07-loop-engineering-first-loop/index.md b/docs/pt-BR/projects/project-07-loop-engineering-first-loop/index.mdindex 3b0af33..f331495 100644--- a/docs/pt-BR/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/pt-BR/projects/project-07-loop-engineering-first-loop/index.md@@ -144,4 +144,4 @@ Este é o mais importante dos três experimentos. Você construirá um **loop co- [Aula 13 — Por Que Você Precisa Parar de Dar Prompt no Seu Agente](../../lectures/lecture-13-loop-engineering/index.md)- [Aula 12 — Por Que Toda Sessão Deve Deixar um Estado Limpo](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (cada rodada de um loop precisa de estado limpo)- [Aula 11 — Por Que a Observabilidade Pertence ao Harness](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (você precisa ver o que está acontecendo dentro do loop)-- [Aula 05 — Por Que Arquivos de Estado São a Espinha Dorsal da Continuidade](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (arquivos de estado de loop são uma extensão dos arquivos de estado)+- [Aula 05 — Por Que Arquivos de Estado São a Espinha Dorsal da Continuidade](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (arquivos de estado de loop são uma extensão dos arquivos de estado)diff --git a/docs/ru/projects/project-07-loop-engineering-first-loop/index.md b/docs/ru/projects/project-07-loop-engineering-first-loop/index.mdindex f467134..f5d6249 100644--- a/docs/ru/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/ru/projects/project-07-loop-engineering-first-loop/index.md@@ -144,4 +144,4 @@- [Лекция 13 — Why You Need to Stop Prompting Your Agent](../../lectures/lecture-13-loop-engineering/index.md)- [Лекция 12 — Why Every Session Must Leave a Clean State](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (каждый раунд цикла нуждается в чистом состоянии)- [Лекция 11 — Why Observability Belongs Inside the Harness](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (вам нужно видеть, что происходит внутри цикла)-- [Лекция 05 — Why State Files Are the Backbone of Continuity](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (файлы состояния цикла — это расширение файлов состояния)+- [Лекция 05 — Why State Files Are the Backbone of Continuity](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (файлы состояния цикла — это расширение файлов состояния)diff --git a/docs/tr/projects/project-07-loop-engineering-first-loop/index.md b/docs/tr/projects/project-07-loop-engineering-first-loop/index.mdindex 11962a1..ceae63b 100644--- a/docs/tr/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/tr/projects/project-07-loop-engineering-first-loop/index.md@@ -144,4 +144,4 @@ Bu, üç deneyin en önemlisidir. **Orada olmanıza gerek kalmayan tam bir loop*- [Ders 13 — Ajanınızı prompt etmeyi neden bırakmanız gerekir](../../lectures/lecture-13-loop-engineering/index.md)- [Ders 12 — Her oturum neden temiz bir durumla bitmeli](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (bir loop'un her turu temiz durum gerekir)- [Ders 11 — Gözlemlenebilirlik neden harness'ın içinde olmalı](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (loop'un içinde ne olduğunu görmeniz gerekir)-- [Ders 05 — Durum dosyaları neden sürekliliğin omurgasıdır](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (loop durum dosyaları durum dosyalarının bir uzantısıdır)+- [Ders 05 — Durum dosyaları neden sürekliliğin omurgasıdır](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (loop durum dosyaları durum dosyalarının bir uzantısıdır)diff --git a/docs/uk/projects/project-07-loop-engineering-first-loop/index.md b/docs/uk/projects/project-07-loop-engineering-first-loop/index.mdindex ce8a49d..47247f9 100644--- a/docs/uk/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/uk/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 — Чому спостережуваність належить всередині hарнесу](../../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) (файли стану циклу — це розширення файлів стану)diff --git a/docs/uz/projects/project-07-loop-engineering-first-loop/index.md b/docs/uz/projects/project-07-loop-engineering-first-loop/index.mdindex 8719c13..b2ae23f 100644--- a/docs/uz/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/uz/projects/project-07-loop-engineering-first-loop/index.md@@ -144,4 +144,4 @@ Bu uchta eksperimentning eng muhimi. Siz **sizning ishtirokingizni talab qilmayd- [13-maʼruza — Nega agentingizga prompt yozishni bas qilishingiz kerak](../../lectures/lecture-13-loop-engineering/index.md)- [12-maʼruza — Nega har bir sessiya toza holat qoldirishishi kerak](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (loop ning har bir raundi toza holatni talab qiladi)- [11-maʼruza — Nega kuzatuvchanlik harness ichida boʻlishi kerak](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (loop ichida nima boʻlayotganini koʻrish kerak)-- [5-maʼruza — Nega holat fayllari uzluksizlikning umurtqasi hisoblanadi](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (loop holat fayllari holat fayllarining kengaytmasidir)+- [5-maʼruza — Nega holat fayllari uzluksizlikning umurtqasi hisoblanadi](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (loop holat fayllari holat fayllarining kengaytmasidir)diff --git a/docs/vi/projects/project-07-loop-engineering-first-loop/index.md b/docs/vi/projects/project-07-loop-engineering-first-loop/index.mdindex 34731ba..0a1b71b 100644--- a/docs/vi/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/vi/projects/project-07-loop-engineering-first-loop/index.md@@ -144,4 +144,4 @@ Chuyển sang nhánh `p07-maker-checker`.- [Bài 13 — Tại sao bạn cần ngừng nhắc lệnh Agent của mình](../../lectures/lecture-13-loop-engineering/index.md)- [Bài 12 — Tại sao mỗi phiên phải để lại trạng thái sạch](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md) (mỗi vòng của một vòng lặp cần trạng thái sạch)- [Bài 11 — Tại sao tính quan sát được thuộc về bên trong Harness](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) (bạn cần thấy những gì đang xảy ra bên trong vòng lặp)-- [Bài 05 — Tại sao các file trạng thái là xương sống của tính liên tục](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md) (các file trạng thái vòng lặp là một phần mở rộng của các file trạng thái)+- [Bài 05 — Tại sao các file trạng thái là xương sống của tính liên tục](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) (các file trạng thái vòng lặp là một phần mở rộng của các file trạng thái)diff --git a/docs/zh-TW/projects/project-07-loop-engineering-first-loop/index.md b/docs/zh-TW/projects/project-07-loop-engineering-first-loop/index.mdindex 057eae6..e00f7ae 100644--- a/docs/zh-TW/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/zh-TW/projects/project-07-loop-engineering-first-loop/index.md@@ -144,4 +144,4 @@- [Lecture 13 — 從手動驅動到自動循環](../../lectures/lecture-13-loop-engineering/index.md)- [Lecture 12 — 為什麼每次會話都必須留下乾淨狀態](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md)(loop 的每一輪都需要 clean state)- [Lecture 11 — 為什麼可觀測性屬於 harness 的一部分](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md)(你需要看到 loop 內部在發生什麼)-- [Lecture 05 — 為什麼狀態檔案是跨會話連續性的核心](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md)(loop 狀態檔案是 state file 的延伸)+- [Lecture 05 — 為什麼狀態檔案是跨會話連續性的核心](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md)(loop 狀態檔案是 state file 的延伸)diff --git a/docs/zh/projects/project-07-loop-engineering-first-loop/index.md b/docs/zh/projects/project-07-loop-engineering-first-loop/index.mdindex 321e0e5..60f5746 100644--- a/docs/zh/projects/project-07-loop-engineering-first-loop/index.md+++ b/docs/zh/projects/project-07-loop-engineering-first-loop/index.md@@ -142,4 +142,4 @@- [Lecture 13 — 从手动驱动到自动循环](../../lectures/lecture-13-loop-engineering/index.md)- [Lecture 12 — 为什么每次会话都必须留下干净状态](../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md)(loop 的每一轮都需要 clean state)- [Lecture 11 — 为什么可观测性属于 harness 的一部分](../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md)(你需要看到 loop 内部在发生什么)-- [Lecture 05 — 为什么状态文件是跨会话连续性的核心](../../lectures/lecture-05-why-state-files-are-the-backbone-of-continuity/index.md)(loop 状态文件是 state file 的延伸)+- [Lecture 05 — 为什么状态文件是跨会话连续性的核心](../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md)(loop 状态文件是 state file 的延伸)