Antigravityを使って大規模なアプリ開発をしていると、最初は完璧だったエージェントが、作業が進むにつれて「初期に伝えたルール」を忘れてしまうことがあります。これはAIが古い情報を勝手に要約してしまう「コンテキスト圧縮」という仕組みが原因かもしれません。
会話が長くなってもエージェントの賢さを維持するには、この圧縮の仕組みを正しく理解し、設定を最適化する必要があります。この記事では、AIの記憶劣化を防ぎ、Geminiのポテンシャルを最大限に引き出すための具体的な方法を詳しく解説します。
なぜAntigravityのエージェントは指示を「忘れる」のか？
エージェントが指示を忘れてしまう現象には、明確な理由があります。Antigravityは非常に賢いツールですが、何もしなければ「効率」を優先して、古い情報をどんどん削ぎ落としてしまうからです。
この章では、記憶が劣化するいきさつや、AIが情報をどのように要約しているのかといった仕組みについて、まず全体像を整理していきましょう。
コンテキスト圧縮によって情報が要約される仕組み
コンテキスト圧縮とは、AIとのやり取りが長くなった際に、過去のチャット履歴を「要約」して短くまとめる機能のことです。AIが一度に扱えるデータの量（トークン）には上限があるため、エディタ側が気を利かせて、古い情報をコンパクトに畳んでしまいます。
例えば、最初に「変数名はキャメルケースで統一して」と頼んでも、圧縮がかかるとその具体的な言葉が消え、「コーディングルールの指示があった」程度のぼんやりした記憶に書き換えられてしまいます。これが、開発の後半でAIが勝手な命名を始める原因となります。
開発が進むほど「記憶の劣化」が起きやすくなる理由
開発が進み、作成したファイル数やチャットの往復回数が増えるほど、AIの脳内メモリはパンパンになります。Antigravityは新しい指示を優先するため、古い情報はどんどん要約の対象となり、最終的には記憶の彼方へ消え去ります。
特に大規模なリファクタリングなど、大量のコードをAIに見せる作業を繰り返すと、数時間前のやり取りすら曖昧になることが珍しくありません。記憶の鮮度が落ちることで、AIは「今のコードベース」だけを見て判断するようになり、あなたが最初に提示した「設計思想」を無視し始めるのです。
Geminiの巨大なコンテキスト窓を活かしきれない設定
Antigravityの基盤であるGemini 1.5 Proなどは、本来100万トークンを超える膨大な情報を一度に読み込める能力を持っています。しかし、デフォルトの設定では、レスポンスの速さやコストを優先して、IDE側で早めに圧縮をかけてしまうことがあります。
せっかくの「ロングコンテキスト（長い記憶）」という武器があるのに、設定によってその入り口が狭められているのは非常にもったいないことです。AIが急に物忘れをし始めたと感じたら、それは知能の限界ではなく、設定による「人為的な記憶制限」にかかっている可能性が高いと言えます。
| 現象 | 起こっていること | 読者への影響 |
| 指示の無視 | 初期に決めた規約を忘れる | コードの修正依頼が増える |
| 矛盾した提案 | 以前の修正箇所を元に戻す | デバッグの手戻りが発生する |
| 曖昧な回答 | 「以前お伝えした通り」が通じない | 同じ指示を何度も出す羽目になる |
コンテキスト圧縮を無効化して記憶を守る設定手順
AIの物忘れを物理的に止めるには、設定画面から圧縮機能を制限するのが最も確実な方法です。Geminiの広いコンテキスト窓をフルに活用できるよう、エディタを「本気モード」に切り替えましょう。
ここでは、どこを触ればAIの記憶を永続化できるのか、具体的な設定場所をステップごとに紹介します。
設定画面から「コンテキスト要約」をオフにする
まずはエディタの「Settings（設定）」を開き、AIやAgentに関連する項目を確認してください。そこに「Context Summary（コンテキスト要約）」や「Summarize history（履歴の要約）」といったスイッチがあるはずです。これを「オフ」に切り替えます。
この設定をオフにすることで、AIは過去のやり取りを勝手にまとめず、そのままの形で記憶し続けるようになります。例えば、3日前の細かい仕様の議論も、AIは「一字一句そのまま」読み返すことができるため、記憶の劣化を劇的に防ぐことができます。
実験的機能からメモリ最適化を制限する
設定画面の「Experimental（実験的機能）」セクションには、さらに高度なメモリ管理設定が隠れていることがあります。「Memory Optimization（メモリ最適化）」などの項目があれば、これも制限するかオフにすることを検討しましょう。
これらの機能は、動作を軽くするために古い情報をメモリから追い出す役割を持っています。ハイスペックなPCを使っているなら、多少動作が重くなってもこれらの最適化を無効にしたほうが、エージェントの賢さを維持できるため、結果として開発効率は上がります。
プロンプトで「情報の省略」を禁止する方法
設定だけでなく、AIへの指示（プロンプト）でも釘を刺しておくのが効果的です。チャットの冒頭や、エージェントの初期設定（Custom Instructions）に「過去の履歴を一切省略せず、すべてを参照して回答せよ」と明記しておきます。
AIは「効率的に答えよう」とする性質があるため、人間側から「効率よりも正確性を優先して」と伝えることで、要約プロセスを内部的に抑制してくれます。特に複雑なロジックを扱う際は、この一言があるだけで、古い指示に基づいた正確なコードを出力してくれる確率が高まります。
- Settings > Agent > Context Summary をオフにする
- Experimental > Memory Optimization をオフにする
- 指示文に「全履歴を省略せず参照すること」と記載する
エージェントの記憶を劣化させないためのナレッジ活用術
設定で圧縮をオフにするだけでは、トークン消費が激しくなりすぎて、すぐに利用制限に達してしまうことがあります。そこで賢く使いたいのが、Antigravityの「Project Knowledge」機能です。
これはチャット履歴とは別に、AIが常に持ち歩く「メモ帳」のようなものです。この機能を使いこなして、重要なルールをAIの脳に直接刻み込みましょう。
重要なルールを「Project Knowledge」に永続化させる
プロジェクトのルートディレクトリに .antigravity/ というフォルダを作り、その中に rules.md や architecture.md といったマークダウンファイルを作成します。これが「Project Knowledge」として機能します。
ここに記述した内容は、チャット履歴がどれだけ長くなっても、コンテキスト圧縮の影響を受けません。AIは常にこのファイルを「カンニングペーパー」として参照し続けるため、変数名のルールや、絶対に使ってはいけないライブラリなどの「絶対に忘れてほしくない約束」を置くのに最適です。
.antigravity フォルダに設計方針を書き出すメリット
設計方針をファイルに書き出す最大のメリットは、エージェントを新しく作り直しても記憶が引き継がれる点にあります。通常、チャットを新しくすると記憶はリセットされますが、Project Knowledgeにある情報は共有されます。
例えば「このプロジェクトではディレクトリ構成をこうする」といった方針を書いておけば、どのお願いをしても一貫した構成でコードを生成してくれます。人間が指示を出し直す手間が省けるだけでなく、複数のエージェントを動かす際も全員が同じルールに従ってくれるようになります。
AIエージェントが常に参照すべき「絶対の指示」を固定する
Project Knowledgeには、技術的な仕様だけでなく「AIの振る舞い」についても書いておきましょう。「コードを生成する際は必ずJSDocを書くこと」や「ターミナルでコマンドを叩く前に必ず説明をすること」といった自分好みの設定を固定できます。
いわば、エージェント専用の「取扱説明書」をプロジェクトごとに用意するイメージです。これにより、AIが勝手な判断をすることを防ぎ、常にあなたのワークスタイルに合わせた「分身」として機能してくれるようになります。
| ファイル名の例 | 記述すべき内容 | 活用のコツ |
coding_style.md | 命名規則、インデント、型定義のルール | 具体的なコード例を1つ載せておく |
api_specs.md | 使用しているエンドポイントや認証方法 | 変更があったらすぐに更新する |
instructions.md | AIへの口調、デバッグ時の優先手順 | 「まずログを出して」など具体的に |
設定を変えると利用制限（クォータ）はどう変わる？
コンテキスト圧縮を無効化すると、AIは常に「すべての履歴」を読み直すことになります。これは非常に贅沢なリソースの使い方であり、当然ながら利用枠の減り方にも影響を及ぼします。
便利さと引き換えに発生する「コスト」の問題を正しく把握し、計画的に開発を進めるためのポイントを整理しましょう。
生データの送信によりトークン消費が激増する
圧縮をオフにすると、AIに1回質問するたびに、過去のすべてのチャット内容が「生データ」としてGoogleのサーバーへ送られます。要約していれば1,000トークンで済んだものが、数万トークンに膨れ上がることも珍しくありません。
これにより、同じ質問回数でも「1回あたりの重み」が全く変わってきます。チャットが長くなればなるほど、1往復で消費される枠が雪だるま式に増えていくため、特に複雑な議論を延々と続けている時は、枠の減り方に注意が必要です。
有料プランにおける制限までの目安
Google AI Pro（月額20ドル）プランの場合、5時間ごとに制限がリセットされますが、圧縮オフの状態ではこの「5時間」を待たずに制限に達する可能性が高まります。数千行のファイルを何度も読み込ませるような作業は、特にリソースを消費します。
とはいえ、一般的なコーディングであれば、一気に枠を使い切ることは稀です。もし制限にかかってしまった場合は、AIの知能が少し下がる（Flashモデルへの切り替え）か、一時的に応答が止まることになります。大事な場面で止まらないよう、重要度の低い作業は圧縮をオンにするなどの使い分けも検討しましょう。
記憶の精度とコストのバランスをどう取るか？
すべてを「記憶劣化なし」で進めるのが理想ですが、現実的にはタスクの重さに合わせて設定を切り替えるのがスマートです。
- 新規設計・重要バグ修正：圧縮をオフにして、全履歴を正確に把握させる。
- デザインの微調整・単純作業：圧縮をオンにして、サクサクと回数をこなす。
このようにギアを切り替えることで、利用枠を節約しながら、必要な場面でだけAIのフルパワーを引き出すことができます。設定画面を開くのが面倒なら、重要な情報だけをProject Knowledgeに移し、チャット履歴は定期的に「掃除」するのが最もバランスの良い運用です。
大規模開発でエージェントが「迷子」にならないためのコツ
プロジェクトが巨大になり、ファイルが数百個に及ぶようになると、いくら圧縮をオフにしてもAIが情報の波に溺れてしまうことがあります。これを防ぐには、人間が情報の「整理整頓」を手伝ってあげる必要があります。
AIエージェントを迷子にさせず、常にシャープな回答を引き出すための3つのコツを紹介します。
チャット履歴を定期的に整理して情報の純度を保つ
一つのチャット欄で、何日も別の話題を続けるのは避けましょう。ログイン機能が完成したらそのチャットは閉じ、新しく「通知機能の実装」というチャットを立ち上げるようにします。
チャットを分けることで、関係のない古い情報がAIの脳内から物理的に消え、今やるべきことに全神経を集中させられます。情報は多ければ良いというものではありません。現在のタスクに必要な情報だけが揃っている「純度の高い状態」を作ることが、AIの賢さを保つ一番の近道です。
1つのエージェントに複数の重いタスクを任せない
「フロントエンドの修正をしながら、バックエンドのバグも見て、ついでにテストも書いて」という盛りだくさんの指示は、AIを混乱させる原因になります。どんなに記憶力が良くても、注意力が分散すればミスは増えます。
Antigravityの複数エージェント機能を使い、役割ごとに担当者を分けましょう。一人はUIに特化し、もう一人はAPIに特化する。担当範囲を絞ることで、それぞれのAIが読み込むべきファイル量も減り、結果として記憶の精度も応答スピードも向上します。
重要な文脈は「エージェント間」でどう引き継ぐか？
エージェントを分けた際、共通のルール（例えばAPIの型定義など）が分からなくなってしまうことがあります。ここで役立つのが、先ほど紹介した .antigravity/ 内のナレッジファイルです。
個別のチャット履歴は消えても、ナレッジファイルに書かれた「共通言語」は全エージェントで共有されます。エージェントを切り替える際は、「詳細は rules.md を読んで」と一言添えるだけで、スムーズに文脈を引き継ぐことができます。履歴をダラダラ残すのではなく、重要なエッセンスだけをファイルに抽出し、それを全員で共有するスタイルが理想的です。
もしエージェントが過去の指示を忘れてしまったら？
気をつけていても、AIが「あ、忘れてた！」という挙動をすることはあります。そんな時に「さっき言ったでしょ！」と怒っても解決しません。
AIの脳を素早くリフレッシュさせ、正しい軌道に戻すための具体的なリカバリー手順を知っておきましょう。
過去の重要なやり取りを「ピン留め」して再認識させる
Antigravityのチャット画面には、過去の発言を「Pin（ピン留め）」したり、重要マークをつけたりする機能があります。AIが指示を忘れ始めたら、以前の正しかったやり取りをピン留めして、「ここをもう一度読み直して」と伝えましょう。
これにより、要約されてぼやけていた記憶が、再び「生データ」としてAIの作業メモリに読み込まれます。最初から指示を書き直すよりも、過去の成功例を提示するほうが、AIは文脈を思い出しやすく、修正の精度も上がります。
キャッシュをクリアして新しいコンテキストを読み込ませる
AIの回答が支離滅裂になってきたら、一度エージェントを再起動するか、コンテキストのクリアを行いましょう。古い間違った記憶がキャッシュとして残っていると、いくら正しい指示を出しても引っ張られてしまうことがあるからです。
一旦まっさらな状態に戻してから、Project Knowledgeや最新のファイル構成を読み込ませることで、AIの脳内が整理されます。「急にバカになった」と感じたときは、知能の問題ではなく、脳内がゴミデータで散らかっているだけのことが多いので、掃除をしてあげるのが一番の解決策です。
矛盾したコードを出した時の正しい修正指示
AIが以前の指示と矛盾するコードを出してきたら、ただ「間違っている」と言うのではなく、「以前はAというルールで修正したけど、今回はBになっている。Aのルールを守って書き直して」と、何と何が矛盾しているかを具体的に指摘してください。
AIは自分の過去の発言をすべて完璧に把握しているわけではありません。人間が「以前のあなたとの約束」をリマインドしてあげることで、AIは自分の間違いを学習し、そのチャット内での一貫性をより強く意識するようになります。
開発をスムーズに進めるためのコンテキスト管理ルール
最後に、日々の開発で意識したい「コンテキスト管理の鉄則」をまとめます。道具をどう使うかも大事ですが、どう指示を出すかという「運用」の部分で、AIの賢さは決まります。
明日からのコーディングが劇的に楽になる、3つのシンプルな習慣を身につけましょう。
指示は「一文一義」でシンプルに保つ
一つのプロンプトに複数の要求を詰め込まないようにしましょう。指示が複雑になればなるほど、AIは情報を圧縮しようとする際に、重要なディテールを削ぎ落としてしまうリスクが高まります。
「まずこれをやって、次にこれ、最後にこれ」とステップを分けることで、AIは一つひとつの作業に集中でき、記憶の定着率も上がります。シンプルであることは、AIにとっても人間にとっても、ミスのない開発の基本です。
定期的に「現在の進捗とルール」をAIに再確認させる
作業の区切り（例えば1つの機能が動いた時など）で、AIに「今までの進捗と、これから守るべきルールを要約して教えて」と逆質問してみましょう。
AIが答えた内容があなたの認識とズレていれば、その場で軌道修正できます。これは、AIの脳内にある「要約データ」の中身を確認する作業です。このズレをこまめに直しておくことで、開発終盤に「そんなの聞いてない！」という事態になるのを防げます。
AIに触らせたくないファイルを物理的に除外する
プロジェクト全体を見せるのではなく、.antigravityignore ファイルを使って、AIの視界を適切に制限しましょう。巨大なログファイルや、ビルド済みのバイナリデータなどは、AIのコンテキストを無駄に消費するだけです。
不要な情報を物理的に遮断することで、AIは限られたコンテキスト枠を、本当に大切なソースコードの理解だけに費やせるようになります。「情報の断捨離」を徹底することが、結果としてAIエージェントを最も賢く保つための最強のハックとなります。
Plaintext
指示の例：
「これまでの議論を踏まえて、rules.mdの内容を厳守して。
特にエラーハンドリングの書き方を以前のチャット（ステップ5）に合わせて。
過去の履歴を省略せずに、すべてのコンテキストを参照して回答してほしい。」
まとめ：AIの「記憶力」をコントロールして開発を加速させよう
Antigravityのコンテキスト圧縮は便利な反面、エンジニアのこだわりを薄めてしまう副作用があります。
- 設定の変更：まずは設定画面でコンテキスト要約をオフにし、Geminiのフルパワーを解放する。
- ナレッジの永続化：
.antigravity/フォルダを活用して、絶対に忘れてほしくないルールを固定する。 - 運用の工夫：チャットを細かく分け、不要なファイルを隠すことで、AIの脳内を常にクリーンに保つ。
AIは万能な魔法の杖ではなく、適切な設定と管理が必要な「パートナー」です。記憶を劣化させない環境を整えてあげれば、Antigravityはあなたの意図を完璧に汲み取る、最強の分身になってくれるでしょう。
今日から設定を見直して、エージェントが「忘れない」ストレスフリーな開発を体験してみてください。
