エージェントへの指示
エージェントは、プロジェクト内の説明書ファイルを使って設定できます。これらのファイルでは、コードベースにおけるエージェントの動作、コーディング規則、アーキテクチャの制約、一般的なワークフローなどを定義します。
ほとんどのエージェントは、再利用可能なガイダンスとして AGENTS.md ファイルを使用しますが、一部は独自のフォーマットを使用しています。 例えば、 Claude Agentは CLAUDE.md から指示を取得します。
エージェントはこれらのファイルを自動的に読み込み、コード生成、コマンド実行、意思決定を行う際の指針として使用します。 これにより、プロジェクト固有の指示を 1 か所に集約し、より一貫性のある結果を確保できます。
指示ファイルとプロジェクトルール
AI アシスタント には、チャットでの動作を定義する プロジェクトルールという同様の機能も備わっています。
説明書ファイル （
AGENTS.md、CLAUDE.md）は、選択したコーディングエージェントによって使用され、リポジトリとともに移動します。プロジェクトルールは IDE で設定され、AI アシスタント チャットモードでのみ適用されます。
指示ファイルを使用してツールや環境間でガイダンスを共有し、プロジェクトルールを利用して AI アシスタント 内の動作をカスタマイズします。
どうやって使うのですか
リポジトリのルートに、エージェント（たとえば、 AGENTS.md または CLAUDE.md ）がサポートする指示ファイルを作成し、エージェントがコードベースとどのように連携すべきかを記述してください。 選択したエージェントは、これらの指示を自動的に検出して使用します。
一般的なファイルには以下が含まれます。
プロジェクトの背景－ 言語、フレームワーク、アーキテクチャ。
開発ルール－ コーディングの標準と制約。
リポジトリの規約－ ディレクトリ構造と境界。
一般的なタスク－ プロジェクトのビルド、テスト、実行を行うためのコマンド。
制限事項－ エージェントがしてはならないこと。
完了の定義－ タスクを完了するための条件。