YAML Frontmatter 控制 Context — Agent 掃標頭決定要不要讀全文

在每個檔案開頭加 YAML Frontmatter，描述這個檔案的職責與依賴。Agent 只需掃標頭就能判斷這個檔案是否與當前任務相關，不需要讀全文，大幅省 token。

搭配兩個配套做法效果更好：一是結構化報錯（讓 Agent 回傳 JSON 格式的診斷資訊，而不是自然語言），錯誤更好追蹤；二是骨架先行（先生成 interface 和型別定義，確認架構對了再填實作），避免寫到一半發現方向錯。

這三者組合起來是大型 codebase 中控制 Agent 行為成本的核心技巧之一。