なぜ開発者にコンテキスト管理を教えないのか？
本記事はエージェント工学とAI駆動開発に関するシリーズの第6回であり、コンテキスト管理がAI開発において見過ごされている重要なスキルであると強調する。著者は、開発者はAIの記憶能力を過大評価する一方で、そのオーケストレーション能力を過小評価し、時間の浪費と出力品質の低下を招いていると指摘する。開発コンテキストをファイル（例：DEVELOPMENT_CONTEXT.md）に外部化し、継続的に更新することで、AIセッションの効率と一貫性が大幅に向上する。また、意思決定の背後にある理由を含めることで、AIが意図的な設計選択を誤って取り消すのを防ぐことができる。
AI駆動開発の分野において、コンテキスト管理は過小評価されている中核的なスキルである。O'Reilly Mediaの記事は、プロンプトエンジニアリング、モデル選択、エージェントワークフロー、ツール使用法が盛んに議論される一方で、AIセッションの出力品質を実際に決定する要因であるコンテキスト管理がほとんど語られていないと指摘する。
著者は、開発者がAIに対して二重の誤解を抱いていると考える。すなわち、AIの記憶容量を過大評価し、多くの情報をコンテキストウィンドウに詰め込んでAIがうまく処理すると期待する一方で、オーケストレーターとしての能力を過小評価し、マルチステップのワークフローを与えることを怠る。この誤解が典型的なサイクルを生む：開発者はコンテキストウィンドウを無限と見なし、すべてを詰め込む。セッションが長くなりAIが情報を見失い始めると、すべてを破棄して新たに開始する。彼らは、ワークフローを設計してAIが外部ファイルを基に独立したセッションを横断して作業する代替案を考慮しない。
著者は自身のプロジェクトを例に、コンテキスト外部化の実践法を示す。Octobatch（バッチLLMオーケストレーター）の構築において、彼はAIに各フォルダに開発コンテキストを書き込ませた。例えば、ai_context/DEVELOPMENT_CONTEXT.mdというファイルである。新しいClaude Codeセッションは「ai_context/DEVELOPMENT_CONTEXT.mdを読み、開発を継続するためにブートストラップせよ」という一行の指示で始まる。このファイルには読み込みシーケンスが含まれており、サブシステムごとのCONTEXT.mdファイルへと展開される。これにより、AIはプロジェクトの内容、構築方法、現在の進行状況、アクティブなバグを即座に把握する。
さらに重要なのは、コンテキストファイルに各決定の背後にある「理由」を含めることである。OctobatchのDEVELOPMENT_CONTEXT.mdには「重要な技術的学習」というセクションがあり、49のエントリが特定の形式で記録されている：何が起こったか、なぜ重要か、いつ発見したか、コードのどこに適用されるか。セクションの先頭には太字で「重要：各学習には常に推論（「なぜ」）を含めること。これにより将来のセッションが意図的な決定を「リファクタリング」するのを防ぐ」と記されている。この注意書きがなければ、AIは過去の意図的な選択を無意識に取り消してしまう。
著者は、コンテキスト管理の基本は、タスクごとにAIがコンテキストファイルを継続的に書き込み更新するよう指示することだと強調する。コミット前にAIにコンテキストファイルをレビューさせ、最新の変更を反映させる。古くなったコンテキストは古いドキュメントと同様に有害であり、それ以上に悪いのはAIがそれを頼りに判断することである。良いDEVELOPMENT_CONTEXT.mdのあるフォルダで新しいセッションを始めると、AIは即座に整合する。一方、それがなければAIはすべてをゼロから再発見しなければならず、再発見は常に損失を伴う。
著者は次回の記事で、Quality PlaybookとOctobatchの構築から得た4つの具体的な実践を提供すると予告している。本記事では問題の所在に焦点を当てている：なぜコンテキスト管理が重要なのか、そしてコンテキストの喪失がAIの出力品質にどのように影響するのか。