Claude Codeのコンテキスト膨張でトークン溶かしまくりに悩まされた結果、MCPサーバーを作って解決した話

Claude Codeで個人開発をしていると、毎朝セッションを開くたびに同じ説明をやり直す羽目になる。昨日決めた設計方針が頭に入っていない。却下した実装方式を何度も採用される。命名規則も守られない。これはAIの根本的な弱点――セッションを跨ぐと文脈を忘れることだ。個人開発なら「毎回説明し直す手間」が浮かぶ。チームで使えば、プロジェクトの方向性がぶれて、手戻りと混乱が増える。

解決策として、開発者自らがMCPサーバー(handoff-mcp)とVSCode拡張(handoff-vscode)を作った。重要なのは、AIに「全て」を覚えさせるのではなく、「判断だけ」を引き継ぐという発想だ。セッション間で必要な設計判断、却下した選択肢、確定した命名規則といった「決定事項」だけを別チャネルで保持する。こうすることで、AIは過去のセッションの判断を知った状態で新しい実装に進める。AIの記憶喪失を前提にした、実装的な対策である。

AIを長期プロジェクトに投入する企業は多いが、多くが「AIが前のセッションを覚えてない問題」に直面している。手動でメモを取る対策は、数が増えるにつれて破綻する。本記事の手法は、AIの弱点を知ってる技術者の強い発想だ。中小企業でもAIの判断を記録として残し、プロジェクトブレを防ぐ仕組みを作る価値は大いにある。