写得越长越安心，机器人却读得越少
一开始因为不安，我把所有内容都写进了 CLAUDE.md：语气、文件夹位置、禁止事项，连过去的失误记录也放进去，一共 130 行。结果每天早上，Claude Code 都会再问一遍明明写过的内容，比如「这个文件夹要放哪里？」，平均每天 7 次。
说明书拼的不是长度，而是前 40 行的密度。
为期一周的实验
我用两个版本跑同类型的工作。Windows 环境用长版本，Mac mini 用短版本。短版本的做法如下：
1. 把规则分成「一定要」「偶尔用」「仅作记录」三格。
2. 只把「一定要」的规则留在 40 行以内。
3. 其余的挪到 docs 文件夹的独立文件里，正文只留一行文件位置。
结果
• 回问次数：每天平均从 7 次降到 2 次
• 同样的失误再次发生：明显减少（记录文件只在需要时才打开）
• 修改说明书的时间：行数少了，改起来也更快
今天就能照着做
# 项目规则（40 行以内）
一定要
• 回答使用韩文
• 删除文件前先询问
详细内容在这里
• 语气指南：docs/voice.md
• 过去失误记录：docs/incidents.md
再补充一点
当前进度或状态最好不要写进说明书。状态很快就会过时，一旦混进过时的句子，机器人就会相信旧信息。说明书只放结构和规则，今天要做的事，直接在对话里告诉它就行。