04:52 — Repo as system of record for agents
Source: Article, Learn Harness Engineering Lecture 03 (zh-TW), 為什麼儲存庫必須成為 system of record
Source URL: https://walkinglabs.github.io/learn-harness-engineering/zh-TW/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/
What I Read / Saw
- 原則 2：用標準化入口檔案。AGENTS.md（或 CLAUDE.md）是 agent 的「著陸頁」，必須讓 agent 快速回答「這是什麼專案」、「怎麼跑」、「怎麼驗證」，50-100 行就夠。
- 刪掉某條規則若不影響 agent 的決策品質，這條規則就不該存在。
- 參考結構：根目錄
AGENTS.md（專案概覽、執行命令、硬約束）、各層ARCHITECTURE.md/CONSTRAINTS.md、PROGRESS.md（做了什麼、在做什麼、被什麼阻塞）、Makefile（setup、test、lint、check）。 - 用 ACID 原則管理 agent 狀態。
- 「冷啟動測試」：全新工作階段只看儲存庫，能否回答五個基本問題。
- 知識衰減是最大敵人：過時的文件比沒有文件更危險。
My Take
這是撰寫 CLAUDE.md 和 AGENTS.md 的重點：入口檔保持精簡，只放能影響決策的規則，細節分層放到各目錄的 ARCHITECTURE / CONSTRAINTS，進度另外放 PROGRESS.md。用冷啟動測試定期檢查 repo，並防止文件過時。
Connections
05:28 — Context anxiety and agent state persistence
Source: Article, Learn Harness Engineering Lecture 05 (zh-TW), 為什麼長時間任務會失去連續性
Source URL: https://walkinglabs.github.io/learn-harness-engineering/zh-TW/lectures/lecture-05-why-long-running-tasks-lose-continuity/
What I Read / Saw
- Anthropic 的長執行 agent 研究發現「脈絡焦慮」（Context Anxiety）：agent 覺得脈絡快滿時會過早收斂，匆忙結束工作、跳過驗證，或選簡單方案而非最優方案。
- 狀態持久化四個工具：
PROGRESS.md：最基本的連續性工件。DECISIONS.md：記錄決策、原因與時間，不需要詳細設計文件。- git commit 當檢查點：每完成一個原子工作單元就提交，message 寫清楚做了什麼和為什麼。
init.sh或 harness 初始化流程：在 AGENTS.md 寫明每天「上班」和「下班」的流程。
My Take
脈絡焦慮的解法是把狀態存在檔案和 git 裡，不靠 context 記憶，這樣 agent 不必因為怕 context 滿而趕工。可以用在 vault 的 skill：長流程（例如批次 analyze-vault）每個原子單元完成就 commit，並留下進度檔。