メモリの仕組み

​

概要

Qoder CLI はセッションごとにコンテキストを再構築します。明示的に保存されない限り、前のセッションでどのような会話が行われたかを自動的に記憶することはありません。Qoder が情報を記憶するいくつかのメカニズムを理解することで、長期的に保持すべき知識を定着させると同時に、無関係な内容でコンテキストが埋め尽くされるのを防ぐことができます。 Qoder が依存する情報は主に3つのレベルから構成されており、それぞれのライフサイクルと用途は異なります。

​

会話コンテキスト

会話コンテキストは、現在のセッションで蓄積された履歴、つまりユーザーの入力、Qoder の応答、各ツール呼び出しとその結果です。これにより、Qoder は1つのセッション内で一貫性を保ち、数分前に議論した内容を記憶することができます。 会話コンテキストには、いくつかの重要な特徴があります。

• セッション内有効：現在のセッション内でのみ存在します。新しいセッションを開始する際、以前の会話コンテキストは自動的に引き継がれません。
• 容量制限：コンテキストウィンドウには限りがあります。会話が長くなるほど、より多くの容量を消費します。
• 管理可能：コンテキストを積極的にクリアしたり圧縮したりすることができます。

​

会話コンテキストの管理

• /clear：会話履歴コンテキストをクリアして新しいセッションを開始し、「ゼロから」始められるようにします。全く関連のない新しいタスクに切り替える際に便利です。
• /compact：現在のセッションの履歴コンテキストを要約・圧縮してより簡潔な形式にし、重要な情報を保持しつつコンテキスト領域を解放します。長いセッションの途中でコンテキストが逼迫してきた場合に適しています。

会話が長く、コンテキストへの負荷が大きい場合、Qoder は必要に応じて圧縮を行います。関連するパフォーマンスとコンテキストの問題のトラブルシューティングについては、パフォーマンス、コンテキスト、および長時間のセッションに関する問題 を参照してください。

​

プロジェクト指示

プロジェクト指示は、ユーザーまたはチームが明示的に記述する静的メモリであり、プロジェクトの構造、開発標準、コラボレーションの取り決めを Qoder に伝えるために使用されます。これは各セッションでコンテキストとしてモデルに提供され、Qoder にチームの取り決めを遵守させます。 主に2つの形式があります。

• AGENTS.md：Qoder CLI のデフォルトのコンテキストファイル名であり、プロジェクト全体の指示や安定した取り決めを記載するのに適しています。一般的な配置場所には、ユーザーレベルの ~/.qoder/AGENTS.md、プロジェクトレベルの <project>/AGENTS.md、ローカルプロジェクトレベルの <project>/AGENTS.local.md が含まれます。
• Rules：<project>/.qoder/rules/ 配下に配置され、トピックやファイル範囲ごとに分割された Markdown ルールファイルです。単一の肥大化した AGENTS.md を代替するのに適しています。

プロジェクト内で /init を実行して AGENTS.md を自動生成したり、/memory を使用して各レベルのメモリファイルを管理したりできます。詳細については、メモリ を参照してください。

プロジェクト指示はモデルに提供されるコンテキストであり、強制ポリシーではありません。特定の種類のコマンド、ツール、またはパスを厳格にブロックする必要がある場合は、権限 または フック を使用してください。

​

長期メモリ

長期メモリは、セッションを跨いで保持される情報です。上記のチームによって管理される静的メモリ（AGENTS.md、rules）に加え、Qoder CLI は自動メモリもサポートしています。これを有効にすると、Qoder は会話から学習し、その後も有用な情報（環境設定、フィードバック、プロジェクトの背景、外部参考資料の場所など）をローカルの Markdown メモリファイルとして保存します。 自動メモリの表示と管理の入口：

• /memory パネルで自動メモリフォルダーを開きます。
• /memory manage を実行して、自動保存されたメモリのトピックファイルを管理します。

自動メモリも同様にコンテキストとしてモデルに提供され、新しいセッションで以前に蓄積された理解を Qoder が引き継げるように支援します。詳細は メモリ を参照してください。

​

3つの要素の連携

セッションの開始時、Qoder は該当するプロジェクト指示と長期メモリを読み込み、背景情報としてコンテキストに注入します。会話が進むにつれて、会話コンテキストは継続的に蓄積されます。これら3つの要素が共同して、Qoder が意思決定を行う際に依存する完全な背景を構成します。

• 会話コンテキストは「今回のセッションでどこまで話が進んだか」を解決します。
• プロジェクト指示は「このプロジェクトで遵守すべき取り決めは何か」を解決します。
• 長期メモリは「セッションを跨いで記憶すべき環境設定と背景は何か」を解決します。

特定の知識を長期的に有効にしたい場合は、それをプロジェクト指示に記述するか、長期メモリとして保存します。現在のタスクにのみ関連する一時的な情報は会話コンテキストに残しておき、必要に応じて /clear または /compact でクリアしてください。