クロードコードエージェントは自動的にプロジェクトドキュメントを読みません

Claude Codeエージェントがプロジェクトドキュメントをどのように扱うか

Claude Codeのエージェントシステムを扱う際、開発者はサブエージェントがプロジェクトドキュメントにアクセスする方法における特定の制限に注意する必要があります。r/ClaudeAIからのユーザーレポートによると、Claude Codeがコーディングタスクを処理するためにエージェントをディスパッチする場合、それらのエージェントは限られたコンテキストで動作します。

ソースからの重要な詳細

この問題は、エージェントが文書化された落とし穴に繰り返し遭遇したデバッグセッション中に発見されました。文書化された警告を無視した理由を尋ねられた際、エージェントは次のように回答しました：「コールバックを書く前にCLAUDE.mdを読みませんでした。探索フェーズからコードベースのパターンをプロンプトコンテキストとして持っていましたが、OAuthルートを書くためにSonnetエージェントをディスパッチした際、エージェントプロンプトには構築すべき内容が記述されており、確認すべき落とし穴については記述されていませんでした。」

エージェントはさらに明確にしました：「Sonnetサブエージェントは、私がプロンプトに入れた内容しか認識しません。特に指示がない限り、CLAUDE.md、MEMORY.md、またはプロジェクトコンテキストを自動的に読み込むことはありません。」

実用的な影響

• Sonnetのようなサブエージェントは、特定のプロンプトで提供されたコンテキストのみで動作します
• プロジェクトドキュメントファイル（CLAUDE.md、MEMORY.md）は自動的に読み込まれません
• 特に指示がない限り、エージェントは既存の落とし穴リストを参照せずに一からコードを書きます
• これにより、回避可能だった文書化された問題をエージェントが繰り返す可能性があります

この動作は、開発者が特定のコーディングタスクを処理するためにエージェントをディスパッチする際、ドキュメント参照を含めることを明示的に行う必要があることを意味します。エージェントは探索フェーズからコードベースのパターンを維持しますが、プロジェクト固有のドキュメントファイルを自動的に参照することはありません。