init

使用する場面

リポジトリの AGENTS.md を作成または更新するときに、このスキルを使用してください。

特に、次のような場合に使用してください。

• 現在の AGENTS.md が長い、汎用的、または古くなっている
• エージェントが回避可能な同じミスを繰り返している
• リポジトリのワークフローが変わり、エージェント向けのガイダンスを整理する必要がある

指示

AGENTS.md は、コードベースの概要ではなく、リポジトリ内を見ただけでは分からない落とし穴やワークフロー上の注意点をまとめた、随時更新するリストとして扱ってください。

基本ルール：発見可能性のフィルター

行を追加する前に、次の点を確認してください。

エージェントはリポジトリ（README、コード、設定、スクリプト、ディレクトリツリー）を見れば、この情報を見つけられますか？

• はいの場合：AGENTS.md には含めないでください。
• いいえで、タスクの成功率、コスト、安全性に大きく影響する場合：含めてください。

記載する価値のある内容

次のすべてを満たすガイダンスのみを含めてください。

1. リポジトリ内のファイルだけでは発見できない
2. 運用上重要である（コマンド、結果、安全性に影響する）
3. 実行可能である（実行できるほど具体的である）

よくある例：

• 標準的でないツールの選択（例：pip ではなく uv を使用する）
• コマンド実行時の注意点（例：フィクスチャの挙動により、テストでは --no-cache を指定する必要がある）
• 隠れた制約や落とし穴（本番環境で引き続きインポートされる非推奨ディレクトリなど）
• リンター、テスト、設定に記述されていない重要なローカル規約

削除または記載を避ける内容

次の内容は記載しないでください。

• 技術スタックの概要
• ディレクトリ構造の概要
• エージェントがコードから推測できるアーキテクチャの説明
• 一般的なベストプラクティスのアドバイス
• ツール（リンター、型チェック、テスト、CI）で既に適用されているルール
• リポジトリで明示的に必要とされていない定型のヘッダー

推奨する構成

次のような、短く要点を絞ったセクションを優先してください。

• 対象範囲と振り分け（別のモジュール単位の AGENTS ファイルが必要な領域）
• リポジトリ内だけでは分からないコマンド
• 落とし穴／触れてはいけない領域
• タスク固有の制約

大規模なリポジトリでは、ルートに巨大なファイルを1つ置くのではなく、関連モジュールの近くに階層的な AGENTS.md ファイルを配置することを推奨してください。

最初に確認するファイル

• 既存の AGENTS.md
• README.md
• PROJECT.md（存在する場合）
• Cursor のルール（.cursor/rules/ または .cursorrules）
• Copilot の指示（.github/copilot-instructions.md）
• GEMINI.md
• CI／ワークフローファイルとパッケージマネージャーの設定（コマンドやツールの不一致を確認するため）

AGENTS.md が存在する場合は、やみくもに置き換えず、段階的に改善してください。

メンテナンスの考え方

AGENTS.md は恒久的な設定ではなく、一時的なガイダンスです。

問題が繰り返し発生する場合：

1. コードやツール（リンタールール、テスト、スクリプト、構成）を修正して、根本原因を解消することを優先します
2. 根本原因が解消されるまで、必要最小限の指示だけを残します
3. 古くなった指示は積極的に削除します

仕上げ前の品質チェック

AGENTS.md の各行について、次の点を確認してください。

• リポジトリ内だけでは発見できないか？
• 現時点でも正確か？
• ミス、コスト、時間を大きく減らせるか？

いずれかの確認を通過しない行は削除してください。