その具体、書くほどAIを迷わせてる ── CLAUDE.mdをスマートにする、たった一つの基準

AIコーディングエージェント（Claude Codeなど）に渡す指示書（CLAUDE.md、AGENTS.md）の書き方について、コンテキスト効率性の観点から、タスク固有のワークフローをカスタムコマンドやサブエージェントに分散させる方法を提案。指示書を「小さく、具体的に、育てる」アプローチを推奨する。

• AIエージェントへの指示書（CLAUDE.md）には、抽象的な情報と、グラウンディング元のある具体的な情報を書くべきだと提案する。
• 具体的な情報でも、package.jsonのようにAIが参照できる一次情報があれば、指示書には「その情報の在り処」を示す道標を書けばよい。
• グラウンディング元がない、AIが推測できない固有の意図や規範は、具体のまま指示書に書く必要がある。
• 指示書に書くべき基準は、「抽象か具体か」ではなく「AIが辿れる一次情報があるか」である。
• 具体的すぎる指示は、AIの推論を妨げ、ハルシネーションを誘発する可能性がある。