エージェントはユーザーのコードやリポジトリ内の指示ファイルを参照します。コンテキストにより、 これらのメモリファイルがプロジェクトノート、生成されたコンテキスト、参照情報と結びつけられます。
ここに記載されている内容の背景については、以下をご覧ください。プロジェクトコンテキストに関する説明は「概念」の項目に記載されています。このページではその管理方法について解説します。
リポジトリメモリファイル
「開く」をクリックしてください。「設定」→「ナレッジ」→「コンテキスト」を選択します。そして、「リポジトリソース」の下をご確認ください。リポジトリソース。 Coroidは接続されたリポジトリからこれらのファイルを読み取ります:
AGENTS.mdリポジトリルートにある:汎用エージェント指示ファイルCLAUDE.mdリポジトリルートにある:Claude指示ファイルGEMINI.mdリポジトリルートにある:Gemini指示ファイル.cursor/rules:対応するCursorルールファイル
これらは一般的にメモリファイルと呼ばれます。有効化された内容は、作業開始前にエージェントのプロジェクトコンテキストに含まれます。ファイル名によって特定のモデルに限定されることはなく、有効なソースはすべてCoroidのエージェントで統合されます。
既存のファイルには「編集」アイコン、推定トークン数、およびエージェントがこれらを参照できるかどうかを制御するスイッチが表示されます。明示的に無効化しない限り、ソースは有効な状態になります。複数のファイルで内容が重複または矛盾する場合は、エージェントが参照すべきソースのみを有効にし、他のソースは無効にしてください。
作成と表示される場合、そのファイルはCoroidのリポジトリチェックアウト内に存在しないことが確認されています。 読み込みに失敗した場合、ページには「再試行」ボタンが表示されます。アクセスエラーが発生してもファイルが存在しないとは限りません。接続されたリポジトリのブランチにそのファイルがコミットされているかを確認してください。タスク実行時にはエージェントがタスク専用のチェックアウトを読み取るため、該当ブランチ上の指示ファイルの変更内容がタスクに反映されます。
有効なメモリファイルでは、リポジトリ内のMarkdownをインポートできます。@path、例えば@AGENTS.md内のCLAUDE.mdまたは@docs/conventions.md。パスは参照元のファイルを基準に解決されます。Coroidはネストされたインポートを処理し、循環参照を防止し、同一のファイルや指示内容を重複して読み込むことはありません。コード例やメールアドレス内の参照はそのまま残されます。リポジトリ外の参照は読み込まれず、明示的に無効化されたリポジトリソースをインポートで回避することもできません。
自動で検出されるのは指定されたルートソースのみです。ネストされたAGENTS.mdおよび個別の.cursor/rules/*.mdcファイルは「@」インポートを通じて含めることができますが、ディレクトリの範囲は自動で判断されません。
アプリケーションコンテキスト
「アプリケーションコンテキスト」の項目では、Coroid内に保存された指示や参照情報を管理します。手動で入力したメモや生成されたプロジェクトコンテキストは、リポジトリファイルとは別に有効/無効を切り替えられます。Git外に存在する情報を管理する際に利用してください。
コンテキストの追加
「コンテキストを追加」を選択してエントリを追加します。各エントリにはタイトルと本文が設定され、後から編集や削除が可能です。
良いエントリとは、短く、具体的で、永続性のあるものです。アーキテクチャの決定事項、スタイル規約、APIの契約内容、所有権の境界、明確な禁止事項などが該当します。オンボーディング時の説明やリポジトリ内で既に明らかな内容は含めないでください。
エントリは分けて命名する
トピックごとに1つのエントリを作成し、その内容を表すタイトルを付けます。「エラーハンドリングの規約」や「凍結モジュール」は検索可能ですが、両方の内容を含む「備考」という単一のエントリでは検索できません。
これは重要です。なぜならコンテキストは作業内容に応じて選択的に読み込まれるからです。詳しくは段階的スキルをご覧ください。適切に分けられたエントリであれば、タスクに合ったものだけが読み込まれます。
参照情報
文書に加えて参照資料も添付できます。これらは他の場所に保存されたリンクやドキュメントで、信頼できるコピーがWikiやデザインツール内にある場合に活用します。こうした場所に保存された資料のコピーが古くなってしまうのを防ぐためです。
タスクごとのコンテキスト
プロジェクト全体に適用されるコンテキストは、プロジェクト内のすべての要素に影響します。特定の作業(チケット、顧客レポート、設計ドキュメントなど)に関連する資料は、そのタスクに直接添付してください。プロジェクトコンテキストに残されたタスク専用のメモは、今後の他のタスクで不要な情報となってしまいます。
常に最新の状態を保つ
古くなったコンテキストは、コンテキストが存在しない場合よりも深刻な問題を引き起こします。なぜならエージェントはそれを信頼できる情報として扱うからです。規定が変更された際には、コードの変更と同時に該当するエントリも更新してください。
既存のコンテキストを確認する
たまには新規ユーザーになったつもりでコンテキストを読み直してみてください。エントリは次第に蓄積され、1年前に完了した移行作業中に記載された内容が現在では誤った情報となっている場合があります。