基準證據包
在加入 scaffolding 前跑同一個固定任務，分清模型、脈絡、狀態、控制與回饋問題。
產出: 基準 receipt、任務合約與第一項介入決策。
給軟體工程師、技術主管與開發平台負責人
Harness Engineering 實戰
讓 coding agent 看得懂 repository、驗得出結果、斷線後接得回來，也交得出去。
11 個實作模組，持續改造同一套棕地應用程式。你會完成任務合約、repository 知識、隔離環境、持久狀態、agent 可讀回饋、機械式邊界、評測、復原，以及是否擴大自治的證據決策。
打開單元 00- 產出
- 一套量過成效的 repository harness，包含指令、狀態、隔離、機械式規則、端到端驗收、run receipt、交接，以及寫清楚適用範圍的 go／no-go 決策。
- 投入時間
- 25 到 30 小時，包含 5 到 7 小時總整專案
- 開始前先準備
- 需熟悉 Git、終端機、TypeScript 或其他有型別的語言、自動化測試與本機應用程式除錯。所有 lab 只用合成 fixture 與 sandbox 環境。
基礎 → 實作 → 專案
照順序走，也可以從卡關處進場。
每一課都會做出一份成果，用可觀察的條件驗收，再把它帶到下一個決策。你可以從目前卡住的地方開始，也可以完整走完。
- 00先診斷 harness 缺口：量完基準再加 scaffolding讓 coding agent 在未改造的 repository 完成一次有限任務，保存完整證據，再判斷問題落在意圖、可讀性、持續性、控制或回饋。基礎 · 75 分鐘
- 01把需求鎖成 executable task contract把模糊需求改寫成有範圍、權限、可觀察行為、禁止效果、預算、證據與停止條件的版本化合約。實作 · 100 分鐘
- 02把 repository 變成 system of record將架構、入口、指令、權限、資料流、驗收與 owner 留在版本控制裡，讓全新 session 不靠口耳相傳也能找到正確工作面。實作 · 110 分鐘
- 03建立可重現且隔離的工作環境用單一 initializer 驗依賴、migration、fixture、登入與 browser 路徑，並替每個 worktree 隔離 port、資料、cache、log、截圖與程序。實作 · 125 分鐘
- 04把工作狀態留在 repository：全新 context 也接得回來把 feature 狀態、證據、blocker、Git 關係與下一步外部化，讓新 session 不讀舊 transcript 也能延續正確工作。實作 · 115 分鐘
- 05替 agent 設計看得懂的回饋工具把雜訊很多的 command 與不透明 browser failure 改成窄工具，回傳穩定代碼、有限 evidence 與一個安全修復方向。實作 · 120 分鐘
- 06把重要邊界改成機械式規則將反覆出現的架構、權限、secret、generated file 與修改範圍要求，改成快速、穩定且附 repair path 的 executable checks。實作 · 130 分鐘
- 07建立 verification loop：驗行為、證據與節制將 task contract 變成分層 evaluator，同時檢查 diff、真實使用路徑、failure case、receipt 與禁止效果，再建立完成。實作 · 150 分鐘
- 08讓迴圈可觀測、有預算，也真的能復原記錄 state、tools、checks、成本、進度與 effects，讓無人看守的工作能在卡住或中斷時安全停止，再從 authoritative checkpoint 接回。實作 · 145 分鐘
- 09先畫 work graph，再談平行與 entropy在啟動多個 worker 前先定 dependency、ownership 與 conflict zone，量完整 coordination cost，並持續抓 stale instructions、maps、fixtures 與 exceptions。專案 · 165 分鐘
- 10總整專案：改造棕地 repository，替自治決策負責將完整 harness 套到未見過的功能，從 clean environment 重現證據，只留下量得出價值的層，最後提出有範圍的 autonomy 決策。專案 · 5 到 7 小時
動手完成的專案
用成果證明你真的能把系統運作起來。
Agent 可讀的 repository
做好知識地圖、固定 initializer、隔離 worktree 資源與全新 session 交接。
產出: Repository map、啟動 receipt、feature ledger 與乾淨交接。
驗證控制平面
暴露執行回饋、執行架構與權限規則、評分真實使用路徑，並在有限邊界內復原。
產出: 機械式規則、eval suite、trace、預算與復原 runbook。
棕地 harness 總整
把整套 harness 用在未見過的功能，沒有量出價值的層就移除。
產出: Repository harness kit、Harness Card、前後比較與 go／no-go 決策。
當本機 harness 要接進真實 repository
帶著 receipt、失敗案例，以及那條還拿不準的控制邊界來。
在團隊拉長 agent 自治時間前，Tenten 可以一起檢查 repository 可讀性、權限、evaluator 涵蓋、worktree 隔離、復原與上線證據。