CLAUDE.md 與記憶

這一集真正要解的是 root 檔為什麼會失控

很多團隊一開始很認真，什麼都想寫進 `CLAUDE.md`。結果寫著寫著，最重要的檔案反而變成最難讀的檔案。問題不是大家不夠自律，而是把不同層的東西都塞進同一個入口。只要入口一變胖，大家就會開始跳過它，真正重要的規則反而消失。

所以這一集不是單純講 `CLAUDE.md` 本身，而是講記憶層次。你要分清楚什麼是 durable policy、什麼是局部穩定規則、什麼是可重用細節、什麼又只是 session continuity。這四種東西工作不同，寫法也不同。

一句話定義

`CLAUDE.md` 是長期政策面，memory 是續航層。前者回答「規則是什麼」，後者回答「上次做到哪裡」。兩者都重要，但不能互相代替。

只要你把這句話記住，後面很多判斷會簡單很多。因為你不會再把「聊天中暫時講到的決定」誤當成正式規則，也不會把真正要長期存在的治理內容只留在某一輪 thread 裡。

root file 應該長什麼樣子

root `CLAUDE.md` 最重要的特性不是完整，而是可掃描。它應該短、穩、可快速理解。你打開它，應該馬上看到這個 repo 最重要的原則，而不是一整本操作手冊。因為真正需要的不是把所有細節都放在門口，而是讓人先知道這棟系統最重要的邏輯。

細節如果越來越多，就應該往下拆。子目錄長期都要守的規則，交給 nested `CLAUDE.md`。很多地方都會重用的規則片段，交給 `@import`。而那些只是這一輪工作需要延續的上下文，應該寫進 handoff 或 memory，不要回頭污染政策入口。

nested 與 import 的邊界

nested `CLAUDE.md` 在講的是範圍。某個子樹自己長期都要守哪些穩定規則，這件事應該讓那個子樹自己承接。這樣 root 不需要知道所有局部例外。

`@import` 講的是重用。如果同一套文件規則、語氣規則、安全規則會在多處重複出現，那就把它抽成片段重用。這樣主檔可以維持清楚，也不會因為 copy-paste 讓多份內容慢慢漂掉。

memory 和政策為什麼不能混

這件事一定要講得很乾脆。memory 不是政策來源。它的工作是讓 session 不會整段斷掉，讓你知道重要決策、工作線索、上次做到哪裡。可是它不是正式法條。只要你把 memory 當規則來源，團隊就會開始不知道哪一份檔案才算 authoritative。

真正重要的治理內容，最後一定要有 file-backed home。否則你今天記得，明天 compact 一次、換個人接手一次，整條脈絡就會開始失真。

三個最常見反模式

• 根檔過胖。 每一個例外都往 root 塞，最後沒有任何人願意讀完。
• 把續航當規則。 上一輪對話裡講過的東西，直接被當成正式政策。
• 多層互相打架。 root、nested、memory 都有類似內容，但沒有人知道哪一份算數。

團隊落地做法

Research 先把官方機制定義清楚，Architecture 決定 root 放什麼、往下拆什麼、哪些只該存在於 handoff。Content 再把這套結構講成人能理解的東西，Instructor 維持穩定語氣，Distribution 則確保公開頁、音訊和講義說的是同一件事。這樣一來，記憶層次就不只是文件整理，而是整個內容系統的續航設計。