Harness engineering beginner tutorial, from 0 to 1
TypeScript agentagenticagentic-aiaiai-agentai-agentsdshdsh-pluginharnessharness-engineeringharness-frameworkllm
Link project docs to GitHub sources
sanbuphyd6feddb73591
diff --git a/docs/ar/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/ar/projects/project-01-baseline-vs-minimal-harness/index.mdindex c1c2d85..57fbd4e 100644--- a/docs/ar/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/ar/projects/project-01-baseline-vs-minimal-harness/index.md@@ -26,11 +26,11 @@ Harness بسيط: `AGENTS.md` + `init.sh` + `feature_list.json`## استخدم المشروع المضمَّن في المستودع-مسار المشروع في المستودع: `projects/project-01/`+مسار المشروع في المستودع: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| المجلد | ماذا يحتوي | كيف تستخدمه / ماذا تقارن ||------|------|------|-| `starter/` | تشغيل الـ harness الضعيف. يحتوي فقط على `task-prompt.md` كوصف للمهمة ولا يتضمن `AGENTS.md` أو `feature_list.json`. | قدّم الـ prompt لوكيلك وقِس ما الذي ينجزه بدون أي هيكلة إضافية. |-| `solution/` | نفس جزء المنتج مع ملفات harness صريحة: `AGENTS.md` و`CLAUDE.md` و`init.sh` و`feature_list.json` و`claude-progress.md`. | قارن كيف تجعل القواعد والتحقق نفس المهمة قابلة للتنفيذ والقياس. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | تشغيل الـ harness الضعيف. يحتوي فقط على [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) كوصف للمهمة ولا يتضمن `AGENTS.md` أو `feature_list.json`. | قدّم الـ prompt لوكيلك وقِس ما الذي ينجزه بدون أي هيكلة إضافية. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | نفس جزء المنتج مع ملفات harness صريحة: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md) و[`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md) و[`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh) و[`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json) و[`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md). | قارن كيف تجعل القواعد والتحقق نفس المهمة قابلة للتنفيذ والقياس. |الميزات الأربع الملموسة هي: تشغيل النافذة، قائمة المستندات، لوحة الأسئلة/الأجوبة، وإنشاء مجلد البيانات المحلي. راجع `solution/feature_list.json` لمعرفة الدليل المتوقع لكل ميزة.diff --git a/docs/ar/projects/project-02-agent-readable-workspace/index.md b/docs/ar/projects/project-02-agent-readable-workspace/index.mdindex 006a418..e7a3500 100644--- a/docs/ar/projects/project-02-agent-readable-workspace/index.md+++ b/docs/ar/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@## استخدم المشروع الموجود في المستودع-مسار المستودع: `projects/project-02/`+مسار المستودع: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| المجلد | ماذا يحتوي | ماذا تقارن ||------|------|------|-| `starter/` | كود Project 01 مع import المستندات، عرض التفاصيل، و persistence غير مكتملة بعد. توجد وثائق لكنها أخف، ولا يوجد `session-handoff.md`. | مقدار السياق الذي تحتاج الجلسة الثانية من الوكيل إلى اكتشافه من جديد. |-| `solution/` | نفس جزء المنتج مكتمل، مع وثائق handoff تحت `projects/project-02/solution/`، بالإضافة إلى `feature_list.json` و `session-handoff.md`. | هل تستطيع جلسة جديدة المتابعة اعتمادًا على حالة المستودع فقط. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | كود Project 01 مع import المستندات، عرض التفاصيل، و persistence غير مكتملة بعد. توجد وثائق لكنها أخف، ولا يوجد `session-handoff.md`. | مقدار السياق الذي تحتاج الجلسة الثانية من الوكيل إلى اكتشافه من جديد. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | نفس جزء المنتج مكتمل، مع وثائق handoff تحت [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution)، بالإضافة إلى [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json) و [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md). | هل تستطيع جلسة جديدة المتابعة اعتمادًا على حالة المستودع فقط. |## الأدواتdiff --git a/docs/ar/projects/project-03-multi-session-continuity/index.md b/docs/ar/projects/project-03-multi-session-continuity/index.mdindex 0b45116..03da6f3 100644--- a/docs/ar/projects/project-03-multi-session-continuity/index.md+++ b/docs/ar/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@## استخدم المشروع الموجود في المستودع-مسار المستودع: `projects/project-03/`+مسار المستودع: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| المجلد | ماذا يحتوي | ماذا تقارن ||------|------|------|-| `starter/` | كود Project 02 وفيه indexing و Q&A مع citations غير مكتملين بعد. يوجد `feature_list.json` أولي، لكن لا توجد ملفات handoff/restart النهائية. | هل ينحرف الوكيل بين عدة ميزات أو يفقد الحالة بعد إعادة التشغيل. |-| `solution/` | chunking و metadata و index status و citation-based Q&A مكتملة، مع `init.sh` و `session-handoff.md` و `claude-progress.md` و `clean-state-checklist.md`. | هل تملك كل ميزة دليل تحقق قبل وضعها في حالة pass. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | كود Project 02 وفيه indexing و Q&A مع citations غير مكتملين بعد. يوجد [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json) أولي، لكن لا توجد ملفات handoff/restart النهائية. | هل ينحرف الوكيل بين عدة ميزات أو يفقد الحالة بعد إعادة التشغيل. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | chunking و metadata و index status و citation-based Q&A مكتملة، مع [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh) و [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md) و [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md) و [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md). | هل تملك كل ميزة دليل تحقق قبل وضعها في حالة pass. |## الأدواتdiff --git a/docs/ar/projects/project-04-incremental-indexing/index.md b/docs/ar/projects/project-04-incremental-indexing/index.mdindex 8daaa01..a037d55 100644--- a/docs/ar/projects/project-04-incremental-indexing/index.md+++ b/docs/ar/projects/project-04-incremental-indexing/index.md@@ -13,14 +13,14 @@## استخدم المشروع الموجود في المستودع-مسار المستودع: `projects/project-04/`+مسار المستودع: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| المجلد | ماذا يحتوي | ماذا تقارن ||------|------|------|-| `starter/` | كود Project 03 مع إشارات تشخيص ضعيفة. عيب indexing المزروع قد يكسر chunking للملفات الكبيرة، ولا يوجد script لفحص المعمارية. | كم يستغرق الوكيل للوصول إلى السبب الجذري بدون إشارات runtime. |-| `solution/` | structured logger، وثائق/script لحدود المعمارية، منطق chunking مصحح، و `clean-state-checklist.md`. | هل تجعل logs و boundary checks الإصلاح أسرع وأقل تدخلاً. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | كود Project 03 مع إشارات تشخيص ضعيفة. عيب indexing المزروع قد يكسر chunking للملفات الكبيرة، ولا يوجد script لفحص المعمارية. | كم يستغرق الوكيل للوصول إلى السبب الجذري بدون إشارات runtime. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | structured logger، وثائق/script لحدود المعمارية، منطق chunking مصحح، و [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md). | هل تجعل logs و boundary checks الإصلاح أسرع وأقل تدخلاً. |-ملفات مهمة: `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md`, `projects/project-04/solution/src/services/indexing-service.ts`.+ملفات مهمة: [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).## الأدواتdiff --git a/docs/ar/projects/project-05-grounded-qa-verification/index.md b/docs/ar/projects/project-05-grounded-qa-verification/index.mdindex 3278bd7..b6190f9 100644--- a/docs/ar/projects/project-05-grounded-qa-verification/index.md+++ b/docs/ar/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@## استخدم المشروع الموجود في المستودع-مسار المستودع: `projects/project-05/`+مسار المستودع: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| المجلد | ماذا يحتوي | ماذا تقارن ||------|------|------|-| `starter/` | تطبيق مبني على Project 04 قبل ترقية سجل المحادثة. | نقطة البداية إذا أردت إعادة تشغيل المتغيرات الثلاثة. |-| `solution/single-role/` | وكيل واحد يخطط وينفذ ويقيّم نفسه. | الدرجة والعيوب في `evaluator-rubric.md`. |-| `solution/gen-eval/` | generator + evaluator مع دليل مراجعة. | الدرجة وملاحظات revision في `evaluator-rubric.md`. |-| `solution/plan-gen-eval/` | planner + generator + evaluator مع sprint contract. | `sprint-contract.md` ودليل الدرجة الأعلى في `evaluator-rubric.md`. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | تطبيق مبني على Project 04 قبل ترقية سجل المحادثة. | نقطة البداية إذا أردت إعادة تشغيل المتغيرات الثلاثة. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | وكيل واحد يخطط وينفذ ويقيّم نفسه. | الدرجة والعيوب في [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md). |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | generator + evaluator مع دليل مراجعة. | الدرجة وملاحظات revision في [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md). |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | planner + generator + evaluator مع sprint contract. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) ودليل الدرجة الأعلى في [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md). |## الأدواتdiff --git a/docs/ar/projects/project-06-runtime-observability-and-debugging/index.md b/docs/ar/projects/project-06-runtime-observability-and-debugging/index.mdindex fba3ca4..3a7175a 100644--- a/docs/ar/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/ar/projects/project-06-runtime-observability-and-debugging/index.md@@ -13,12 +13,12 @@## استخدم المشروع الموجود في المستودع-مسار المستودع: `projects/project-06/`+مسار المستودع: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| المجلد | ماذا يحتوي | ماذا تقارن ||------|------|------|-| `starter/` | المنتج شبه مكتمل، لكن سطح harness ضعيف عمدًا: يوجد `AGENTS.md` أساسي فقط، ولا يوجد `feature_list.json` أو `session-handoff.md` أو clean-state checklist أو benchmark/cleanup scripts. | ملاحظات يدوية لخط baseline مع harness ضعيف. |-| `solution/` | harness كامل: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, quality/evaluator docs و scripts. | شغّل `projects/project-06/solution/scripts/benchmark.sh` و `projects/project-06/solution/scripts/cleanup-scanner.sh` ثم قارن أدلة الجودة. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | المنتج شبه مكتمل، لكن سطح harness ضعيف عمدًا: يوجد [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md) أساسي فقط، ولا يوجد `feature_list.json` أو `session-handoff.md` أو clean-state checklist أو benchmark/cleanup scripts. | ملاحظات يدوية لخط baseline مع harness ضعيف. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | harness كامل: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), quality/evaluator docs و scripts. | شغّل [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) و [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh) ثم قارن أدلة الجودة. |## الأدواتdiff --git a/docs/de/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/de/projects/project-01-baseline-vs-minimal-harness/index.mdindex 73f91d2..52daec7 100644--- a/docs/de/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/de/projects/project-01-baseline-vs-minimal-harness/index.md@@ -26,11 +26,11 @@ Minimaler harness: `AGENTS.md` + `init.sh` + `feature_list.json`## Nutze das eingecheckte Projekt-Repository-Pfad: `projects/project-01/`+Repository-Pfad: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| Verzeichnis | Inhalt | Nutzung/Vergleich ||------|------|------|-| `starter/` | Weak-Harness-Lauf. Enthält nur `task-prompt.md` als Aufgabenbeschreibung und keine `AGENTS.md` oder `feature_list.json`. | Gib den Prompt an deinen Agenten und miss, was ohne zusätzliche Struktur fertig wird. |-| `solution/` | Gleicher Produktslice mit expliziten Harness-Artefakten: `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json` und `claude-progress.md`. | Vergleiche, wie Regeln und Verifikation die gleiche Aufgabe konkret und überprüfbar machen. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | Weak-Harness-Lauf. Enthält nur [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) als Aufgabenbeschreibung und keine `AGENTS.md` oder `feature_list.json`. | Gib den Prompt an deinen Agenten und miss, was ohne zusätzliche Struktur fertig wird. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | Gleicher Produktslice mit expliziten Harness-Artefakten: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json) und [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md). | Vergleiche, wie Regeln und Verifikation die gleiche Aufgabe konkret und überprüfbar machen. |Die vier konkreten Features sind Fensterstart, Dokumentliste, Frage-Panel und das lokale Datenverzeichnis. Schau in `solution/feature_list.json` für die erwartete Evidence pro Feature.diff --git a/docs/de/projects/project-02-agent-readable-workspace/index.md b/docs/de/projects/project-02-agent-readable-workspace/index.mdindex 1c8eb55..c502154 100644--- a/docs/de/projects/project-02-agent-readable-workspace/index.md+++ b/docs/de/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@ Du führst es zweimal aus: zuerst ohne Hilfe, dann mit bereits abgelegten `ARCHI## Nutze das eingecheckte Projekt-Repository-Pfad: `projects/project-02/`+Repository-Pfad: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| Verzeichnis | Inhalt | Vergleichspunkt ||------|------|------|-| `starter/` | Code aus Project 01 mit noch unvollständigem Import, Detailansicht und Persistenz. Die Dokumentation ist vorhanden, aber dünner, und `session-handoff.md` fehlt. | Wie viel Kontext eine zweite Agent-Sitzung erneut herausfinden muss. |-| `solution/` | Derselbe Produktschnitt ist fertig, mit Übergabedokumentation unter `projects/project-02/solution/` sowie `feature_list.json` und `session-handoff.md`. | Ob eine neue Sitzung nur aus dem Repository-Zustand weiterarbeiten kann. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Code aus Project 01 mit noch unvollständigem Import, Detailansicht und Persistenz. Die Dokumentation ist vorhanden, aber dünner, und `session-handoff.md` fehlt. | Wie viel Kontext eine zweite Agent-Sitzung erneut herausfinden muss. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | Derselbe Produktschnitt ist fertig, mit Übergabedokumentation unter [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) sowie [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json) und [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md). | Ob eine neue Sitzung nur aus dem Repository-Zustand weiterarbeiten kann. |Die Produktfunktionen sind Dokumentimport, vollständiges Laden von Details/Inhalt und Persistenz nach Neustart. Die Harness-Funktion ist ein gut übergebbarer Workspace.diff --git a/docs/de/projects/project-03-multi-session-continuity/index.md b/docs/de/projects/project-03-multi-session-continuity/index.mdindex 7155670..3c3d7f3 100644--- a/docs/de/projects/project-03-multi-session-continuity/index.md+++ b/docs/de/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@ Du führst es zweimal aus: zuerst ohne Einschränkungen, dann mit strikter Durch## Nutze das eingecheckte Projekt-Repository-Pfad: `projects/project-03/`+Repository-Pfad: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| Verzeichnis | Inhalt | Vergleichspunkt ||------|------|------|-| `starter/` | Project-02-Code, bei dem Indexierung und zitierfähiges Q&A noch unvollständig sind. Es gibt ein erstes `feature_list.json`, aber keine finalen Neustart- und Übergabeartefakte. | Ob der Agent über mehrere Funktionen driftet oder nach einem Neustart Zustand verliert. |-| `solution/` | Chunking, Metadaten, Indexierungsstatus und Q&A mit Zitaten sind fertig, plus `init.sh`, `session-handoff.md`, `claude-progress.md` und `clean-state-checklist.md`. | Ob jede Funktion konkrete Evidenz hat, bevor sie als bestanden markiert wird. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Project-02-Code, bei dem Indexierung und zitierfähiges Q&A noch unvollständig sind. Es gibt ein erstes [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json), aber keine finalen Neustart- und Übergabeartefakte. | Ob der Agent über mehrere Funktionen driftet oder nach einem Neustart Zustand verliert. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | Chunking, Metadaten, Indexierungsstatus und Q&A mit Zitaten sind fertig, plus [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md) und [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md). | Ob jede Funktion konkrete Evidenz hat, bevor sie als bestanden markiert wird. |## Werkzeugediff --git a/docs/de/projects/project-04-incremental-indexing/index.md b/docs/de/projects/project-04-incremental-indexing/index.mdindex 4424dce..3cdd1b9 100644--- a/docs/de/projects/project-04-incremental-indexing/index.md+++ b/docs/de/projects/project-04-incremental-indexing/index.md@@ -13,14 +13,14 @@ Du führst es zweimal aus: zuerst ohne Logs oder Regeln, dann mit passenden Werk## Nutze das eingecheckte Projekt-Repository-Pfad: `projects/project-04/`+Repository-Pfad: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| Verzeichnis | Inhalt | Vergleichspunkt ||------|------|------|-| `starter/` | Project-03-Code mit schwachen Diagnosesignalen. Der eingebaute Indexierungsfehler kann Chunking bei großen Dateien brechen, und es gibt kein Architekturprüfskript. | Wie lange der Agent ohne Runtime-Signale bis zur Ursache braucht. |-| `solution/` | Strukturierter Logger, Architekturgrenzendokumentation und Prüfsktipt, korrigierte Chunking-Logik und `clean-state-checklist.md`. | Ob Logs und Grenzprüfungen die Korrektur schneller und weniger invasiv machen. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Project-03-Code mit schwachen Diagnosesignalen. Der eingebaute Indexierungsfehler kann Chunking bei großen Dateien brechen, und es gibt kein Architekturprüfskript. | Wie lange der Agent ohne Runtime-Signale bis zur Ursache braucht. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | Strukturierter Logger, Architekturgrenzendokumentation und Prüfsktipt, korrigierte Chunking-Logik und [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md). | Ob Logs und Grenzprüfungen die Korrektur schneller und weniger invasiv machen. |-Wichtige Dateien: `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md`, `projects/project-04/solution/src/services/indexing-service.ts`.+Wichtige Dateien: [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).## Werkzeugediff --git a/docs/de/projects/project-05-grounded-qa-verification/index.md b/docs/de/projects/project-05-grounded-qa-verification/index.mdindex 481f13c..913d0c6 100644--- a/docs/de/projects/project-05-grounded-qa-verification/index.md+++ b/docs/de/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@ Wähle eine substanzielle Feature-Erweiterung, etwa Multi-Turn-Konversation, Neu## Nutze das eingecheckte Projekt-Repository-Pfad: `projects/project-05/`+Repository-Pfad: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| Verzeichnis | Inhalt | Vergleichspunkt ||------|------|------|-| `starter/` | Project-04-basierte App vor dem Upgrade für Gesprächshistorie. | Ausgangspunkt, wenn du die drei Varianten selbst erneut ausführen willst. |-| `solution/single-role/` | Ein Agent plant, implementiert und bewertet sich selbst. | Bewertung und Defektliste in `evaluator-rubric.md`. |-| `solution/gen-eval/` | Generator + Evaluator mit Revisionsnachweis. | Bewertung und Revisionsnotizen in `evaluator-rubric.md`. |-| `solution/plan-gen-eval/` | Planner + Generator + Evaluator mit Sprint Contract. | `sprint-contract.md` und höhere Bewertungsnachweise in `evaluator-rubric.md`. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | Project-04-basierte App vor dem Upgrade für Gesprächshistorie. | Ausgangspunkt, wenn du die drei Varianten selbst erneut ausführen willst. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | Ein Agent plant, implementiert und bewertet sich selbst. | Bewertung und Defektliste in [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md). |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | Generator + Evaluator mit Revisionsnachweis. | Bewertung und Revisionsnotizen in [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md). |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | Planner + Generator + Evaluator mit Sprint Contract. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) und höhere Bewertungsnachweise in [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md). |## Werkzeugediff --git a/docs/de/projects/project-06-runtime-observability-and-debugging/index.md b/docs/de/projects/project-06-runtime-observability-and-debugging/index.mdindex e344bc7..3ae585e 100644--- a/docs/de/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/de/projects/project-06-runtime-observability-and-debugging/index.md@@ -13,12 +13,12 @@ Nutze ein festes Multi-Feature-Aufgabenset, das einen vollständigen Produktschn## Nutze das eingecheckte Projekt-Repository-Pfad: `projects/project-06/`+Repository-Pfad: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| Verzeichnis | Inhalt | Vergleichspunkt ||------|------|------|-| `starter/` | Produktcode ist weitgehend vollständig, aber die Harness-Oberfläche ist absichtlich geschwächt: nur grundlegendes `AGENTS.md`, kein `feature_list.json`, kein `session-handoff.md`, keine Clean-State-Checkliste und keine Benchmark/Cleanup-Skripte. | Manuelle Baseline-Beobachtungen mit schwachem Harness. |-| `solution/` | Vollständiger Harness: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, Qualitäts-/Evaluator-Dokumente und Skripte. | `projects/project-06/solution/scripts/benchmark.sh` und `projects/project-06/solution/scripts/cleanup-scanner.sh` ausführen und Qualitätsevidenz vergleichen. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | Produktcode ist weitgehend vollständig, aber die Harness-Oberfläche ist absichtlich geschwächt: nur grundlegendes [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md), kein `feature_list.json`, kein `session-handoff.md`, keine Clean-State-Checkliste und keine Benchmark/Cleanup-Skripte. | Manuelle Baseline-Beobachtungen mit schwachem Harness. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | Vollständiger Harness: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), Qualitäts-/Evaluator-Dokumente und Skripte. | [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) und [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh) ausführen und Qualitätsevidenz vergleichen. |## Werkzeugediff --git a/docs/en/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/en/projects/project-01-baseline-vs-minimal-harness/index.mdindex ae10820..b34fc9f 100644--- a/docs/en/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/en/projects/project-01-baseline-vs-minimal-harness/index.md@@ -26,12 +26,12 @@ Minimal harness: `AGENTS.md` + `init.sh` + `feature_list.json`## Use the Checked-In Project-Repository path: `projects/project-01/`+Repository path: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| Directory | What it contains | How to use it ||------|------|------|-| `starter/` | The weak-harness run. It has only `task-prompt.md` as the task description and no `AGENTS.md` or `feature_list.json`. | Give the prompt to your coding agent and measure what it completes without extra structure. |-| `solution/` | The same product slice with explicit harness artifacts: `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json`, and `claude-progress.md`. | Compare how the same task is made concrete through rules and verification evidence. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | The weak-harness run. It has only [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) as the task description and no `AGENTS.md` or `feature_list.json`. | Give the prompt to your coding agent and measure what it completes without extra structure. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | The same product slice with explicit harness artifacts: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json), and [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md). | Compare how the same task is made concrete through rules and verification evidence. |The four concrete features are window launch, document list, question panel, andlocal data directory creation. Inspect `solution/feature_list.json` for thediff --git a/docs/en/projects/project-02-agent-readable-workspace/index.md b/docs/en/projects/project-02-agent-readable-workspace/index.mdindex 43bafec..a42f8a8 100644--- a/docs/en/projects/project-02-agent-readable-workspace/index.md+++ b/docs/en/projects/project-02-agent-readable-workspace/index.md@@ -25,12 +25,12 @@ Agent-readable workspace + persistent state files## Use the Checked-In Project-Repository path: `projects/project-02/`+Repository path: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| Directory | What it contains | What to compare ||------|------|------|-| `starter/` | Project 01 code plus incomplete document import, detail view, and persistence. The docs exist but are intentionally thinner, and there is no `session-handoff.md`. | How much rediscovery a second agent session does. |-| `solution/` | The same slice completed, with expanded docs under `projects/project-02/solution/` (plus `feature_list.json` and `session-handoff.md`). | Whether a fresh session can resume from repo state without oral context. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Project 01 code plus incomplete document import, detail view, and persistence. The docs exist but are intentionally thinner, and there is no `session-handoff.md`. | How much rediscovery a second agent session does. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | The same slice completed, with expanded docs under [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) (plus [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json) and [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md)). | Whether a fresh session can resume from repo state without oral context. |The product features are document import, full document detail/content loading,and persistence across restart. The harness feature is the handoff-readablediff --git a/docs/en/projects/project-03-multi-session-continuity/index.md b/docs/en/projects/project-03-multi-session-continuity/index.mdindex be3ccbf..a7ff7ed 100644--- a/docs/en/projects/project-03-multi-session-continuity/index.md+++ b/docs/en/projects/project-03-multi-session-continuity/index.md@@ -25,12 +25,12 @@ Progress log + session handoff + multi-session continuity + one-feature-at-a-tim## Use the Checked-In Project-Repository path: `projects/project-03/`+Repository path: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| Directory | What it contains | What to compare ||------|------|------|-| `starter/` | Project 02 code with indexing and grounded QA still unfinished. It has a starter `feature_list.json`, but lacks the final restart/handoff artifacts. | Whether the agent drifts across multiple features or loses state after a restart. |-| `solution/` | Completed chunking, metadata, index status, and citation-based QA, plus `init.sh`, `session-handoff.md`, `claude-progress.md`, and `clean-state-checklist.md`. | Whether each feature has concrete verification evidence before it is marked passing. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Project 02 code with indexing and grounded QA still unfinished. It has a starter [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json), but lacks the final restart/handoff artifacts. | Whether the agent drifts across multiple features or loses state after a restart. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | Completed chunking, metadata, index status, and citation-based QA, plus [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md), and [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md). | Whether each feature has concrete verification evidence before it is marked passing. |This project is not a generic "multi-session" exercise. The checked-in solutionmaps to four specific product features: document chunking, metadata extraction,diff --git a/docs/en/projects/project-04-incremental-indexing/index.md b/docs/en/projects/project-04-incremental-indexing/index.mdindex 90b9ee9..1c23a53 100644--- a/docs/en/projects/project-04-incremental-indexing/index.md+++ b/docs/en/projects/project-04-incremental-indexing/index.md@@ -25,14 +25,14 @@ Runtime feedback + scope control + incremental indexing## Use the Checked-In Project-Repository path: `projects/project-04/`+Repository path: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| Directory | What it contains | What to compare ||------|------|------|-| `starter/` | Project 03 code with weak diagnostics. A seeded indexing defect can make large-file chunking fail, and there is no architecture-check script. | How long the agent takes to find the root cause without runtime signals. |-| `solution/` | Structured logger, architecture boundary docs and script, fixed chunking logic, and `clean-state-checklist.md`. | Whether logs and boundary checks make the fix faster and less invasive. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Project 03 code with weak diagnostics. A seeded indexing defect can make large-file chunking fail, and there is no architecture-check script. | How long the agent takes to find the root cause without runtime signals. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | Structured logger, architecture boundary docs and script, fixed chunking logic, and [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md). | Whether logs and boundary checks make the fix faster and less invasive. |-The concrete files to inspect are `projects/project-04/solution/src/services/logger.ts`,-`projects/project-04/solution/scripts/check-architecture.sh`,-`projects/project-04/solution/docs/ARCHITECTURE.md`, and-`projects/project-04/solution/src/services/indexing-service.ts`.+The concrete files to inspect are [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts),+[`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh),+[`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), and+[`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).diff --git a/docs/en/projects/project-05-grounded-qa-verification/index.md b/docs/en/projects/project-05-grounded-qa-verification/index.mdindex f9b266b..b72a89e 100644--- a/docs/en/projects/project-05-grounded-qa-verification/index.md+++ b/docs/en/projects/project-05-grounded-qa-verification/index.md@@ -23,14 +23,14 @@ Self-verification + grounded Q&A + evidence-based completion## Use the Checked-In Project-Repository path: `projects/project-05/`+Repository path: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| Directory | What it contains | What to compare ||------|------|------|-| `starter/` | Project 04-based app before the conversation-history upgrade. | Starting point if you want to rerun the three variants yourself. |-| `solution/single-role/` | One agent plans, implements, and self-reviews. | `evaluator-rubric.md` score 1.6/5 and listed defects. |-| `solution/gen-eval/` | Generator plus evaluator with revision evidence. | `evaluator-rubric.md` score 3.3/5 and revision notes. |-| `solution/plan-gen-eval/` | Planner plus generator plus evaluator. | `sprint-contract.md`, `evaluator-rubric.md` score 4.9/5. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | Project 04-based app before the conversation-history upgrade. | Starting point if you want to rerun the three variants yourself. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | One agent plans, implements, and self-reviews. | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md) score 1.6/5 and listed defects. |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | Generator plus evaluator with revision evidence. | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md) score 3.3/5 and revision notes. |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | Planner plus generator plus evaluator. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md), [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md) score 4.9/5. |The checked-in feature is multi-turn Q&A conversation history. Keep that featureconstant across all three variants so the only variable is role separation.diff --git a/docs/en/projects/project-06-runtime-observability-and-debugging/index.md b/docs/en/projects/project-06-runtime-observability-and-debugging/index.mdindex b2e3a1b..fa38125 100644--- a/docs/en/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/en/projects/project-06-runtime-observability-and-debugging/index.md@@ -26,12 +26,12 @@ Complete harness: all mechanisms + observability + ablation study## Use the Checked-In Project-Repository path: `projects/project-06/`+Repository path: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| Directory | What it contains | What to compare ||------|------|------|-| `starter/` | Mostly complete product code with intentionally weak harness surface: basic `AGENTS.md`, no `feature_list.json`, no `session-handoff.md`, no clean-state checklist. | Manual weak-harness baseline observations. The starter intentionally does not include benchmark scripts. |-| `solution/` | Full harness surface: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, quality/evaluator docs, benchmark and cleanup scripts. | Run `projects/project-06/solution/scripts/benchmark.sh` and `projects/project-06/solution/scripts/cleanup-scanner.sh`, then compare quality-document evidence. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | Mostly complete product code with intentionally weak harness surface: basic [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md), no `feature_list.json`, no `session-handoff.md`, no clean-state checklist. | Manual weak-harness baseline observations. The starter intentionally does not include benchmark scripts. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | Full harness surface: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), quality/evaluator docs, benchmark and cleanup scripts. | Run [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) and [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh), then compare quality-document evidence. |Unlike earlier projects, the capstone starter is not mostly missing productfeatures. The main gap is the operating harness around the app.diff --git a/docs/es/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/es/projects/project-01-baseline-vs-minimal-harness/index.mdindex 3491029..e7ba4e5 100644--- a/docs/es/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/es/projects/project-01-baseline-vs-minimal-harness/index.md@@ -26,11 +26,11 @@ Harness mínimo: `AGENTS.md` + `init.sh` + `feature_list.json`## Usa el proyecto incluido-Ruta en el repositorio: `projects/project-01/`+Ruta en el repositorio: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| Directorio | Qué contiene | Cómo usarlo ||------|------|------|-| `starter/` | Ejecución con harness débil. Solo tiene `task-prompt.md` como descripción de tarea y no incluye `AGENTS.md` ni `feature_list.json`. | Entrega el prompt a tu agente y mide qué completa sin estructura adicional. |-| `solution/` | El mismo slice del producto con artefactos de harness explícitos: `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json` y `claude-progress.md`. | Compara cómo las reglas y la verificación convierten la misma tarea en algo ejecutable y comprobable. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | Ejecución con harness débil. Solo tiene [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) como descripción de tarea y no incluye `AGENTS.md` ni `feature_list.json`. | Entrega el prompt a tu agente y mide qué completa sin estructura adicional. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | El mismo slice del producto con artefactos de harness explícitos: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json) y [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md). | Compara cómo las reglas y la verificación convierten la misma tarea en algo ejecutable y comprobable. |Las cuatro funciones concretas son: lanzar la ventana, lista de documentos, panel de preguntas y respuestas, y creación del directorio de datos local. Consulta `solution/feature_list.json` para ver la evidencia esperada de cada función.diff --git a/docs/es/projects/project-02-agent-readable-workspace/index.md b/docs/es/projects/project-02-agent-readable-workspace/index.mdindex 8b4aabb..fa05024 100644--- a/docs/es/projects/project-02-agent-readable-workspace/index.md+++ b/docs/es/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@ Lo ejecutarás dos veces: primero sin ayuda, y después con `ARCHITECTURE.md`, `## Usa el proyecto incluido-Ruta en el repositorio: `projects/project-02/`+Ruta en el repositorio: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| Directorio | Qué contiene | Qué comparar ||------|------|------|-| `starter/` | Código de Project 01 con importación, vista de detalle y persistencia todavía incompletas. La documentación existe, pero es más ligera y no hay `session-handoff.md`. | Cuánto contexto tiene que redescubrir una segunda sesión del agente. |-| `solution/` | La misma porción de producto ya completada, con documentación de handoff bajo `projects/project-02/solution/`, además de `feature_list.json` y `session-handoff.md`. | Si una sesión nueva puede continuar solo desde el estado del repositorio. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Código de Project 01 con importación, vista de detalle y persistencia todavía incompletas. La documentación existe, pero es más ligera y no hay `session-handoff.md`. | Cuánto contexto tiene que redescubrir una segunda sesión del agente. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | La misma porción de producto ya completada, con documentación de handoff bajo [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution), además de [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json) y [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md). | Si una sesión nueva puede continuar solo desde el estado del repositorio. |Las funciones de producto son importación de documentos, carga completa del detalle/contenido y persistencia tras reiniciar. La función de harness es un workspace legible y fácil de retomar.diff --git a/docs/es/projects/project-03-multi-session-continuity/index.md b/docs/es/projects/project-03-multi-session-continuity/index.mdindex 2177554..34f3cd0 100644--- a/docs/es/projects/project-03-multi-session-continuity/index.md+++ b/docs/es/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@ Lo ejecutarás dos veces: primero sin restricciones, luego con aplicación estri## Usa el proyecto incluido-Ruta en el repositorio: `projects/project-03/`+Ruta en el repositorio: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| Directorio | Qué contiene | Qué comparar ||------|------|------|-| `starter/` | Código de Project 02 con indexación y Q&A fundamentado todavía incompletos. Incluye un `feature_list.json` inicial, pero no los artefactos finales de reinicio y handoff. | Si el agente se desvía entre varias funciones o pierde estado al reiniciar. |-| `solution/` | Chunking, metadatos, estado de indexación y Q&A con citas completados, además de `init.sh`, `session-handoff.md`, `claude-progress.md` y `clean-state-checklist.md`. | Si cada función tiene evidencia concreta antes de marcarse como aprobada. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Código de Project 02 con indexación y Q&A fundamentado todavía incompletos. Incluye un [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json) inicial, pero no los artefactos finales de reinicio y handoff. | Si el agente se desvía entre varias funciones o pierde estado al reiniciar. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | Chunking, metadatos, estado de indexación y Q&A con citas completados, además de [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md) y [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md). | Si cada función tiene evidencia concreta antes de marcarse como aprobada. |## Herramientasdiff --git a/docs/es/projects/project-04-incremental-indexing/index.md b/docs/es/projects/project-04-incremental-indexing/index.mdindex e93117f..1896792 100644--- a/docs/es/projects/project-04-incremental-indexing/index.md+++ b/docs/es/projects/project-04-incremental-indexing/index.md@@ -13,14 +13,14 @@ Lo ejecutarás dos veces: primero sin logs ni restricciones, después con herram## Usa el proyecto incluido-Ruta en el repositorio: `projects/project-04/`+Ruta en el repositorio: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| Directorio | Qué contiene | Qué comparar ||------|------|------|-| `starter/` | Código de Project 03 con diagnósticos débiles. El defecto sembrado de indexación puede romper el chunking de archivos grandes, y no hay script de arquitectura. | Cuánto tarda el agente en encontrar la causa raíz sin señales de runtime. |-| `solution/` | Logger estructurado, documentación y script de límites arquitectónicos, lógica de chunking corregida y `clean-state-checklist.md`. | Si logs y checks de límites hacen la corrección más rápida y menos invasiva. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Código de Project 03 con diagnósticos débiles. El defecto sembrado de indexación puede romper el chunking de archivos grandes, y no hay script de arquitectura. | Cuánto tarda el agente en encontrar la causa raíz sin señales de runtime. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | Logger estructurado, documentación y script de límites arquitectónicos, lógica de chunking corregida y [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md). | Si logs y checks de límites hacen la corrección más rápida y menos invasiva. |-Archivos clave: `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md`, `projects/project-04/solution/src/services/indexing-service.ts`.+Archivos clave: [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).## Herramientasdiff --git a/docs/es/projects/project-05-grounded-qa-verification/index.md b/docs/es/projects/project-05-grounded-qa-verification/index.mdindex 62251c8..55c3afe 100644--- a/docs/es/projects/project-05-grounded-qa-verification/index.md+++ b/docs/es/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@ Elige una mejora sustancial de función, como conversación multi-turno, redise## Usa el proyecto incluido-Ruta en el repositorio: `projects/project-05/`+Ruta en el repositorio: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| Directorio | Qué contiene | Qué comparar ||------|------|------|-| `starter/` | Aplicación basada en Project 04 antes de la mejora de historial conversacional. | Punto de partida si quieres repetir las tres variantes. |-| `solution/single-role/` | Un solo agente planifica, implementa y se autoevalúa. | Puntuación y defectos en `evaluator-rubric.md`. |-| `solution/gen-eval/` | Generador + evaluador con evidencia de revisión. | Puntuación y notas de revisión en `evaluator-rubric.md`. |-| `solution/plan-gen-eval/` | Planificador + generador + evaluador con sprint contract. | `sprint-contract.md` y evidencia de mayor puntuación en `evaluator-rubric.md`. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | Aplicación basada en Project 04 antes de la mejora de historial conversacional. | Punto de partida si quieres repetir las tres variantes. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | Un solo agente planifica, implementa y se autoevalúa. | Puntuación y defectos en [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md). |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | Generador + evaluador con evidencia de revisión. | Puntuación y notas de revisión en [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md). |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | Planificador + generador + evaluador con sprint contract. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) y evidencia de mayor puntuación en [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md). |## Herramientasdiff --git a/docs/es/projects/project-06-runtime-observability-and-debugging/index.md b/docs/es/projects/project-06-runtime-observability-and-debugging/index.mdindex b1360e8..c8f9176 100644--- a/docs/es/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/es/projects/project-06-runtime-observability-and-debugging/index.md@@ -13,12 +13,12 @@ Usa un conjunto fijo de tareas multi-función que cubra una porción completa de## Usa el proyecto incluido-Ruta en el repositorio: `projects/project-06/`+Ruta en el repositorio: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| Directorio | Qué contiene | Qué comparar ||------|------|------|-| `starter/` | Producto casi completo, pero con superficie de harness debilitada: `AGENTS.md` básico, sin `feature_list.json`, `session-handoff.md`, checklist de estado limpio ni scripts de benchmark/cleanup. | Observaciones manuales de la línea base con harness débil. |-| `solution/` | Harness completo: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, documentos de calidad/evaluación y scripts. | Ejecutar `projects/project-06/solution/scripts/benchmark.sh` y `projects/project-06/solution/scripts/cleanup-scanner.sh`, y comparar la evidencia de calidad. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | Producto casi completo, pero con superficie de harness debilitada: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md) básico, sin `feature_list.json`, `session-handoff.md`, checklist de estado limpio ni scripts de benchmark/cleanup. | Observaciones manuales de la línea base con harness débil. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | Harness completo: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), documentos de calidad/evaluación y scripts. | Ejecutar [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) y [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh), y comparar la evidencia de calidad. |## Herramientasdiff --git a/docs/fr/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/fr/projects/project-01-baseline-vs-minimal-harness/index.mdindex 781bd7c..77d4289 100644--- a/docs/fr/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/fr/projects/project-01-baseline-vs-minimal-harness/index.md@@ -26,11 +26,11 @@ Harness minimal : `AGENTS.md` + `init.sh` + `feature_list.json`## Utiliser le projet fourni dans le dépôt-Chemin dans le dépôt : `projects/project-01/`+Chemin dans le dépôt : [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| Dossier | Ce qu’il contient | Comment l’utiliser ||------|------|------|-| `starter/` | Exécution « harness faible ». Contient uniquement `task-prompt.md` comme description de la tâche, sans `AGENTS.md` ni `feature_list.json`. | Donne le prompt à ton agent et mesure ce qu’il termine sans structure supplémentaire. |-| `solution/` | Le même slice produit avec des artefacts de harness explicites : `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json` et `claude-progress.md`. | Compare comment les règles et la vérification rendent la même tâche concrète et vérifiable. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | Exécution « harness faible ». Contient uniquement [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) comme description de la tâche, sans `AGENTS.md` ni `feature_list.json`. | Donne le prompt à ton agent et mesure ce qu’il termine sans structure supplémentaire. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | Le même slice produit avec des artefacts de harness explicites : [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json) et [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md). | Compare comment les règles et la vérification rendent la même tâche concrète et vérifiable. |Les quatre fonctionnalités concrètes sont : ouverture de la fenêtre, liste de documents, panneau de questions, et création du répertoire de données local. Consulte `solution/feature_list.json` pour l’évidence attendue pour chaque fonctionnalité.diff --git a/docs/fr/projects/project-02-agent-readable-workspace/index.md b/docs/fr/projects/project-02-agent-readable-workspace/index.mdindex 37f5a5b..08b361f 100644--- a/docs/fr/projects/project-02-agent-readable-workspace/index.md+++ b/docs/fr/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@ Vous l'exécutez deux fois : d'abord sans aide, puis avec `ARCHITECTURE.md`, `PR## Utiliser le projet fourni-Chemin dans le dépôt : `projects/project-02/`+Chemin dans le dépôt : [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| Dossier | Contenu | À comparer ||------|------|------|-| `starter/` | Code de Project 01 avec import, vue détail et persistance encore incomplets. La documentation existe, mais elle est plus légère et il n'y a pas de `session-handoff.md`. | Combien de contexte une deuxième session doit redécouvrir. |-| `solution/` | Même tranche produit terminée, avec documentation de reprise sous `projects/project-02/solution/`, plus `feature_list.json` et `session-handoff.md`. | Si une nouvelle session peut reprendre uniquement depuis l'état du dépôt. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Code de Project 01 avec import, vue détail et persistance encore incomplets. La documentation existe, mais elle est plus légère et il n'y a pas de `session-handoff.md`. | Combien de contexte une deuxième session doit redécouvrir. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | Même tranche produit terminée, avec documentation de reprise sous [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution), plus [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json) et [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md). | Si une nouvelle session peut reprendre uniquement depuis l'état du dépôt. |## Outilsdiff --git a/docs/fr/projects/project-03-multi-session-continuity/index.md b/docs/fr/projects/project-03-multi-session-continuity/index.mdindex 756d318..e832b54 100644--- a/docs/fr/projects/project-03-multi-session-continuity/index.md+++ b/docs/fr/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@ Vous l'exécutez deux fois : d'abord sans contraintes, puis avec application str## Utiliser le projet fourni-Chemin dans le dépôt : `projects/project-03/`+Chemin dans le dépôt : [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| Dossier | Contenu | À comparer ||------|------|------|-| `starter/` | Code de Project 02 avec indexation et Q&A avec citations encore incomplets. Il contient un premier `feature_list.json`, mais pas les artefacts finaux de reprise. | Si l'agent dérive entre plusieurs fonctions ou perd l'état après redémarrage. |-| `solution/` | Chunking, métadonnées, état d'indexation et Q&A avec citations terminés, plus `init.sh`, `session-handoff.md`, `claude-progress.md`, `clean-state-checklist.md`. | Si chaque fonction a une preuve concrète avant d'être marquée comme réussie. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Code de Project 02 avec indexation et Q&A avec citations encore incomplets. Il contient un premier [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json), mais pas les artefacts finaux de reprise. | Si l'agent dérive entre plusieurs fonctions ou perd l'état après redémarrage. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | Chunking, métadonnées, état d'indexation et Q&A avec citations terminés, plus [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md). | Si chaque fonction a une preuve concrète avant d'être marquée comme réussie. |## Outilsdiff --git a/docs/fr/projects/project-04-incremental-indexing/index.md b/docs/fr/projects/project-04-incremental-indexing/index.mdindex c956382..ae041e2 100644--- a/docs/fr/projects/project-04-incremental-indexing/index.md+++ b/docs/fr/projects/project-04-incremental-indexing/index.md@@ -13,14 +13,14 @@ Vous l'exécutez deux fois : d'abord sans logs ni contraintes, puis avec les bon## Utiliser le projet fourni-Chemin dans le dépôt : `projects/project-04/`+Chemin dans le dépôt : [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| Dossier | Contenu | À comparer ||------|------|------|-| `starter/` | Code de Project 03 avec diagnostics faibles. Le défaut d'indexation intégré peut casser le chunking des gros fichiers, et il n'y a pas de script de contrôle d'architecture. | Le temps nécessaire pour trouver la cause sans signaux runtime. |-| `solution/` | Logger structuré, documentation/script de frontières d'architecture, logique de chunking corrigée et `clean-state-checklist.md`. | Si les logs et contrôles rendent la correction plus rapide et moins invasive. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Code de Project 03 avec diagnostics faibles. Le défaut d'indexation intégré peut casser le chunking des gros fichiers, et il n'y a pas de script de contrôle d'architecture. | Le temps nécessaire pour trouver la cause sans signaux runtime. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | Logger structuré, documentation/script de frontières d'architecture, logique de chunking corrigée et [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md). | Si les logs et contrôles rendent la correction plus rapide et moins invasive. |-Fichiers clés : `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md`, `projects/project-04/solution/src/services/indexing-service.ts`.+Fichiers clés : [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).## Outilsdiff --git a/docs/fr/projects/project-05-grounded-qa-verification/index.md b/docs/fr/projects/project-05-grounded-qa-verification/index.mdindex 61b6b21..de9b477 100644--- a/docs/fr/projects/project-05-grounded-qa-verification/index.md+++ b/docs/fr/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@ Choisissez une amélioration substantielle de fonctionnalité, comme une convers## Utiliser le projet fourni-Chemin dans le dépôt : `projects/project-05/`+Chemin dans le dépôt : [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| Dossier | Contenu | À comparer ||------|------|------|-| `starter/` | Application basée sur Project 04 avant l'ajout de l'historique conversationnel. | Point de départ pour relancer les trois variantes. |-| `solution/single-role/` | Un agent planifie, implémente et s'auto-évalue. | Score et défauts dans `evaluator-rubric.md`. |-| `solution/gen-eval/` | Générateur + évaluateur avec preuve de révision. | Score et notes de révision dans `evaluator-rubric.md`. |-| `solution/plan-gen-eval/` | Planner + générateur + évaluateur avec sprint contract. | `sprint-contract.md` et preuves de score plus élevé dans `evaluator-rubric.md`. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | Application basée sur Project 04 avant l'ajout de l'historique conversationnel. | Point de départ pour relancer les trois variantes. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | Un agent planifie, implémente et s'auto-évalue. | Score et défauts dans [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md). |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | Générateur + évaluateur avec preuve de révision. | Score et notes de révision dans [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md). |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | Planner + générateur + évaluateur avec sprint contract. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) et preuves de score plus élevé dans [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md). |## Outilsdiff --git a/docs/fr/projects/project-06-runtime-observability-and-debugging/index.md b/docs/fr/projects/project-06-runtime-observability-and-debugging/index.mdindex 817c19d..234b645 100644--- a/docs/fr/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/fr/projects/project-06-runtime-observability-and-debugging/index.md@@ -13,12 +13,12 @@ Utilisez un ensemble fixe de tâches multi-fonctionnalités couvrant une tranche## Utiliser le projet fourni-Chemin dans le dépôt : `projects/project-06/`+Chemin dans le dépôt : [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| Dossier | Contenu | À comparer ||------|------|------|-| `starter/` | Produit presque complet, mais surface de harness affaiblie : `AGENTS.md` de base, pas de `feature_list.json`, `session-handoff.md`, checklist clean-state ni scripts benchmark/cleanup. | Observations manuelles de la baseline à harness faible. |-| `solution/` | Harness complet : `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, documents qualité/évaluation et scripts. | Exécuter `projects/project-06/solution/scripts/benchmark.sh` et `projects/project-06/solution/scripts/cleanup-scanner.sh`, puis comparer les preuves qualité. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | Produit presque complet, mais surface de harness affaiblie : [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md) de base, pas de `feature_list.json`, `session-handoff.md`, checklist clean-state ni scripts benchmark/cleanup. | Observations manuelles de la baseline à harness faible. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | Harness complet : [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), documents qualité/évaluation et scripts. | Exécuter [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) et [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh), puis comparer les preuves qualité. |## Outilsdiff --git a/docs/ja/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/ja/projects/project-01-baseline-vs-minimal-harness/index.mdindex dfc91f9..b964ac1 100644--- a/docs/ja/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/ja/projects/project-01-baseline-vs-minimal-harness/index.md@@ -26,11 +26,11 @@## リポジトリに同梱されたプロジェクトを使う-リポジトリ内のパス: `projects/project-01/`+リポジトリ内のパス: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| ディレクトリ | 含まれるもの | 使い方 / 比較ポイント ||------|------|------|-| `starter/` | 弱い harness の実行用。タスク説明は `task-prompt.md` のみで、`AGENTS.md` や `feature_list.json` はありません。 | prompt だけをエージェントに渡し、追加の構造なしで何が完了するか測定します。 |-| `solution/` | 同じプロダクトスライスに、明示的な harness 成果物を追加: `AGENTS.md`、`CLAUDE.md`、`init.sh`、`feature_list.json`、`claude-progress.md`。 | ルールと検証が同じタスクをどう具体化・検証可能にするか比較します。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | 弱い harness の実行用。タスク説明は [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) のみで、`AGENTS.md` や `feature_list.json` はありません。 | prompt だけをエージェントに渡し、追加の構造なしで何が完了するか測定します。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | 同じプロダクトスライスに、明示的な harness 成果物を追加: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md)、[`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md)、[`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh)、[`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json)、[`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md)。 | ルールと検証が同じタスクをどう具体化・検証可能にするか比較します。 |具体的な4機能は「ウィンドウ起動」「ドキュメント一覧」「質問パネル」「ローカルデータディレクトリ作成」です。各機能の期待される証拠は `solution/feature_list.json` を参照してください。diff --git a/docs/ja/projects/project-02-agent-readable-workspace/index.md b/docs/ja/projects/project-02-agent-readable-workspace/index.mdindex f21a6a0..050ef50 100644--- a/docs/ja/projects/project-02-agent-readable-workspace/index.md+++ b/docs/ja/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@## リポジトリ内のプロジェクトを使う-リポジトリ内のパス: `projects/project-02/`+リポジトリ内のパス: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| ディレクトリ | 含まれるもの | 比較すること ||------|------|------|-| `starter/` | Project 01 のコードに、未完成のドキュメント import、詳細ビュー、永続化が入っています。ドキュメントはありますが薄く、`session-handoff.md` はありません。 | 2 回目のエージェントセッションがどれだけ再探索するか。 |-| `solution/` | 同じプロダクト範囲が完成しており、`projects/project-02/solution/` 配下に引き継ぎ用ドキュメント、`feature_list.json`、`session-handoff.md` があります。 | 新しいセッションがリポジトリ状態だけで再開できるか。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Project 01 のコードに、未完成のドキュメント import、詳細ビュー、永続化が入っています。ドキュメントはありますが薄く、`session-handoff.md` はありません。 | 2 回目のエージェントセッションがどれだけ再探索するか。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | 同じプロダクト範囲が完成しており、[`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) 配下に引き継ぎ用ドキュメント、[`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json)、[`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md) があります。 | 新しいセッションがリポジトリ状態だけで再開できるか。 |## ツールdiff --git a/docs/ja/projects/project-03-multi-session-continuity/index.md b/docs/ja/projects/project-03-multi-session-continuity/index.mdindex 33500e4..37b3f1b 100644--- a/docs/ja/projects/project-03-multi-session-continuity/index.md+++ b/docs/ja/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@## リポジトリ内のプロジェクトを使う-リポジトリ内のパス: `projects/project-03/`+リポジトリ内のパス: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| ディレクトリ | 含まれるもの | 比較すること ||------|------|------|-| `starter/` | Project 02 のコードで、indexing と citation 付き Q&A がまだ未完成です。初期の `feature_list.json` はありますが、最終的な handoff/restart 成果物はありません。 | 複数機能をまたぐときにエージェントが逸れたり状態を失ったりするか。 |-| `solution/` | chunking、metadata、index status、citation-based QA が完成し、`init.sh`、`session-handoff.md`、`claude-progress.md`、`clean-state-checklist.md` もあります。 | 各機能が pass になる前に具体的な検証証拠を持つか。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Project 02 のコードで、indexing と citation 付き Q&A がまだ未完成です。初期の [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json) はありますが、最終的な handoff/restart 成果物はありません。 | 複数機能をまたぐときにエージェントが逸れたり状態を失ったりするか。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | chunking、metadata、index status、citation-based QA が完成し、[`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh)、[`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md)、[`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md)、[`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md) もあります。 | 各機能が pass になる前に具体的な検証証拠を持つか。 |## ツールdiff --git a/docs/ja/projects/project-04-incremental-indexing/index.md b/docs/ja/projects/project-04-incremental-indexing/index.mdindex 5841d18..e44e712 100644--- a/docs/ja/projects/project-04-incremental-indexing/index.md+++ b/docs/ja/projects/project-04-incremental-indexing/index.md@@ -13,14 +13,14 @@## リポジトリ内のプロジェクトを使う-リポジトリ内のパス: `projects/project-04/`+リポジトリ内のパス: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| ディレクトリ | 含まれるもの | 比較すること ||------|------|------|-| `starter/` | Project 03 のコードで診断シグナルが弱い状態です。仕込まれた indexing 欠陥により大きなファイルの chunking が壊れる可能性があり、architecture check script もありません。 | runtime シグナルなしで根本原因にたどり着く時間。 |-| `solution/` | structured logger、architecture boundary docs/script、修正済み chunking logic、`clean-state-checklist.md` があります。 | logs と boundary checks が修正を速く、影響範囲を小さくするか。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Project 03 のコードで診断シグナルが弱い状態です。仕込まれた indexing 欠陥により大きなファイルの chunking が壊れる可能性があり、architecture check script もありません。 | runtime シグナルなしで根本原因にたどり着く時間。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | structured logger、architecture boundary docs/script、修正済み chunking logic、[`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md) があります。 | logs と boundary checks が修正を速く、影響範囲を小さくするか。 |-確認するファイル: `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md`, `projects/project-04/solution/src/services/indexing-service.ts`.+確認するファイル: [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).## ツールdiff --git a/docs/ja/projects/project-05-grounded-qa-verification/index.md b/docs/ja/projects/project-05-grounded-qa-verification/index.mdindex e3e45f3..9de2101 100644--- a/docs/ja/projects/project-05-grounded-qa-verification/index.md+++ b/docs/ja/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@## リポジトリ内のプロジェクトを使う-リポジトリ内のパス: `projects/project-05/`+リポジトリ内のパス: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| ディレクトリ | 含まれるもの | 比較すること ||------|------|------|-| `starter/` | Project 04 ベースのアプリで、会話履歴アップグレード前の状態です。 | 3 つの変種を自分で再実行する出発点。 |-| `solution/single-role/` | 1 つのエージェントが計画・実装・自己評価を行います。 | `evaluator-rubric.md` のスコアと欠陥。 |-| `solution/gen-eval/` | generator + evaluator で修正証拠があります。 | `evaluator-rubric.md` のスコアと revision notes。 |-| `solution/plan-gen-eval/` | planner + generator + evaluator と sprint contract があります。 | `sprint-contract.md` と `evaluator-rubric.md` の高い評価証拠。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | Project 04 ベースのアプリで、会話履歴アップグレード前の状態です。 | 3 つの変種を自分で再実行する出発点。 |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | 1 つのエージェントが計画・実装・自己評価を行います。 | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md) のスコアと欠陥。 |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | generator + evaluator で修正証拠があります。 | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md) のスコアと revision notes。 |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | planner + generator + evaluator と sprint contract があります。 | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) と [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md) の高い評価証拠。 |## ツールdiff --git a/docs/ja/projects/project-06-runtime-observability-and-debugging/index.md b/docs/ja/projects/project-06-runtime-observability-and-debugging/index.mdindex 94a2165..abd9ad6 100644--- a/docs/ja/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/ja/projects/project-06-runtime-observability-and-debugging/index.md@@ -13,12 +13,12 @@## リポジトリ内のプロジェクトを使う-リポジトリ内のパス: `projects/project-06/`+リポジトリ内のパス: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| ディレクトリ | 含まれるもの | 比較すること ||------|------|------|-| `starter/` | プロダクトはほぼ完成していますが、harness は意図的に弱められています。基本的な `AGENTS.md` のみで、`feature_list.json`、`session-handoff.md`、clean-state checklist、benchmark/cleanup scripts はありません。 | 弱い harness baseline の手動観察。 |-| `solution/` | 完全な harness: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, quality/evaluator docs, scripts。 | `projects/project-06/solution/scripts/benchmark.sh` と `projects/project-06/solution/scripts/cleanup-scanner.sh` を実行し、quality evidence を比較します。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | プロダクトはほぼ完成していますが、harness は意図的に弱められています。基本的な [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md) のみで、`feature_list.json`、`session-handoff.md`、clean-state checklist、benchmark/cleanup scripts はありません。 | 弱い harness baseline の手動観察。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | 完全な harness: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), quality/evaluator docs, scripts。 | [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) と [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh) を実行し、quality evidence を比較します。 |## ツールdiff --git a/docs/ko/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/ko/projects/project-01-baseline-vs-minimal-harness/index.mdindex 37651c0..26221c6 100644--- a/docs/ko/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/ko/projects/project-01-baseline-vs-minimal-harness/index.md@@ -28,11 +28,11 @@## 저장소에 포함된 프로젝트 사용하기-저장소 경로: `projects/project-01/`+저장소 경로: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| 디렉터리 | 무엇이 들어있나 | 어떻게 사용할까 / 무엇을 비교할까 ||------|------|------|-| `starter/` | 약한 하네스 실행용. 작업 설명은 `task-prompt.md`만 있고 `AGENTS.md`나 `feature_list.json`은 없습니다. | 프롬프트만 에이전트에 주고, 추가 구조 없이 무엇을 완성하는지 측정합니다. |-| `solution/` | 같은 제품 슬라이스에 명시적인 하네스 산출물 포함: `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json`, `claude-progress.md`. | 규칙/검증이 같은 작업을 어떻게 구체화하고 검증 가능하게 만드는지 비교합니다. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | 약한 하네스 실행용. 작업 설명은 [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md)만 있고 `AGENTS.md`나 `feature_list.json`은 없습니다. | 프롬프트만 에이전트에 주고, 추가 구조 없이 무엇을 완성하는지 측정합니다. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | 같은 제품 슬라이스에 명시적인 하네스 산출물 포함: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md). | 규칙/검증이 같은 작업을 어떻게 구체화하고 검증 가능하게 만드는지 비교합니다. |구체적인 4개 기능은 창 실행, 문서 목록, 질문 패널, 로컬 데이터 디렉터리 생성입니다. 각 기능의 기대 증거는 `solution/feature_list.json`을 확인하세요.diff --git a/docs/ko/projects/project-02-agent-readable-workspace/index.md b/docs/ko/projects/project-02-agent-readable-workspace/index.mdindex c6e188c..2b42ffb 100644--- a/docs/ko/projects/project-02-agent-readable-workspace/index.md+++ b/docs/ko/projects/project-02-agent-readable-workspace/index.md@@ -15,12 +15,12 @@## 저장소에 포함된 프로젝트 사용하기-저장소 경로: `projects/project-02/`+저장소 경로: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| 디렉터리 | 내용 | 비교할 것 ||------|------|------|-| `starter/` | Project 01 코드에 문서 가져오기, 상세 보기, 지속성이 아직 완성되지 않은 상태입니다. 문서는 있지만 더 얇고 `session-handoff.md`가 없습니다. | 두 번째 에이전트 세션이 얼마나 많은 컨텍스트를 다시 찾아야 하는지. |-| `solution/` | 같은 제품 범위가 완성되어 있고, `projects/project-02/solution/` 아래에 인수인계 문서와 `feature_list.json`, `session-handoff.md`가 있습니다. | 새 세션이 저장소 상태만 보고 이어갈 수 있는지. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Project 01 코드에 문서 가져오기, 상세 보기, 지속성이 아직 완성되지 않은 상태입니다. 문서는 있지만 더 얇고 `session-handoff.md`가 없습니다. | 두 번째 에이전트 세션이 얼마나 많은 컨텍스트를 다시 찾아야 하는지. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | 같은 제품 범위가 완성되어 있고, [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) 아래에 인수인계 문서와 [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md)가 있습니다. | 새 세션이 저장소 상태만 보고 이어갈 수 있는지. |## 도구diff --git a/docs/ko/projects/project-03-multi-session-continuity/index.md b/docs/ko/projects/project-03-multi-session-continuity/index.mdindex f93aee1..5066584 100644--- a/docs/ko/projects/project-03-multi-session-continuity/index.md+++ b/docs/ko/projects/project-03-multi-session-continuity/index.md@@ -15,12 +15,12 @@## 저장소에 포함된 프로젝트 사용하기-저장소 경로: `projects/project-03/`+저장소 경로: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| 디렉터리 | 내용 | 비교할 것 ||------|------|------|-| `starter/` | Project 02 코드에서 indexing과 citation 기반 Q&A가 아직 미완성입니다. 초기 `feature_list.json`은 있지만 최종 handoff/restart 산출물은 없습니다. | 여러 기능 사이에서 에이전트가 drift하거나 재시작 후 상태를 잃는지. |-| `solution/` | chunking, metadata, index status, citation-based QA가 완성되어 있고 `init.sh`, `session-handoff.md`, `claude-progress.md`, `clean-state-checklist.md`가 있습니다. | 각 기능이 pass로 표시되기 전에 구체적 검증 증거가 있는지. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Project 02 코드에서 indexing과 citation 기반 Q&A가 아직 미완성입니다. 초기 [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json)은 있지만 최종 handoff/restart 산출물은 없습니다. | 여러 기능 사이에서 에이전트가 drift하거나 재시작 후 상태를 잃는지. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | chunking, metadata, index status, citation-based QA가 완성되어 있고 [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md)가 있습니다. | 각 기능이 pass로 표시되기 전에 구체적 검증 증거가 있는지. |## 도구diff --git a/docs/ko/projects/project-04-incremental-indexing/index.md b/docs/ko/projects/project-04-incremental-indexing/index.mdindex 669206a..3de76b6 100644--- a/docs/ko/projects/project-04-incremental-indexing/index.md+++ b/docs/ko/projects/project-04-incremental-indexing/index.md@@ -15,14 +15,14 @@## 저장소에 포함된 프로젝트 사용하기-저장소 경로: `projects/project-04/`+저장소 경로: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| 디렉터리 | 내용 | 비교할 것 ||------|------|------|-| `starter/` | Project 03 코드이며 진단 신호가 약합니다. 삽입된 indexing 결함이 큰 파일 chunking을 깨뜨릴 수 있고 architecture check script가 없습니다. | runtime 신호 없이 근본 원인을 찾는 데 걸리는 시간. |-| `solution/` | structured logger, architecture boundary docs/script, 수정된 chunking logic, `clean-state-checklist.md`가 있습니다. | logs와 boundary checks가 수정 속도와 안정성을 개선하는지. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Project 03 코드이며 진단 신호가 약합니다. 삽입된 indexing 결함이 큰 파일 chunking을 깨뜨릴 수 있고 architecture check script가 없습니다. | runtime 신호 없이 근본 원인을 찾는 데 걸리는 시간. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | structured logger, architecture boundary docs/script, 수정된 chunking logic, [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md)가 있습니다. | logs와 boundary checks가 수정 속도와 안정성을 개선하는지. |-확인 파일: `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md`, `projects/project-04/solution/src/services/indexing-service.ts`.+확인 파일: [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).## 도구diff --git a/docs/ko/projects/project-05-grounded-qa-verification/index.md b/docs/ko/projects/project-05-grounded-qa-verification/index.mdindex 5c96ef4..22c3448 100644--- a/docs/ko/projects/project-05-grounded-qa-verification/index.md+++ b/docs/ko/projects/project-05-grounded-qa-verification/index.md@@ -15,14 +15,14 @@## 저장소에 포함된 프로젝트 사용하기-저장소 경로: `projects/project-05/`+저장소 경로: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| 디렉터리 | 내용 | 비교할 것 ||------|------|------|-| `starter/` | Project 04 기반 앱이며 대화 기록 업그레이드 전 상태입니다. | 세 변형을 다시 실행할 때의 시작점. |-| `solution/single-role/` | 한 에이전트가 계획, 구현, 자기 평가를 모두 수행합니다. | `evaluator-rubric.md`의 점수와 결함. |-| `solution/gen-eval/` | generator + evaluator 구조이며 수정 증거가 있습니다. | `evaluator-rubric.md`의 점수와 revision notes. |-| `solution/plan-gen-eval/` | planner + generator + evaluator와 sprint contract가 있습니다. | `sprint-contract.md`와 `evaluator-rubric.md`의 높은 평가 증거. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | Project 04 기반 앱이며 대화 기록 업그레이드 전 상태입니다. | 세 변형을 다시 실행할 때의 시작점. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | 한 에이전트가 계획, 구현, 자기 평가를 모두 수행합니다. | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md)의 점수와 결함. |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | generator + evaluator 구조이며 수정 증거가 있습니다. | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md)의 점수와 revision notes. |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | planner + generator + evaluator와 sprint contract가 있습니다. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md)와 [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md)의 높은 평가 증거. |## 도구diff --git a/docs/ko/projects/project-06-runtime-observability-and-debugging/index.md b/docs/ko/projects/project-06-runtime-observability-and-debugging/index.mdindex 223b93e..8e1444f 100644--- a/docs/ko/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/ko/projects/project-06-runtime-observability-and-debugging/index.md@@ -15,12 +15,12 @@## 저장소에 포함된 프로젝트 사용하기-저장소 경로: `projects/project-06/`+저장소 경로: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| 디렉터리 | 내용 | 비교할 것 ||------|------|------|-| `starter/` | 제품 기능은 거의 완성되어 있지만 harness 표면은 의도적으로 약합니다. 기본 `AGENTS.md`만 있고 `feature_list.json`, `session-handoff.md`, clean-state checklist, benchmark/cleanup scripts가 없습니다. | 약한 harness baseline의 수동 관찰. |-| `solution/` | 완전한 harness: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, 품질/평가 문서와 scripts. | `projects/project-06/solution/scripts/benchmark.sh`와 `projects/project-06/solution/scripts/cleanup-scanner.sh`를 실행하고 품질 증거를 비교합니다. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | 제품 기능은 거의 완성되어 있지만 harness 표면은 의도적으로 약합니다. 기본 [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md)만 있고 `feature_list.json`, `session-handoff.md`, clean-state checklist, benchmark/cleanup scripts가 없습니다. | 약한 harness baseline의 수동 관찰. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | 완전한 harness: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), 품질/평가 문서와 scripts. | [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh)와 [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh)를 실행하고 품질 증거를 비교합니다. |## 도구diff --git a/docs/ru/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/ru/projects/project-01-baseline-vs-minimal-harness/index.mdindex b088e2f..0e9fd84 100644--- a/docs/ru/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/ru/projects/project-01-baseline-vs-minimal-harness/index.md@@ -26,11 +26,11 @@## Используйте проект, уже добавленный в репозиторий-Путь в репозитории: `projects/project-01/`+Путь в репозитории: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| Каталог | Что внутри | Как использовать / что сравнивать ||------|------|------|-| `starter/` | Запуск со слабым harness. Есть только `task-prompt.md` как описание задачи, без `AGENTS.md` и `feature_list.json`. | Дайте агенту prompt и измерьте, что он выполнит без дополнительной структуры. |-| `solution/` | Тот же срез продукта с явными harness-артефактами: `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json`, `claude-progress.md`. | Сравните, как правила и проверка делают ту же задачу конкретной и проверяемой. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | Запуск со слабым harness. Есть только [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) как описание задачи, без `AGENTS.md` и `feature_list.json`. | Дайте агенту prompt и измерьте, что он выполнит без дополнительной структуры. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | Тот же срез продукта с явными harness-артефактами: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md). | Сравните, как правила и проверка делают ту же задачу конкретной и проверяемой. |Четыре конкретные фичи: запуск окна, список документов, панель вопросов и ответов, создание локального каталога данных. Смотрите `solution/feature_list.json` для ожидаемых доказательств по каждой фиче.diff --git a/docs/ru/projects/project-02-agent-readable-workspace/index.md b/docs/ru/projects/project-02-agent-readable-workspace/index.mdindex 226ca6e..ff92122 100644--- a/docs/ru/projects/project-02-agent-readable-workspace/index.md+++ b/docs/ru/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@## Используйте проект из репозитория-Путь: `projects/project-02/`+Путь: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| Каталог | Что внутри | Что сравнивать ||------|------|------|-| `starter/` | Код Project 01, где импорт документов, детальная страница и persistence ещё не завершены. Документация есть, но она тоньше, и нет `session-handoff.md`. | Сколько контекста второй сессии агента приходится открывать заново. |-| `solution/` | Тот же срез продукта завершён; документы для передачи состояния находятся в `projects/project-02/solution/`, также есть `feature_list.json` и `session-handoff.md`. | Может ли новая сессия продолжить работу только по состоянию репозитория. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Код Project 01, где импорт документов, детальная страница и persistence ещё не завершены. Документация есть, но она тоньше, и нет `session-handoff.md`. | Сколько контекста второй сессии агента приходится открывать заново. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | Тот же срез продукта завершён; документы для передачи состояния находятся в [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution), также есть [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json) и [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md). | Может ли новая сессия продолжить работу только по состоянию репозитория. |## Инструментыdiff --git a/docs/ru/projects/project-03-multi-session-continuity/index.md b/docs/ru/projects/project-03-multi-session-continuity/index.mdindex f11c657..cbfa741 100644--- a/docs/ru/projects/project-03-multi-session-continuity/index.md+++ b/docs/ru/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@## Используйте проект из репозитория-Путь: `projects/project-03/`+Путь: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| Каталог | Что внутри | Что сравнивать ||------|------|------|-| `starter/` | Код Project 02, где indexing и Q&A с цитатами ещё не завершены. Есть начальный `feature_list.json`, но нет финальных файлов handoff/restart. | Теряет ли агент состояние или уходит ли в сторону между несколькими функциями. |-| `solution/` | Готовы chunking, metadata, статус index и Q&A с цитатами; есть `init.sh`, `session-handoff.md`, `claude-progress.md`, `clean-state-checklist.md`. | Есть ли доказательство проверки перед отметкой функции как готовой. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Код Project 02, где indexing и Q&A с цитатами ещё не завершены. Есть начальный [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json), но нет финальных файлов handoff/restart. | Теряет ли агент состояние или уходит ли в сторону между несколькими функциями. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | Готовы chunking, metadata, статус index и Q&A с цитатами; есть [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md). | Есть ли доказательство проверки перед отметкой функции как готовой. |## Инструментыdiff --git a/docs/ru/projects/project-04-incremental-indexing/index.md b/docs/ru/projects/project-04-incremental-indexing/index.mdindex 7daaa5e..9e80d25 100644--- a/docs/ru/projects/project-04-incremental-indexing/index.md+++ b/docs/ru/projects/project-04-incremental-indexing/index.md@@ -13,14 +13,14 @@## Используйте проект из репозитория-Путь: `projects/project-04/`+Путь: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| Каталог | Что внутри | Что сравнивать ||------|------|------|-| `starter/` | Код Project 03 со слабыми диагностическими сигналами. Встроенный дефект indexing может ломать chunking больших файлов; скрипта проверки архитектуры нет. | Как быстро агент находит причину без runtime-сигналов. |-| `solution/` | Структурированный logger, документы и скрипт архитектурных границ, исправленная логика chunking и `clean-state-checklist.md`. | Помогают ли logs и проверки границ исправлять быстрее и аккуратнее. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Код Project 03 со слабыми диагностическими сигналами. Встроенный дефект indexing может ломать chunking больших файлов; скрипта проверки архитектуры нет. | Как быстро агент находит причину без runtime-сигналов. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | Структурированный logger, документы и скрипт архитектурных границ, исправленная логика chunking и [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md). | Помогают ли logs и проверки границ исправлять быстрее и аккуратнее. |-Ключевые файлы: `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md`, `projects/project-04/solution/src/services/indexing-service.ts`.+Ключевые файлы: [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).## Инструментыdiff --git a/docs/ru/projects/project-05-grounded-qa-verification/index.md b/docs/ru/projects/project-05-grounded-qa-verification/index.mdindex 7213af5..6dd129f 100644--- a/docs/ru/projects/project-05-grounded-qa-verification/index.md+++ b/docs/ru/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@## Используйте проект из репозитория-Путь: `projects/project-05/`+Путь: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| Каталог | Что внутри | Что сравнивать ||------|------|------|-| `starter/` | Приложение на базе Project 04 до добавления истории диалога. | Стартовая точка для повторного запуска трёх вариантов. |-| `solution/single-role/` | Один агент планирует, реализует и сам себя оценивает. | Оценка и дефекты в `evaluator-rubric.md`. |-| `solution/gen-eval/` | Generator + evaluator с доказательствами правок. | Оценка и заметки ревизии в `evaluator-rubric.md`. |-| `solution/plan-gen-eval/` | Planner + generator + evaluator со sprint contract. | `sprint-contract.md` и более высокая оценка в `evaluator-rubric.md`. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | Приложение на базе Project 04 до добавления истории диалога. | Стартовая точка для повторного запуска трёх вариантов. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | Один агент планирует, реализует и сам себя оценивает. | Оценка и дефекты в [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md). |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | Generator + evaluator с доказательствами правок. | Оценка и заметки ревизии в [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md). |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | Planner + generator + evaluator со sprint contract. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) и более высокая оценка в [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md). |## Инструментыdiff --git a/docs/ru/projects/project-06-runtime-observability-and-debugging/index.md b/docs/ru/projects/project-06-runtime-observability-and-debugging/index.mdindex 3ca84c2..614dd73 100644--- a/docs/ru/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/ru/projects/project-06-runtime-observability-and-debugging/index.md@@ -13,12 +13,12 @@## Используйте проект из репозитория-Путь: `projects/project-06/`+Путь: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| Каталог | Что внутри | Что сравнивать ||------|------|------|-| `starter/` | Продукт почти готов, но harness намеренно ослаблен: базовый `AGENTS.md`, нет `feature_list.json`, `session-handoff.md`, clean-state checklist и benchmark/cleanup scripts. | Ручные наблюдения baseline со слабым harness. |-| `solution/` | Полный harness: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, quality/evaluator docs и scripts. | Запустить `projects/project-06/solution/scripts/benchmark.sh` и `projects/project-06/solution/scripts/cleanup-scanner.sh`, затем сравнить quality evidence. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | Продукт почти готов, но harness намеренно ослаблен: базовый [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md), нет `feature_list.json`, `session-handoff.md`, clean-state checklist и benchmark/cleanup scripts. | Ручные наблюдения baseline со слабым harness. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | Полный harness: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), quality/evaluator docs и scripts. | Запустить [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) и [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh), затем сравнить quality evidence. |## Инструментыdiff --git a/docs/tr/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/tr/projects/project-01-baseline-vs-minimal-harness/index.mdindex 9c16c90..233da52 100644--- a/docs/tr/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/tr/projects/project-01-baseline-vs-minimal-harness/index.md@@ -15,12 +15,12 @@ Kurs senaryosu kısa bir hazırlık veya yeniden keşif süresini örnek olarak## Depodaki projeyi kullanın-Depo yolu: `projects/project-01/`+Depo yolu: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| Dizin | İçerik | Nasıl kullanılır ||------|------|------|-| `starter/` | Zayıf harness sürümü; yalnızca `task-prompt.md` vardır, `AGENTS.md` veya `feature_list.json` yoktur. | Prompt'u coding agent'a verin ve ek yapı olmadan neleri tamamladığını ölçün. |-| `solution/` | Aynı ürün dilimi; ayrıca `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json`, `claude-progress.md` içerir. | Kuralların ve doğrulama kanıtlarının aynı görevi nasıl somutlaştırdığını karşılaştırın. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | Zayıf harness sürümü; yalnızca [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) vardır, `AGENTS.md` veya `feature_list.json` yoktur. | Prompt'u coding agent'a verin ve ek yapı olmadan neleri tamamladığını ölçün. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | Aynı ürün dilimi; ayrıca [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md) içerir. | Kuralların ve doğrulama kanıtlarının aynı görevi nasıl somutlaştırdığını karşılaştırın. |Dört somut özellik: pencerenin açılması, doküman listesi, Soru-Cevap paneli ve yerel veri dizini. Beklenen kanıt `solution/feature_list.json` içindedir.diff --git a/docs/tr/projects/project-02-agent-readable-workspace/index.md b/docs/tr/projects/project-02-agent-readable-workspace/index.mdindex 0e3e7a1..38548fe 100644--- a/docs/tr/projects/project-02-agent-readable-workspace/index.md+++ b/docs/tr/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@ Depoya "okunabilirlik" ekleyin; böylece yeni bir ajan proje yapısını hızla## Depodaki projeyi kullanın-Depo yolu: `projects/project-02/`+Depo yolu: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| Dizin | İçerik | Nasıl kullanılır ||------|------|------|-| `starter/` | Project 01 kodu; tamamlanmamış doküman içe aktarma, detay görünümü ve kalıcılık içerir. Dokümanlar vardır ama incedir; `session-handoff.md` yoktur. | İkinci agent oturumunun ne kadar bağlamı yeniden keşfetmesi gerektiğini ölçün. |-| `solution/` | Aynı ürün dilimini tamamlar ve `projects/project-02/solution/` altında çekirdek dokümanları, `feature_list.json` ve `session-handoff.md` dosyalarını ekler. | Yeni oturumun yalnızca depo durumuna bakarak çalışmaya devam edip edemediğini kontrol edin. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Project 01 kodu; tamamlanmamış doküman içe aktarma, detay görünümü ve kalıcılık içerir. Dokümanlar vardır ama incedir; `session-handoff.md` yoktur. | İkinci agent oturumunun ne kadar bağlamı yeniden keşfetmesi gerektiğini ölçün. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | Aynı ürün dilimini tamamlar ve [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) altında çekirdek dokümanları, [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json) ve [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md) dosyalarını ekler. | Yeni oturumun yalnızca depo durumuna bakarak çalışmaya devam edip edemediğini kontrol edin. |Ürün özellikleri doküman içe aktarma, tam detay/içerik yükleme ve yeniden başlatmalar arasında kalıcılıktır; harness özelliği ise devredilebilir, agent-readable workspace'tir.diff --git a/docs/tr/projects/project-03-multi-session-continuity/index.md b/docs/tr/projects/project-03-multi-session-continuity/index.mdindex fb6e7c2..e927176 100644--- a/docs/tr/projects/project-03-multi-session-continuity/index.md+++ b/docs/tr/projects/project-03-multi-session-continuity/index.md@@ -15,12 +15,12 @@ Bir `feature_list.json` gerekir; her özelliğin açık bir durumu olmalıdır.## Depodaki projeyi kullanın-Depo yolu: `projects/project-03/`+Depo yolu: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| Dizin | İçerik | Nasıl kullanılır ||------|------|------|-| `starter/` | Project 02 kodu; indeksleme ve alıntılı Soru-Cevap tamamlanmamıştır. Starter sürümü `feature_list.json` içerir ama son yeniden başlatma/devir artefaktları eksiktir. | Agent'ın birden çok özellik arasında kayıp kaymadığını ve yeniden başlatmadan sonra durumu kaybedip kaybetmediğini ölçün. |-| `solution/` | Doküman parçalama, üst veri, indeksleme durumu ve alıntılı Soru-Cevap tamamlanmıştır; ayrıca `init.sh`, `session-handoff.md`, `claude-progress.md`, `clean-state-checklist.md` eklenmiştir. | Her özelliğin ancak doğrulama kanıtı varsa `passing` olup olmadığını kontrol edin. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Project 02 kodu; indeksleme ve alıntılı Soru-Cevap tamamlanmamıştır. Starter sürümü [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json) içerir ama son yeniden başlatma/devir artefaktları eksiktir. | Agent'ın birden çok özellik arasında kayıp kaymadığını ve yeniden başlatmadan sonra durumu kaybedip kaybetmediğini ölçün. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | Doküman parçalama, üst veri, indeksleme durumu ve alıntılı Soru-Cevap tamamlanmıştır; ayrıca [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md) eklenmiştir. | Her özelliğin ancak doğrulama kanıtı varsa `passing` olup olmadığını kontrol edin. |## Araçlardiff --git a/docs/tr/projects/project-04-incremental-indexing/index.md b/docs/tr/projects/project-04-incremental-indexing/index.mdindex 563b633..46c308d 100644--- a/docs/tr/projects/project-04-incremental-indexing/index.md+++ b/docs/tr/projects/project-04-incremental-indexing/index.md@@ -15,14 +15,14 @@ Depodaki starter'da runtime bug'ı kasıtlı olarak bırakılmıştır; fakat ta## Depodaki projeyi kullanın-Depo yolu: `projects/project-04/`+Depo yolu: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| Dizin | İçerik | Nasıl kullanılır ||------|------|------|-| `starter/` | Project 03 kodu; tanılama sinyali zayıftır. Gömülü indexing hatası büyük dosya parçalamayı bozar ve mimari kontrol betiği yoktur. | Runtime sinyali yokken agent'ın kök nedeni ne kadar sürede bulduğunu ölçün. |-| `solution/` | Yapılandırılmış logger, mimari sınır dokümanı ve betiği, düzeltilmiş parçalama mantığı ve `clean-state-checklist.md`. | Logların ve sınır kontrollerinin düzeltmeyi hızlandırıp daha az yan etki üretip üretmediğini kontrol edin. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Project 03 kodu; tanılama sinyali zayıftır. Gömülü indexing hatası büyük dosya parçalamayı bozar ve mimari kontrol betiği yoktur. | Runtime sinyali yokken agent'ın kök nedeni ne kadar sürede bulduğunu ölçün. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | Yapılandırılmış logger, mimari sınır dokümanı ve betiği, düzeltilmiş parçalama mantığı ve [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md). | Logların ve sınır kontrollerinin düzeltmeyi hızlandırıp daha az yan etki üretip üretmediğini kontrol edin. |-Özellikle `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md` ve `projects/project-04/solution/src/services/indexing-service.ts` dosyalarına bakın.+Özellikle [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md) ve [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts) dosyalarına bakın.## Araçlardiff --git a/docs/tr/projects/project-05-grounded-qa-verification/index.md b/docs/tr/projects/project-05-grounded-qa-verification/index.mdindex f29e28a..8230642 100644--- a/docs/tr/projects/project-05-grounded-qa-verification/index.md+++ b/docs/tr/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@ Esaslı bir özellik yükseltmesi seçin (çok turlu konuşma, alıntı paneli y## Depodaki projeyi kullanın-Depo yolu: `projects/project-05/`+Depo yolu: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| Dizin | İçerik | Nasıl kullanılır ||------|------|------|-| `starter/` | ConversationHistory yükseltmesinden önceki Project 04 uygulaması. | Üç varyantı kendiniz yeniden çalıştırmak istiyorsanız buradan başlayın. |-| `solution/single-role/` | Tek agent planlar, uygular ve kendini değerlendirir. | `evaluator-rubric.md` içinde 1.6/5 puan ve hata listesi vardır. |-| `solution/gen-eval/` | Üretici + değerlendirici; revizyon kanıtı içerir. | `evaluator-rubric.md` içinde 3.3/5 puan ve revizyon kaydı vardır. |-| `solution/plan-gen-eval/` | Planlayıcı + üretici + değerlendirici. | `sprint-contract.md` ve `evaluator-rubric.md` içinde 4.9/5 puan vardır. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | ConversationHistory yükseltmesinden önceki Project 04 uygulaması. | Üç varyantı kendiniz yeniden çalıştırmak istiyorsanız buradan başlayın. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | Tek agent planlar, uygular ve kendini değerlendirir. | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md) içinde 1.6/5 puan ve hata listesi vardır. |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | Üretici + değerlendirici; revizyon kanıtı içerir. | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md) içinde 3.3/5 puan ve revizyon kaydı vardır. |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | Planlayıcı + üretici + değerlendirici. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) ve [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md) içinde 4.9/5 puan vardır. |Amaç, aynı ürün yükseltmesini üç farklı harness yapısıyla karşılaştırmaktır; rastgele farklı özellikler seçerseniz puanlar karşılaştırılamaz.diff --git a/docs/tr/projects/project-06-runtime-observability-and-debugging/index.md b/docs/tr/projects/project-06-runtime-observability-and-debugging/index.mdindex 6e419ca..ffa161d 100644--- a/docs/tr/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/tr/projects/project-06-runtime-observability-and-debugging/index.md@@ -13,12 +13,12 @@ Tüm ürün dilimini kapsayan sabit, çok özellikli bir görev seti kullanın:## Depodaki projeyi kullanın-Depo yolu: `projects/project-06/`+Depo yolu: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| Dizin | İçerik | Nasıl kullanılır ||------|------|------|-| `starter/` | Ürün kodunun çoğu tamamlanmıştır; fakat harness yüzeyi zayıftır: yalnızca temel `AGENTS.md` vardır, `feature_list.json`, `session-handoff.md` ve clean-state checklist yoktur. | Zayıf harness temelini elle kaydedin. Starter kasıtlı olarak benchmark betiği içermez. |-| `solution/` | Tam harness: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, kalite/değerlendirme dokümanları, benchmark ve cleanup betikleri. | `projects/project-06/solution/scripts/benchmark.sh` ve `projects/project-06/solution/scripts/cleanup-scanner.sh` çalıştırın; kalite dokümanı kanıtlarını karşılaştırın. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | Ürün kodunun çoğu tamamlanmıştır; fakat harness yüzeyi zayıftır: yalnızca temel [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md) vardır, `feature_list.json`, `session-handoff.md` ve clean-state checklist yoktur. | Zayıf harness temelini elle kaydedin. Starter kasıtlı olarak benchmark betiği içermez. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | Tam harness: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), kalite/değerlendirme dokümanları, benchmark ve cleanup betikleri. | [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) ve [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh) çalıştırın; kalite dokümanı kanıtlarını karşılaştırın. |Önceki projelerden farklı olarak capstone starter çok sayıda ürün özelliğinden yoksun değildir; ana eksik uygulamanın etrafındaki operasyonel harness'tır.diff --git a/docs/uz/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/uz/projects/project-01-baseline-vs-minimal-harness/index.mdindex d2d1f47..a5959ae 100644--- a/docs/uz/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/uz/projects/project-01-baseline-vs-minimal-harness/index.md@@ -26,11 +26,11 @@ Minimal harness: `AGENTS.md` + `init.sh` + `feature_list.json`## Repoga kiritilgan loyihadan foydalaning-Repo yo‘li: `projects/project-01/`+Repo yo‘li: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| Katalog | Nimalar bor | Qanday ishlatish / nimani taqqoslash ||------|------|------|-| `starter/` | Zaif harness yugurishi. Vazifa tavsifi sifatida faqat `task-prompt.md` bor, `AGENTS.md` yoki `feature_list.json` yo‘q. | Promptni agentga bering va qo‘shimcha tuzilmasiz nimalarni tugatishini o‘lchang. |-| `solution/` | Xuddi shu mahsulot kesimi, lekin aniq harness artefaktlari bilan: `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json`, `claude-progress.md`. | Qoidalar va tekshiruv bir xil vazifani qanday aniq va tekshiriladigan qiladi — taqqoslang. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | Zaif harness yugurishi. Vazifa tavsifi sifatida faqat [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) bor, `AGENTS.md` yoki `feature_list.json` yo‘q. | Promptni agentga bering va qo‘shimcha tuzilmasiz nimalarni tugatishini o‘lchang. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | Xuddi shu mahsulot kesimi, lekin aniq harness artefaktlari bilan: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md). | Qoidalar va tekshiruv bir xil vazifani qanday aniq va tekshiriladigan qiladi — taqqoslang. |4 ta aniq feature: oynani ishga tushirish, hujjatlar ro‘yxati, savol paneli va lokal ma’lumotlar katalogini yaratish. Har bir feature uchun kutiladigan evidence `solution/feature_list.json`da.diff --git a/docs/uz/projects/project-02-agent-readable-workspace/index.md b/docs/uz/projects/project-02-agent-readable-workspace/index.mdindex f9d5935..44c3d78 100644--- a/docs/uz/projects/project-02-agent-readable-workspace/index.md+++ b/docs/uz/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@ Siz buni ikki marta bajarasiz: birinchisi hech qanday yordamsiz, ikkinchisi repo## Repodagi tayyor loyihadan foydalaning-Repo yoʻli: `projects/project-02/`+Repo yoʻli: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| Katalog | Nimalar bor | Nimani taqqoslash ||------|------|------|-| `starter/` | Project 01 kodi, lekin hujjat importi, detail view va persistence hali toʻliq emas. Hujjatlar bor, ammo qisqaroq; `session-handoff.md` yoʻq. | Ikkinchi agent sessiyasi qancha kontekstni qayta topishi kerak. |-| `solution/` | Xuddi shu mahsulot kesimi tugallangan; handoff hujjatlari `projects/project-02/solution/` ostida, shuningdek `feature_list.json` va `session-handoff.md` bor. | Yangi sessiya faqat repo holatidan davom eta oladimi. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Project 01 kodi, lekin hujjat importi, detail view va persistence hali toʻliq emas. Hujjatlar bor, ammo qisqaroq; `session-handoff.md` yoʻq. | Ikkinchi agent sessiyasi qancha kontekstni qayta topishi kerak. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | Xuddi shu mahsulot kesimi tugallangan; handoff hujjatlari [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) ostida, shuningdek [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json) va [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md) bor. | Yangi sessiya faqat repo holatidan davom eta oladimi. |## Vositalardiff --git a/docs/uz/projects/project-03-multi-session-continuity/index.md b/docs/uz/projects/project-03-multi-session-continuity/index.mdindex b47a085..9a776bf 100644--- a/docs/uz/projects/project-03-multi-session-continuity/index.md+++ b/docs/uz/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@ Siz buni ikki marta bajarasiz: birinchisida hech qanday cheklovlarsiz, ikkinchis## Repodagi tayyor loyihadan foydalaning-Repo yoʻli: `projects/project-03/`+Repo yoʻli: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| Katalog | Nimalar bor | Nimani taqqoslash ||------|------|------|-| `starter/` | Project 02 kodi, indexing va citation-based Q&A hali tugallanmagan. Boshlangʻich `feature_list.json` bor, lekin yakuniy handoff/restart artefaktlari yoʻq. | Agent bir nechta feature orasida chalgʻiydimi yoki restartdan keyin holatni yoʻqotadimi. |-| `solution/` | Chunking, metadata, index status va citation-based Q&A tugallangan; `init.sh`, `session-handoff.md`, `claude-progress.md`, `clean-state-checklist.md` bor. | Har bir feature pass bo‘lishidan oldin aniq tekshiruv daliliga egami. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Project 02 kodi, indexing va citation-based Q&A hali tugallanmagan. Boshlangʻich [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json) bor, lekin yakuniy handoff/restart artefaktlari yoʻq. | Agent bir nechta feature orasida chalgʻiydimi yoki restartdan keyin holatni yoʻqotadimi. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | Chunking, metadata, index status va citation-based Q&A tugallangan; [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md) bor. | Har bir feature pass bo‘lishidan oldin aniq tekshiruv daliliga egami. |## Vositalardiff --git a/docs/uz/projects/project-04-incremental-indexing/index.md b/docs/uz/projects/project-04-incremental-indexing/index.mdindex 0ce497f..600bd10 100644--- a/docs/uz/projects/project-04-incremental-indexing/index.md+++ b/docs/uz/projects/project-04-incremental-indexing/index.md@@ -13,14 +13,14 @@ Siz buni ikki marta bajarasiz: birinchisida loglar va cheklovlarsiz, ikkinchisid## Repodagi tayyor loyihadan foydalaning-Repo yoʻli: `projects/project-04/`+Repo yoʻli: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| Katalog | Nimalar bor | Nimani taqqoslash ||------|------|------|-| `starter/` | Project 03 kodi, diagnostika signallari zaif. Kiritilgan indexing nuqsoni katta fayllar chunkingʼini buzishi mumkin; architecture check script yoʻq. | Runtime signallarsiz agent root causeʼni qancha vaqtda topadi. |-| `solution/` | Structured logger, architecture boundary hujjatlari va script, tuzatilgan chunking logic, `clean-state-checklist.md`. | Logs va boundary checks tuzatishni tezroq va kamroq xavfli qiladimi. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Project 03 kodi, diagnostika signallari zaif. Kiritilgan indexing nuqsoni katta fayllar chunkingʼini buzishi mumkin; architecture check script yoʻq. | Runtime signallarsiz agent root causeʼni qancha vaqtda topadi. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | Structured logger, architecture boundary hujjatlari va script, tuzatilgan chunking logic, [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md). | Logs va boundary checks tuzatishni tezroq va kamroq xavfli qiladimi. |-Tekshiriladigan fayllar: `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md`, `projects/project-04/solution/src/services/indexing-service.ts`.+Tekshiriladigan fayllar: [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).## Vositalardiff --git a/docs/uz/projects/project-05-grounded-qa-verification/index.md b/docs/uz/projects/project-05-grounded-qa-verification/index.mdindex ef5657e..b77c224 100644--- a/docs/uz/projects/project-05-grounded-qa-verification/index.md+++ b/docs/uz/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@ Diqqatga sazovor boʻlgan biror funksiya yangilanishini tanlang (koʻp bosqichli## Repodagi tayyor loyihadan foydalaning-Repo yoʻli: `projects/project-05/`+Repo yoʻli: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| Katalog | Nimalar bor | Nimani taqqoslash ||------|------|------|-| `starter/` | Project 04 asosidagi app, conversation history upgradeʼdan oldingi holat. | Uch variantni qayta ishga tushirish uchun boshlangʻich nuqta. |-| `solution/single-role/` | Bitta agent rejalaydi, implement qiladi va oʻzini baholaydi. | `evaluator-rubric.md`dagi ball va nuqsonlar. |-| `solution/gen-eval/` | Generator + evaluator, revision dalillari bor. | `evaluator-rubric.md`dagi ball va revision notes. |-| `solution/plan-gen-eval/` | Planner + generator + evaluator va sprint contract. | `sprint-contract.md` hamda `evaluator-rubric.md`dagi yuqoriroq baho dalillari. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | Project 04 asosidagi app, conversation history upgradeʼdan oldingi holat. | Uch variantni qayta ishga tushirish uchun boshlangʻich nuqta. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | Bitta agent rejalaydi, implement qiladi va oʻzini baholaydi. | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md)dagi ball va nuqsonlar. |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | Generator + evaluator, revision dalillari bor. | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md)dagi ball va revision notes. |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | Planner + generator + evaluator va sprint contract. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) hamda [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md)dagi yuqoriroq baho dalillari. |## Vositalardiff --git a/docs/uz/projects/project-06-runtime-observability-and-debugging/index.md b/docs/uz/projects/project-06-runtime-observability-and-debugging/index.mdindex ba3f3ed..14ae4db 100644--- a/docs/uz/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/uz/projects/project-06-runtime-observability-and-debugging/index.md@@ -13,12 +13,12 @@ Toʻliq mahsulot boʻlagini (product slice) qamrab oladigan qatʼiy koʻp funksi## Repodagi tayyor loyihadan foydalaning-Repo yoʻli: `projects/project-06/`+Repo yoʻli: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| Katalog | Nimalar bor | Nimani taqqoslash ||------|------|------|-| `starter/` | Mahsulot deyarli tayyor, lekin harness ataylab zaiflashtirilgan: faqat asosiy `AGENTS.md`, `feature_list.json`, `session-handoff.md`, clean-state checklist va benchmark/cleanup scripts yoʻq. | Zaif harness baselineʼini qoʻlda kuzatish. |-| `solution/` | Toʻliq harness: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, quality/evaluator docs va scripts. | `projects/project-06/solution/scripts/benchmark.sh` va `projects/project-06/solution/scripts/cleanup-scanner.sh`ni ishga tushirib, quality evidenceʼni taqqoslash. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | Mahsulot deyarli tayyor, lekin harness ataylab zaiflashtirilgan: faqat asosiy [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md), `feature_list.json`, `session-handoff.md`, clean-state checklist va benchmark/cleanup scripts yoʻq. | Zaif harness baselineʼini qoʻlda kuzatish. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | Toʻliq harness: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), quality/evaluator docs va scripts. | [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) va [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh)ni ishga tushirib, quality evidenceʼni taqqoslash. |## Vositalardiff --git a/docs/vi/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/vi/projects/project-01-baseline-vs-minimal-harness/index.mdindex 626cb6e..bbecd95 100644--- a/docs/vi/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/vi/projects/project-01-baseline-vs-minimal-harness/index.md@@ -26,11 +26,11 @@ Harness tối giản: `AGENTS.md` + `init.sh` + `feature_list.json`## Dùng project đã có sẵn trong repo-Đường dẫn trong repo: `projects/project-01/`+Đường dẫn trong repo: [`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| Thư mục | Có gì bên trong | Cách dùng / so sánh ||------|------|------|-| `starter/` | Lượt chạy harness yếu. Chỉ có `task-prompt.md` làm mô tả nhiệm vụ, không có `AGENTS.md` hay `feature_list.json`. | Đưa prompt cho agent và đo xem nó hoàn thành được gì khi không có cấu trúc bổ sung. |-| `solution/` | Cùng slice sản phẩm nhưng có artefact harness rõ ràng: `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json`, `claude-progress.md`. | So sánh cách quy tắc và kiểm chứng biến cùng nhiệm vụ thành thứ có thể chạy và kiểm tra được. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | Lượt chạy harness yếu. Chỉ có [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) làm mô tả nhiệm vụ, không có `AGENTS.md` hay `feature_list.json`. | Đưa prompt cho agent và đo xem nó hoàn thành được gì khi không có cấu trúc bổ sung. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | Cùng slice sản phẩm nhưng có artefact harness rõ ràng: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md). | So sánh cách quy tắc và kiểm chứng biến cùng nhiệm vụ thành thứ có thể chạy và kiểm tra được. |Bốn tính năng cụ thể là: mở cửa sổ, danh sách tài liệu, panel câu hỏi, và tạo thư mục dữ liệu cục bộ. Xem `solution/feature_list.json` để biết bằng chứng mong đợi cho từng tính năng.diff --git a/docs/vi/projects/project-02-agent-readable-workspace/index.md b/docs/vi/projects/project-02-agent-readable-workspace/index.mdindex 07b9c46..c815fa0 100644--- a/docs/vi/projects/project-02-agent-readable-workspace/index.md+++ b/docs/vi/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@ Bạn chạy hai lần: lần đầu không có sự trợ giúp nào, lần hai## Dùng project có sẵn trong repo-Đường dẫn repo: `projects/project-02/`+Đường dẫn repo: [`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| Thư mục | Nội dung | So sánh gì ||------|------|------|-| `starter/` | Code từ Project 01, nhưng import tài liệu, trang chi tiết và persistence vẫn chưa hoàn chỉnh. Tài liệu có nhưng mỏng hơn, và không có `session-handoff.md`. | Phiên agent thứ hai phải tự khám phá lại bao nhiêu ngữ cảnh. |-| `solution/` | Cùng phạm vi sản phẩm đã hoàn thành, có tài liệu handoff dưới `projects/project-02/solution/`, cùng `feature_list.json` và `session-handoff.md`. | Phiên mới có thể tiếp tục chỉ từ trạng thái repo hay không. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Code từ Project 01, nhưng import tài liệu, trang chi tiết và persistence vẫn chưa hoàn chỉnh. Tài liệu có nhưng mỏng hơn, và không có `session-handoff.md`. | Phiên agent thứ hai phải tự khám phá lại bao nhiêu ngữ cảnh. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | Cùng phạm vi sản phẩm đã hoàn thành, có tài liệu handoff dưới [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution), cùng [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json) và [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md). | Phiên mới có thể tiếp tục chỉ từ trạng thái repo hay không. |## Công cụdiff --git a/docs/vi/projects/project-03-multi-session-continuity/index.md b/docs/vi/projects/project-03-multi-session-continuity/index.mdindex 9bde8e5..f9049cf 100644--- a/docs/vi/projects/project-03-multi-session-continuity/index.md+++ b/docs/vi/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@ Bạn chạy hai lần: lần đầu không có ràng buộc, lần hai với th## Dùng project có sẵn trong repo-Đường dẫn repo: `projects/project-03/`+Đường dẫn repo: [`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| Thư mục | Nội dung | So sánh gì ||------|------|------|-| `starter/` | Code Project 02 với indexing và Q&A có citation vẫn chưa hoàn chỉnh. Có `feature_list.json` ban đầu nhưng chưa có artefact handoff/restart cuối cùng. | Agent có drift qua nhiều tính năng hoặc mất trạng thái sau restart không. |-| `solution/` | Chunking, metadata, index status và citation-based QA đã hoàn thành, thêm `init.sh`, `session-handoff.md`, `claude-progress.md`, `clean-state-checklist.md`. | Mỗi tính năng có bằng chứng kiểm chứng trước khi đánh dấu pass không. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Code Project 02 với indexing và Q&A có citation vẫn chưa hoàn chỉnh. Có [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json) ban đầu nhưng chưa có artefact handoff/restart cuối cùng. | Agent có drift qua nhiều tính năng hoặc mất trạng thái sau restart không. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | Chunking, metadata, index status và citation-based QA đã hoàn thành, thêm [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md), [`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md). | Mỗi tính năng có bằng chứng kiểm chứng trước khi đánh dấu pass không. |## Công cụdiff --git a/docs/vi/projects/project-04-incremental-indexing/index.md b/docs/vi/projects/project-04-incremental-indexing/index.mdindex 69e210d..8ce41cd 100644--- a/docs/vi/projects/project-04-incremental-indexing/index.md+++ b/docs/vi/projects/project-04-incremental-indexing/index.md@@ -13,14 +13,14 @@ Bạn chạy hai lần: lần đầu không có log hoặc ràng buộc, lần h## Dùng project có sẵn trong repo-Đường dẫn repo: `projects/project-04/`+Đường dẫn repo: [`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| Thư mục | Nội dung | So sánh gì ||------|------|------|-| `starter/` | Code Project 03 với tín hiệu chẩn đoán yếu. Lỗi indexing được cài sẵn có thể làm hỏng chunking file lớn, và không có script kiểm tra kiến trúc. | Agent mất bao lâu để tìm root cause khi thiếu runtime signals. |-| `solution/` | Structured logger, tài liệu/script ranh giới kiến trúc, logic chunking đã sửa và `clean-state-checklist.md`. | Logs và boundary checks có giúp sửa nhanh hơn, ít xâm lấn hơn không. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Code Project 03 với tín hiệu chẩn đoán yếu. Lỗi indexing được cài sẵn có thể làm hỏng chunking file lớn, và không có script kiểm tra kiến trúc. | Agent mất bao lâu để tìm root cause khi thiếu runtime signals. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | Structured logger, tài liệu/script ranh giới kiến trúc, logic chunking đã sửa và [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md). | Logs và boundary checks có giúp sửa nhanh hơn, ít xâm lấn hơn không. |-File cần xem: `projects/project-04/solution/src/services/logger.ts`, `projects/project-04/solution/scripts/check-architecture.sh`, `projects/project-04/solution/docs/ARCHITECTURE.md`, `projects/project-04/solution/src/services/indexing-service.ts`.+File cần xem: [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts), [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh), [`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md), [`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts).## Công cụdiff --git a/docs/vi/projects/project-05-grounded-qa-verification/index.md b/docs/vi/projects/project-05-grounded-qa-verification/index.mdindex 3487dcf..593548b 100644--- a/docs/vi/projects/project-05-grounded-qa-verification/index.md+++ b/docs/vi/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@ Chọn một tính năng nâng cấp thực chất (hội thoại đa lượt, t## Dùng project có sẵn trong repo-Đường dẫn repo: `projects/project-05/`+Đường dẫn repo: [`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| Thư mục | Nội dung | So sánh gì ||------|------|------|-| `starter/` | Ứng dụng dựa trên Project 04 trước khi nâng cấp lịch sử hội thoại. | Điểm bắt đầu nếu muốn chạy lại ba biến thể. |-| `solution/single-role/` | Một agent tự lập kế hoạch, triển khai và tự đánh giá. | Điểm số và lỗi trong `evaluator-rubric.md`. |-| `solution/gen-eval/` | Generator + evaluator, có bằng chứng sửa đổi. | Điểm số và revision notes trong `evaluator-rubric.md`. |-| `solution/plan-gen-eval/` | Planner + generator + evaluator với sprint contract. | `sprint-contract.md` và bằng chứng điểm cao hơn trong `evaluator-rubric.md`. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | Ứng dụng dựa trên Project 04 trước khi nâng cấp lịch sử hội thoại. | Điểm bắt đầu nếu muốn chạy lại ba biến thể. |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | Một agent tự lập kế hoạch, triển khai và tự đánh giá. | Điểm số và lỗi trong [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md). |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | Generator + evaluator, có bằng chứng sửa đổi. | Điểm số và revision notes trong [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md). |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | Planner + generator + evaluator với sprint contract. | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) và bằng chứng điểm cao hơn trong [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md). |## Công cụdiff --git a/docs/vi/projects/project-06-runtime-observability-and-debugging/index.md b/docs/vi/projects/project-06-runtime-observability-and-debugging/index.mdindex 02401ed..f3e61a9 100644--- a/docs/vi/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/vi/projects/project-06-runtime-observability-and-debugging/index.md@@ -13,12 +13,12 @@ Sử dụng một bộ tác vụ đa tính năng cố định bao phủ toàn b## Dùng project có sẵn trong repo-Đường dẫn repo: `projects/project-06/`+Đường dẫn repo: [`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| Thư mục | Nội dung | So sánh gì ||------|------|------|-| `starter/` | Sản phẩm gần như hoàn chỉnh, nhưng harness bị cố ý làm yếu: chỉ có `AGENTS.md` cơ bản, không có `feature_list.json`, `session-handoff.md`, clean-state checklist hay benchmark/cleanup scripts. | Ghi nhận thủ công baseline với harness yếu. |-| `solution/` | Harness đầy đủ: `AGENTS.md`, `CLAUDE.md`, `feature_list.json`, `init.sh`, `session-handoff.md`, `clean-state-checklist.md`, tài liệu chất lượng/đánh giá và scripts. | Chạy `projects/project-06/solution/scripts/benchmark.sh` và `projects/project-06/solution/scripts/cleanup-scanner.sh`, rồi so sánh bằng chứng chất lượng. |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | Sản phẩm gần như hoàn chỉnh, nhưng harness bị cố ý làm yếu: chỉ có [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md) cơ bản, không có `feature_list.json`, `session-handoff.md`, clean-state checklist hay benchmark/cleanup scripts. | Ghi nhận thủ công baseline với harness yếu. |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | Harness đầy đủ: [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md), [`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md), [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json), [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh), [`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md), [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md), tài liệu chất lượng/đánh giá và scripts. | Chạy [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh) và [`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh), rồi so sánh bằng chứng chất lượng. |## Công cụdiff --git a/docs/zh-TW/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/zh-TW/projects/project-01-baseline-vs-minimal-harness/index.mdindex 9b74216..97842d1 100644--- a/docs/zh-TW/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/zh-TW/projects/project-01-baseline-vs-minimal-harness/index.md@@ -13,12 +13,12 @@## 使用倉庫內建專案-倉庫路徑:`projects/project-01/`+倉庫路徑:[`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| 目錄 | 內容 | 怎麼用 / 比較什麼 ||------|------|------|-| `starter/` | 弱 harness 版本。只有 `task-prompt.md` 作為任務描述,沒有 `AGENTS.md` 或 `feature_list.json`。 | 把 prompt 交給 coding agent,量測它在沒有額外結構時完成了什麼。 |-| `solution/` | 相同的產品切片,但加入明確的 harness 產物:`AGENTS.md`、`CLAUDE.md`、`init.sh`、`feature_list.json`、`claude-progress.md`。 | 對照規則與驗證證據如何把同一任務變得可執行、可驗收。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | 弱 harness 版本。只有 [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md) 作為任務描述,沒有 `AGENTS.md` 或 `feature_list.json`。 | 把 prompt 交給 coding agent,量測它在沒有額外結構時完成了什麼。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | 相同的產品切片,但加入明確的 harness 產物:[`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md)、[`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md)、[`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh)、[`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json)、[`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md)。 | 對照規則與驗證證據如何把同一任務變得可執行、可驗收。 |四個具體功能是:視窗啟動、文件清單、問答面板、本地資料目錄建立。每個功能的預期證據請看 `solution/feature_list.json`。diff --git a/docs/zh-TW/projects/project-02-agent-readable-workspace/index.md b/docs/zh-TW/projects/project-02-agent-readable-workspace/index.mdindex a40ce78..319d02e 100644--- a/docs/zh-TW/projects/project-02-agent-readable-workspace/index.md+++ b/docs/zh-TW/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@ P01 證明了準備規則有用。但 P01 的任務一次會話就幹完了。## 使用倉庫內建專案-倉庫路徑:`projects/project-02/`+倉庫路徑:[`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| 目錄 | 內容 | 比較什麼 ||------|------|------|-| `starter/` | 基於 Project 01 solution 的代碼,但導入/詳情/持久化仍未完整;文檔更薄,且缺少 `session-handoff.md`。 | 新開會話時,agent 需要做多少重新探索才能接上進度。 |-| `solution/` | 同一產品切片已完成,並在 `projects/project-02/solution/` 下補齊核心文檔(以及 `feature_list.json`、`session-handoff.md`)等可接手產物。 | 只依靠倉庫狀態,能否快速續寫而不靠口頭上下文。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | 基於 Project 01 solution 的代碼,但導入/詳情/持久化仍未完整;文檔更薄,且缺少 `session-handoff.md`。 | 新開會話時,agent 需要做多少重新探索才能接上進度。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | 同一產品切片已完成,並在 [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) 下補齊核心文檔(以及 [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json)、[`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md))等可接手產物。 | 只依靠倉庫狀態,能否快速續寫而不靠口頭上下文。 |## 用什麼工具diff --git a/docs/zh-TW/projects/project-03-multi-session-continuity/index.md b/docs/zh-TW/projects/project-03-multi-session-continuity/index.mdindex 07f9365..422bef9 100644--- a/docs/zh-TW/projects/project-03-multi-session-continuity/index.md+++ b/docs/zh-TW/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@ P02 解決了"接手"的問題,但 agent 接手之後能不能把活幹完、## 使用倉庫內建專案-倉庫路徑:`projects/project-03/`+倉庫路徑:[`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| 目錄 | 內容 | 比較什麼 ||------|------|------|-| `starter/` | Project 02 代碼基礎上,索引與 grounded QA 尚未完善;有初版 `feature_list.json`,但缺少最終的重啟/交接與乾淨狀態產物。 | 多次重啟/多功能任務下,agent 是否漂移、是否丟狀態。 |-| `solution/` | 完整的 chunking、metadata、indexing status、citation-based QA,並補齊 `init.sh`、`session-handoff.md`、`claude-progress.md`、`clean-state-checklist.md`。 | 是否能做到“一次只做一個功能”,且每個功能都有可執行證據才標記通過。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Project 02 代碼基礎上,索引與 grounded QA 尚未完善;有初版 [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json),但缺少最終的重啟/交接與乾淨狀態產物。 | 多次重啟/多功能任務下,agent 是否漂移、是否丟狀態。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | 完整的 chunking、metadata、indexing status、citation-based QA,並補齊 [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh)、[`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md)、[`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md)、[`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md)。 | 是否能做到“一次只做一個功能”,且每個功能都有可執行證據才標記通過。 |## 用什麼工具diff --git a/docs/zh-TW/projects/project-04-incremental-indexing/index.md b/docs/zh-TW/projects/project-04-incremental-indexing/index.mdindex 5736dc3..56f93e8 100644--- a/docs/zh-TW/projects/project-04-incremental-indexing/index.md+++ b/docs/zh-TW/projects/project-04-incremental-indexing/index.md@@ -13,12 +13,12 @@## 使用倉庫內建專案-倉庫路徑:`projects/project-04/`+倉庫路徑:[`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| 目錄 | 內容 | 比較什麼 ||------|------|------|-| `starter/` | Project 03 代碼,但診斷較弱;存在一個種子缺陷,可能導致大文件 chunking/索引失敗;也沒有架構檢查腳本。 | 沒有運行時信號時,定位根因需要多久、改動是否擴散。 |-| `solution/` | 結構化 logger、架構邊界文檔與腳本、修復 chunking/索引邏輯,並補齊 `clean-state-checklist.md`。 | 有日誌與邊界檢查後,修復是否更快、更可控、可復現。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Project 03 代碼,但診斷較弱;存在一個種子缺陷,可能導致大文件 chunking/索引失敗;也沒有架構檢查腳本。 | 沒有運行時信號時,定位根因需要多久、改動是否擴散。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | 結構化 logger、架構邊界文檔與腳本、修復 chunking/索引邏輯,並補齊 [`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md)。 | 有日誌與邊界檢查後,修復是否更快、更可控、可復現。 |## 用什麼工具diff --git a/docs/zh-TW/projects/project-05-grounded-qa-verification/index.md b/docs/zh-TW/projects/project-05-grounded-qa-verification/index.mdindex dc4f54f..2c86c35 100644--- a/docs/zh-TW/projects/project-05-grounded-qa-verification/index.md+++ b/docs/zh-TW/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@## 使用倉庫內建專案-倉庫路徑:`projects/project-05/`+倉庫路徑:[`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| 目錄 | 內容 | 比較什麼 ||------|------|------|-| `starter/` | 基於 Project 04 的應用,尚未做 ConversationHistory(多輪對話歷史)升級。 | 若你要自己重跑三種變體,從這裡開始。 |-| `solution/single-role/` | 單角色:同一個 agent 規劃/實作/自查。 | `evaluator-rubric.md` 低分與缺陷清單。 |-| `solution/gen-eval/` | 生成者 + 評估者:有修訂與回饋證據。 | `evaluator-rubric.md` 分數與 revision 記錄。 |-| `solution/plan-gen-eval/` | 規劃者 + 生成者 + 評估者:有 sprint contract。 | `sprint-contract.md` 與 `evaluator-rubric.md` 高分證據。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | 基於 Project 04 的應用,尚未做 ConversationHistory(多輪對話歷史)升級。 | 若你要自己重跑三種變體,從這裡開始。 |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | 單角色:同一個 agent 規劃/實作/自查。 | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md) 低分與缺陷清單。 |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | 生成者 + 評估者:有修訂與回饋證據。 | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md) 分數與 revision 記錄。 |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | 規劃者 + 生成者 + 評估者:有 sprint contract。 | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md) 與 [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md) 高分證據。 |## 用什麼工具diff --git a/docs/zh-TW/projects/project-06-runtime-observability-and-debugging/index.md b/docs/zh-TW/projects/project-06-runtime-observability-and-debugging/index.mdindex b97dec3..059f4b3 100644--- a/docs/zh-TW/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/zh-TW/projects/project-06-runtime-observability-and-debugging/index.md@@ -11,12 +11,12 @@## 使用倉庫內建專案-倉庫路徑:`projects/project-06/`+倉庫路徑:[`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| 目錄 | 內容 | 怎麼用 / 比較什麼 ||------|------|------|-| `starter/` | 產品功能基本完整,但 harness 表面刻意削弱(只有基礎 `AGENTS.md`,沒有 `feature_list.json` / `session-handoff.md` / `clean-state-checklist.md`,也沒有 benchmark/cleanup 腳本)。 | 手動記錄弱 harness 基線行為(錯誤定位速度、是否過早宣告完成等)。 |-| `solution/` | 最大化 harness:`AGENTS.md`、`CLAUDE.md`、`feature_list.json`、`init.sh`、`session-handoff.md`、`clean-state-checklist.md`、品質/評估文檔、benchmark 與 cleanup 腳本。 | 在 `projects/project-06/solution/` 下跑 `./scripts/benchmark.sh` 與 `./scripts/cleanup-scanner.sh`,再對照品質文檔證據。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | 產品功能基本完整,但 harness 表面刻意削弱(只有基礎 [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md),沒有 `feature_list.json` / `session-handoff.md` / `clean-state-checklist.md`,也沒有 benchmark/cleanup 腳本)。 | 手動記錄弱 harness 基線行為(錯誤定位速度、是否過早宣告完成等)。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | 最大化 harness:[`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md)、[`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md)、[`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json)、[`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh)、[`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md)、[`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md)、品質/評估文檔、benchmark 與 cleanup 腳本。 | 在 [`projects/project-06/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) 下跑 `./scripts/benchmark.sh` 與 `./scripts/cleanup-scanner.sh`,再對照品質文檔證據。 |## 用什麼工具diff --git a/docs/zh/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/zh/projects/project-01-baseline-vs-minimal-harness/index.mdindex 1ecb68e..a951b49 100644--- a/docs/zh/projects/project-01-baseline-vs-minimal-harness/index.md+++ b/docs/zh/projects/project-01-baseline-vs-minimal-harness/index.md@@ -13,12 +13,12 @@## 使用仓库里的项目-仓库路径:`projects/project-01/`+仓库路径:[`projects/project-01/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01)| 目录 | 里面有什么 | 怎么用 ||------|------|------|-| `starter/` | 弱 harness 版本,只有 `task-prompt.md`,没有 `AGENTS.md` 或 `feature_list.json`。 | 把 prompt 给 coding agent,测量它在没有额外结构时完成了什么。 |-| `solution/` | 同一个产品切片,加上 `AGENTS.md`、`CLAUDE.md`、`init.sh`、`feature_list.json`、`claude-progress.md`。 | 对照规则和验证证据如何把同一任务具体化。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/starter) | 弱 harness 版本,只有 [`task-prompt.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/starter/task-prompt.md),没有 `AGENTS.md` 或 `feature_list.json`。 | 把 prompt 给 coding agent,测量它在没有额外结构时完成了什么。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-01/solution) | 同一个产品切片,加上 [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/AGENTS.md)、[`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/CLAUDE.md)、[`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/init.sh)、[`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/feature_list.json)、[`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-01/solution/claude-progress.md)。 | 对照规则和验证证据如何把同一任务具体化。 |四个具体功能是窗口启动、文档列表、问答面板、本地数据目录。预期证据见 `solution/feature_list.json`。diff --git a/docs/zh/projects/project-02-agent-readable-workspace/index.md b/docs/zh/projects/project-02-agent-readable-workspace/index.mdindex e6e8343..59ccb9a 100644--- a/docs/zh/projects/project-02-agent-readable-workspace/index.md+++ b/docs/zh/projects/project-02-agent-readable-workspace/index.md@@ -13,12 +13,12 @@ P01 证明了准备规则有用。但 P01 的任务一次会话就干完了。## 使用仓库里的项目-仓库路径:`projects/project-02/`+仓库路径:[`projects/project-02/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02)| 目录 | 里面有什么 | 比较什么 ||------|------|------|-| `starter/` | Project 01 代码,加上未完成的文档导入、详情视图、持久化。文档存在但较薄,没有 `session-handoff.md`。 | 第二个 agent 会话要重新发现多少上下文。 |-| `solution/` | 完成同一产品切片,并在 `projects/project-02/solution/` 下补齐核心文档(以及 `feature_list.json`、`session-handoff.md`)。 | 新会话能否只靠仓库状态继续工作。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/starter) | Project 01 代码,加上未完成的文档导入、详情视图、持久化。文档存在但较薄,没有 `session-handoff.md`。 | 第二个 agent 会话要重新发现多少上下文。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) | 完成同一产品切片,并在 [`projects/project-02/solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-02/solution) 下补齐核心文档(以及 [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/feature_list.json)、[`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-02/solution/session-handoff.md))。 | 新会话能否只靠仓库状态继续工作。 |产品功能是文档导入、完整详情/内容加载、跨重启持久化;harness 功能是可交接的 agent-readable workspace。diff --git a/docs/zh/projects/project-03-multi-session-continuity/index.md b/docs/zh/projects/project-03-multi-session-continuity/index.mdindex 524f25a..f3bacae 100644--- a/docs/zh/projects/project-03-multi-session-continuity/index.md+++ b/docs/zh/projects/project-03-multi-session-continuity/index.md@@ -13,12 +13,12 @@ P02 解决了"接手"的问题,但 agent 接手之后能不能把活干完、## 使用仓库里的项目-仓库路径:`projects/project-03/`+仓库路径:[`projects/project-03/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03)| 目录 | 里面有什么 | 比较什么 ||------|------|------|-| `starter/` | Project 02 代码,索引和带引用问答未完成。有 starter 版 `feature_list.json`,但缺少最终重启/交接产物。 | agent 是否跨多个功能漂移,重启后是否丢状态。 |-| `solution/` | 完成文档分块、元数据、索引状态、带引用问答,并加入 `init.sh`、`session-handoff.md`、`claude-progress.md`、`clean-state-checklist.md`。 | 每个功能是否有验证证据后才标为 passing。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/starter) | Project 02 代码,索引和带引用问答未完成。有 starter 版 [`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/starter/feature_list.json),但缺少最终重启/交接产物。 | agent 是否跨多个功能漂移,重启后是否丢状态。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-03/solution) | 完成文档分块、元数据、索引状态、带引用问答,并加入 [`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/init.sh)、[`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/session-handoff.md)、[`claude-progress.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/claude-progress.md)、[`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-03/solution/clean-state-checklist.md)。 | 每个功能是否有验证证据后才标为 passing。 |本项目对应的产品功能不是泛泛的"多会话",而是文档分块、元数据提取、索引状态 UI、带引用问答。diff --git a/docs/zh/projects/project-04-incremental-indexing/index.md b/docs/zh/projects/project-04-incremental-indexing/index.mdindex 669df5b..373fedc 100644--- a/docs/zh/projects/project-04-incremental-indexing/index.md+++ b/docs/zh/projects/project-04-incremental-indexing/index.md@@ -13,14 +13,14 @@## 使用仓库里的项目-仓库路径:`projects/project-04/`+仓库路径:[`projects/project-04/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04)| 目录 | 里面有什么 | 比较什么 ||------|------|------|-| `starter/` | Project 03 代码,诊断信号较弱。植入的 indexing 缺陷会让大文件分块异常,并且没有架构检查脚本。 | 没有运行时信号时,agent 多久能找到根因。 |-| `solution/` | 结构化 logger、架构边界文档和脚本、修复后的分块逻辑、`clean-state-checklist.md`。 | 日志和边界检查是否让修复更快、更少破坏。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/starter) | Project 03 代码,诊断信号较弱。植入的 indexing 缺陷会让大文件分块异常,并且没有架构检查脚本。 | 没有运行时信号时,agent 多久能找到根因。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-04/solution) | 结构化 logger、架构边界文档和脚本、修复后的分块逻辑、[`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/clean-state-checklist.md)。 | 日志和边界检查是否让修复更快、更少破坏。 |-重点检查 `projects/project-04/solution/src/services/logger.ts`、`projects/project-04/solution/scripts/check-architecture.sh`、`projects/project-04/solution/docs/ARCHITECTURE.md`、`projects/project-04/solution/src/services/indexing-service.ts`。+重点检查 [`projects/project-04/solution/src/services/logger.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/logger.ts)、[`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh)、[`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md)、[`projects/project-04/solution/src/services/indexing-service.ts`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/src/services/indexing-service.ts)。## 用什么工具@@ -53,7 +53,7 @@切到 `p04-improved` 分支。在启动 agent 之前,先在仓库里准备好:- **运行时日志**:对照 solution 的 `src/services/logger.ts`,启动、导入、索引、问答失败路径都有结构化日志。-- **架构约束**:对照 solution 的 `AGENTS.md`、`projects/project-04/solution/docs/ARCHITECTURE.md` 和 `projects/project-04/solution/scripts/check-architecture.sh`,明确 Electron 四层边界(main / preload / renderer / services)。+- **架构约束**:对照 solution 的 `AGENTS.md`、[`projects/project-04/solution/docs/ARCHITECTURE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/docs/ARCHITECTURE.md) 和 [`projects/project-04/solution/scripts/check-architecture.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-04/solution/scripts/check-architecture.sh),明确 Electron 四层边界(main / preload / renderer / services)。- **干净状态要求**:最终交付前必须能干净重启。然后启动 agent:diff --git a/docs/zh/projects/project-05-grounded-qa-verification/index.md b/docs/zh/projects/project-05-grounded-qa-verification/index.mdindex 50fa291..80683c0 100644--- a/docs/zh/projects/project-05-grounded-qa-verification/index.md+++ b/docs/zh/projects/project-05-grounded-qa-verification/index.md@@ -13,14 +13,14 @@## 使用仓库里的项目-仓库路径:`projects/project-05/`+仓库路径:[`projects/project-05/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05)| 目录 | 里面有什么 | 比较什么 ||------|------|------|-| `starter/` | ConversationHistory 升级前的 Project 04 应用。 | 如果要自己重跑三种变体,从这里开始。 |-| `solution/single-role/` | 一个 agent 规划、实现、自评。 | `evaluator-rubric.md` 评分 1.6/5 和缺陷列表。 |-| `solution/gen-eval/` | 生成者 + 评估者,有修订证据。 | `evaluator-rubric.md` 评分 3.3/5 和修订记录。 |-| `solution/plan-gen-eval/` | 规划者 + 生成者 + 评估者。 | `sprint-contract.md`、`evaluator-rubric.md` 评分 4.9/5。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/starter) | ConversationHistory 升级前的 Project 04 应用。 | 如果要自己重跑三种变体,从这里开始。 |+| [`solution/single-role/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/single-role) | 一个 agent 规划、实现、自评。 | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/single-role/evaluator-rubric.md) 评分 1.6/5 和缺陷列表。 |+| [`solution/gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/gen-eval) | 生成者 + 评估者,有修订证据。 | [`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/gen-eval/evaluator-rubric.md) 评分 3.3/5 和修订记录。 |+| [`solution/plan-gen-eval/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-05/solution/plan-gen-eval) | 规划者 + 生成者 + 评估者。 | [`sprint-contract.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/sprint-contract.md)、[`evaluator-rubric.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-05/solution/plan-gen-eval/evaluator-rubric.md) 评分 4.9/5。 |已提交的固定功能是多轮问答历史。重跑时保持功能不变,唯一变量是角色分工。diff --git a/docs/zh/projects/project-06-runtime-observability-and-debugging/index.md b/docs/zh/projects/project-06-runtime-observability-and-debugging/index.mdindex 41261ba..77d95b9 100644--- a/docs/zh/projects/project-06-runtime-observability-and-debugging/index.md+++ b/docs/zh/projects/project-06-runtime-observability-and-debugging/index.md@@ -11,12 +11,12 @@## 使用仓库里的项目-仓库路径:`projects/project-06/`+仓库路径:[`projects/project-06/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06)| 目录 | 里面有什么 | 比较什么 ||------|------|------|-| `starter/` | 大部分产品代码已经完成,但 harness 表面较弱:只有基础 `AGENTS.md`,没有 `feature_list.json`、`session-handoff.md`、clean-state checklist。 | 手动记录弱 harness 基线。starter 故意不包含 benchmark 脚本。 |-| `solution/` | 完整 harness:`AGENTS.md`、`CLAUDE.md`、`feature_list.json`、`init.sh`、`session-handoff.md`、`clean-state-checklist.md`、质量/评估文档、benchmark 和 cleanup 脚本。 | 运行 `projects/project-06/solution/scripts/benchmark.sh`、`projects/project-06/solution/scripts/cleanup-scanner.sh`,对比质量文档证据。 |+| [`starter/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/starter) | 大部分产品代码已经完成,但 harness 表面较弱:只有基础 [`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/starter/AGENTS.md),没有 `feature_list.json`、`session-handoff.md`、clean-state checklist。 | 手动记录弱 harness 基线。starter 故意不包含 benchmark 脚本。 |+| [`solution/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/projects/project-06/solution) | 完整 harness:[`AGENTS.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/AGENTS.md)、[`CLAUDE.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/CLAUDE.md)、[`feature_list.json`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/feature_list.json)、[`init.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/init.sh)、[`session-handoff.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/session-handoff.md)、[`clean-state-checklist.md`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/clean-state-checklist.md)、质量/评估文档、benchmark 和 cleanup 脚本。 | 运行 [`projects/project-06/solution/scripts/benchmark.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/benchmark.sh)、[`projects/project-06/solution/scripts/cleanup-scanner.sh`](https://github.com/walkinglabs/learn-harness-engineering/blob/main/projects/project-06/solution/scripts/cleanup-scanner.sh),对比质量文档证据。 |和前几个项目不同,capstone starter 不是缺很多产品功能;主要缺口是应用周围的操作 harness。