ブラウンフィールドのコードベースでLLM性能を2倍に引き上げるコンテキスト圧縮実践ガイド

単にプロンプトをうまく書くだけでは、レガシーコードが魔法のように修正されることはありません。複雑に絡み合ったブラウンフィールド（Legacy）環境でAIエージェントが惨めに失敗する真の理由は、知能不足ではなくコンテキスト汚染にあります。モデルの記憶ストレージであるコンテキストウィンドウに不要なノイズが蓄積されると、論理的な一貫性は砂の城のように崩れ去ります。

トランスフォーマーアーキテクチャベースのモデルの性能は、コンテキスト活用度が**40%から60%を超えると急激に低下します。2026年現在、業界ではこれをAIスロップ（Slop）**と呼んでいます。動くだけでメンテナンス不可能なゴミコードを量産する現象のことです。もしあなたがAIの生成物を修正するために多くの時間を費やしているなら、あなたは開発者ではなく、AIの後始末をするハネスエンジニア（Harness Engineer）に成り下がっているのです。

意図的な圧縮のためのマークダウンアーキテクチャ

ビデオで語られる要約は始まりに過ぎません。大規模システムでは構造的圧縮が不可欠です。単に対話の長さを短くするのではなく、LLMが最も速く正確にパースできるマークダウン階層構造を活用し、情報密度を最大化する必要があります。

実際の研究データによると、マークダウン形式を適用したプロンプトは、単純なJSONと比較して推論精度が7.3%以上高く現れます。シニアアーキテクトは次の3つの要素を通じて、モデルの注意（Attention）メカニズムを制御します。

• <context> タグ: 現在のタスクの背景とグラウンドトゥルース（Ground Truth）を明示します。
• <constraint> タグ: モデルが勝手に設計を変更できないよう防ぐハードガードレールを設定します。
• 階層的ヘッダー (#, ##): 情報の階層を設定し、指示事項の認知率を高めます。

この圧縮プロセスは手動であってはなりません。先進的なチームは Git Hook やCI/CDパイプラインにコンテキスト更新スクリプトを組み込んでいます。エージェントが特定のステップを終えてコミットするたびに、変更事項を要約して PROGRESS.md に記録し、セッションを初期化します。モデルを常に40%未満の最適活用区間に閉じ込めておく技術です。

RPIフレームワークとサブエージェント戦略

RPI（Research, Plan, Implement）は単なるフローチャートではありません。各段階ごとに独立したコンテキストセッションを割り当て、ノイズを物理的に遮断する隔離戦略です。

1. Research: サブエージェントに単純作業を任せろ

メインエージェントに数万行のファイルを直接読ませないでください。ファイルのスキャンはサブエージェントの役割です。サブエージェントが数千のファイルを調べてコアロジックの位置だけを精製して返せば、メインエージェントはトークンの浪費なく、精緻な推論だけに集中できます。

2. Plan & Implement: 承認ゲートとハネス設計

計画段階では「何をすべきか」ではなく「何をしないか（Non-goals）」を設定することが肝要です。実装時には Git Worktree を使用し、エージェントの実験がメインブランチを汚染しないよう隔離された環境を提供する必要があります。

評価指標	RPI適用前	RPI適用後	向上指数
機能実装あたりの欠陥（Bug）数	12.5個	3.8個	69.6% 減少
コードレビュー承認速度	平均48時間	平均8時間	83% 向上
エージェント単独作業成功率	18%	79%	338% 向上

ローカルLLMで構築するデータ主権

企業の核心資産であるソースコードを外部APIに無分別に投げる時代は終わりました。2025年以降の業界標準は、Llama 3やMistralのようなオープンソースモデルを社内インフラに直接構築することです。

この方式は単にセキュリティのためだけではありません。研究段階で発生する膨大なコードスキャン費用を数千ドル以上節約できます。機密性の低い初期探索はローカルLLMが実行し、高度な設計が必要な部分だけ機密情報をマスキングした上で、高性能なクローズドモデル（Claude 3.5など）に委任するハイブリッドアーキテクチャが最も効率的です。

事例研究: 50万行規模のJava/Springレガシー近代化

ドキュメント一つない10年物の決済システムにRPIフレームワークを適用した結果は驚くべきものでした。Hibernateの依存関係が複雑に絡み合った環境において、新規エンジニアのオンボーディング期間は90日から35日へと61%短縮されました。

エージェントが各モジュールを探索して得た情報をマークダウン形式のアーキテクチャガイドとして圧縮し、リポジトリ内に「生きているドキュメント（Living Document）」として残したためです。これはRPIが個人のツールを超え、チーム全体の知識転送システムとして機能することを示しています。

実戦導入チェックリスト

2026年のエンジニアリング組織の競争力は、どれだけ多くのコードを書くかではなく、どれだけ信頼できるエージェント環境を構築したかにかかっています。

• プロジェクトルートに CLAUDE.md を作成し、核心的なガイドラインを記述したか。
• コンテキスト使用量が40%を超えないよう、自動圧縮トリガーを設定したか。
• エージェントの計画を人間のアーキテクトが検討する承認ゲートが存在するか。
• 修正されたコードに対する静的解析がハネス層で自動実行されるか。

コンテキストエンジニアリングは、人工知能を制御してあなたの思考の成果物を数万倍に増幅させる唯一の方法です。今すぐエージェントの環境から再設計してください。