寫得越長越安心，機器人卻讀得越少
一開始因為不安，我把所有內容都寫進 CLAUDE.md：語氣、資料夾位置、禁止事項，連過去的失誤紀錄也放進去，共 130 行。結果每天早上，Claude Code 都會再問一次明明寫過的內容，像是「這個資料夾要放哪裡？」，平均每天 7 次。
說明書拼的不是長度，而是前 40 行的密度。
為期一週的實驗
我用兩個版本跑同類型的工作。Windows 環境用長版本，Mac mini 用短版本。短版本的做法如下：
1. 把規則分成「一定要」「偶爾用」「僅供紀錄」三格。
2. 只把「一定要」的規則留在 40 行以內。
3. 其餘搬到 docs 資料夾的獨立檔案，正文只留一行檔案位置。
結果
• 回問次數：每天平均從 7 次降到 2 次
• 同樣失誤再次發生：明顯減少（紀錄檔只在需要時才打開）
• 修改說明書的時間：行數少，修改也變快
今天就能照做
# 專案規則（40 行以內）
一定要
• 回答使用韓文
• 刪除檔案前先詢問
詳細內容在這裡
• 語氣指南：docs/voice.md
• 過去失誤紀錄：docs/incidents.md
再補一點
目前進度或狀態最好不要寫進說明書。狀態很快就過時，一旦混入過時的句子，機器人就會相信舊資訊。說明書只放結構與規則，今天要做的事，直接在對話中告訴它就好。