エージェント初出 8/11 01:16
CLAUDE.md の書き方 — 指示を書いても守られないので、hook 57本に移した話
https://zenn.dev/topics/ai/feed2026/8/11
AI要約
CLAUDE.mdに指示を書いても守られないため、hookに移した。120日運用で最も効果があったのは書くのをやめたこと。指示は強制力を持たず、守らせたいルールはhookへ移行。実測値と失敗例を提示。
AI要点
- CLAUDE.mdは「お願い」であり、強制力を持たせるにはhookへの移管が必要。
- CLAUDE.mdの指示は長くなるほど無視されやすくなり、200行以下に抑えるべき。
- ルールを「references」「CLAUDE.md/rules」「hook」の3階層に分け、強制力を変える。
- 「破られたときに取り返しがつかないか」がhookへの移管基準となる。
- 計測されていないルールは存在しないものとみなし、指標策定と計測実装はセットで行うべき。
なぜ重要か
AIエージェントへの指示が守られない問題に対し、指示の強制力と管理方法を階層化・具体化する実践的なアプローチを提示しており、AI指示の有効性向上に寄与します。