先月、認証ミドルウェアのセッションタイムアウトのバグを修正するようにClaude Codeに依頼しました。簡単な作業ですよね？修正はたった3行でした。ところが、Claudeは修正に取りかかる前に、ログシステム全体、データベースの移行履歴、APIエンドポイントの半分、そしてなぜかTerraformの設定ファイルまで読み込んでしまったのです。

ファイル147でEscキーを押しました。

問題はClaudeにあったのではなく、私のプロジェクト構造にあった。あらゆる規約、ビルドコマンド、そしてアーキテクチャ上の決定事項を、たった1つのルートCLAUDE.mdファイルに詰め込んでしまっていたのだ。Claudeは起動時に340行すべてを忠実に読み込み、残りのコンテキスト予算を認証とは全く関係のないコードの探索に費やしてしまった。