Skip to content

Harness engineering beginner tutorial, from 0 to 1

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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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. |
## Werkzeuge
diff --git a/docs/de/projects/project-04-incremental-indexing/index.md b/docs/de/projects/project-04-incremental-indexing/index.md
index 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).
## Werkzeuge
diff --git a/docs/de/projects/project-05-grounded-qa-verification/index.md b/docs/de/projects/project-05-grounded-qa-verification/index.md
index 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). |
## Werkzeuge
diff --git a/docs/de/projects/project-06-runtime-observability-and-debugging/index.md b/docs/de/projects/project-06-runtime-observability-and-debugging/index.md
index 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. |
## Werkzeuge
diff --git a/docs/en/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/en/projects/project-01-baseline-vs-minimal-harness/index.md
index 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, and
local data directory creation. Inspect `solution/feature_list.json` for the
diff --git a/docs/en/projects/project-02-agent-readable-workspace/index.md b/docs/en/projects/project-02-agent-readable-workspace/index.md
index 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-readable
diff --git a/docs/en/projects/project-03-multi-session-continuity/index.md b/docs/en/projects/project-03-multi-session-continuity/index.md
index 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 solution
maps 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.md
index 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.md
index 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 feature
constant 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.md
index 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 product
features. 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.md
index 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.md
index 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.md
index 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. |
## Herramientas
diff --git a/docs/es/projects/project-04-incremental-indexing/index.md b/docs/es/projects/project-04-incremental-indexing/index.md
index 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).
## Herramientas
diff --git a/docs/es/projects/project-05-grounded-qa-verification/index.md b/docs/es/projects/project-05-grounded-qa-verification/index.md
index 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). |
## Herramientas
diff --git a/docs/es/projects/project-06-runtime-observability-and-debugging/index.md b/docs/es/projects/project-06-runtime-observability-and-debugging/index.md
index 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. |
## Herramientas
diff --git a/docs/fr/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/fr/projects/project-01-baseline-vs-minimal-harness/index.md
index 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.md
index 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. |
## Outils
diff --git a/docs/fr/projects/project-03-multi-session-continuity/index.md b/docs/fr/projects/project-03-multi-session-continuity/index.md
index 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. |
## Outils
diff --git a/docs/fr/projects/project-04-incremental-indexing/index.md b/docs/fr/projects/project-04-incremental-indexing/index.md
index 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).
## Outils
diff --git a/docs/fr/projects/project-05-grounded-qa-verification/index.md b/docs/fr/projects/project-05-grounded-qa-verification/index.md
index 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). |
## Outils
diff --git a/docs/fr/projects/project-06-runtime-observability-and-debugging/index.md b/docs/fr/projects/project-06-runtime-observability-and-debugging/index.md
index 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é. |
## Outils
diff --git a/docs/ja/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/ja/projects/project-01-baseline-vs-minimal-harness/index.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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çlar
diff --git a/docs/tr/projects/project-04-incremental-indexing/index.md b/docs/tr/projects/project-04-incremental-indexing/index.md
index 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çlar
diff --git a/docs/tr/projects/project-05-grounded-qa-verification/index.md b/docs/tr/projects/project-05-grounded-qa-verification/index.md
index 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.md
index 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.md
index 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.md
index 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. |
## Vositalar
diff --git a/docs/uz/projects/project-03-multi-session-continuity/index.md b/docs/uz/projects/project-03-multi-session-continuity/index.md
index 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. |
## Vositalar
diff --git a/docs/uz/projects/project-04-incremental-indexing/index.md b/docs/uz/projects/project-04-incremental-indexing/index.md
index 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).
## Vositalar
diff --git a/docs/uz/projects/project-05-grounded-qa-verification/index.md b/docs/uz/projects/project-05-grounded-qa-verification/index.md
index 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. |
## Vositalar
diff --git a/docs/uz/projects/project-06-runtime-observability-and-debugging/index.md b/docs/uz/projects/project-06-runtime-observability-and-debugging/index.md
index 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. |
## Vositalar
diff --git a/docs/vi/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/vi/projects/project-01-baseline-vs-minimal-harness/index.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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。