✅ 結論先講（你可以直接照做）

CLAUDE.md 一定要放在「專案根目錄（repository root）」

而且要跟 README.md、package.json 同一層。

✅ 正確位置（強烈建議）

my-project/
├─ CLAUDE.md        ← 就放這裡（不能藏）
├─ README.md
├─ package.json
├─ pnpm-lock.yaml
├─ src/
├─ docs/
└─ specs/

老實說，這套做法不是一開始就規劃好的。

它是很多次多人協作、反覆改需求、處理 merge conflict，

以及一次又一次看到「明明專案裡已經有現成做法，卻還是重寫一套」之後，慢慢逼出來的。

最後我得到一個很直接的結論：

真正拖慢專案的，從來不是寫程式， 而是不斷重來、不斷修正理解、不斷重複造輪子。

為什麼我要把協作方式「寫成 CLAUDE.md」？

在多人協作裡，最耗能的事情通常不是技術，而是這些狀況：

• 每個人對「應該怎麼做」的理解不同
• 改需求時，很難快速判斷影響範圍
• Code review 變成在討論風格、習慣，而不是問題本身
• 同樣的提醒，要一再重複對人、對 AI 說

如果這些原則只靠默契或對話傳遞，它一定會失真。

所以我選擇把它們寫成一份 CLAUDE.md，