agents-md

AGENTS.md ジェネレーター

ワークスペースのルート向けの手順と、必要に応じて読み込むルールを生成します。ローカルの Compose の証拠に基づき、既存のプロジェクト実行環境ブロックを同期することもできます。

入力

• 対象ルートには *.code-workspace ファイル（複数フォルダーまたは単一フォルダー）が必要です。存在しない場合は停止し、ファイルを生成しないでください。Project Matrix はその folders リストを基に作成されます。ファイルを含むフォルダーから再実行するようユーザーに伝えてください。複数ある場合は、スキャン前にどれを使うか尋ねてください。
• エージェント自身のグローバルまたはユーザーの指示ファイル（~/.claude/CLAUDE.md、~/.codex/、グローバルな AGENTS.md、個人用のメモリ／ルール）は、読み取ったりコピーしたりしないでください。配布されているテンプレートとワークスペース内の証拠からルールを生成してください。帰属情報は一切記載せず、生成ファイルとすべての出力から共同執筆者、AI、ツールに関する帰属情報を省いてください。

ルール

• ワークスペースのルートにある AGENTS.md を、Codex CLI、Claude CLI、Antigravity CLI、Cursor CLI、Opencode CLI、GitHub Copilot CLI の共通の信頼できる情報源とします。コンテキスト、メモリポリシー、課題の振り分け、スキルの使用など、共通の運用手順はここに記載します。
• CLAUDE.md または GEMINI.md は作成も編集もせず、そこからルールを取得しないでください。既存のファイルは競合する指示ファイルとして報告してください。
• ルートに AGENTS.md をちょうど1つ作成し、ファイル一覧に記載された rules/ ファイルを作成してください。プロジェクトの同期では既存の AGENTS.md ファイルのみ編集し、プロジェクトの指示ファイルは作成しないでください。

モード

デフォルトでは、ルートファイルと必要に応じて読み込むファイルを生成または更新します。.devcontainer/compose.yml が存在する場合は、プロジェクト実行環境の同期を読み、既存のプロジェクト実行環境ブロックを同期してください。存在しない場合は、同期をスキップしたことを報告し、その参照ファイルは読み込まないでください。

プロジェクト実行環境の同期のみを指定するリクエストでは、実行環境のみモードを選択します。その参照ファイルと既存のスタック検出に従い、ルートの生成、移行、セットアップの提案はスキップしてください。このモードでは、ワークスペースルートの AGENTS.md や rules/ を作成または編集しないでください。以下のルート生成ルールと完了チェックは、デフォルトモードでのみ適用されます。

ワークスペースのスキャン

すべてのワークスペースフォルダーを先にスキャンしてください。ワークスペースまたはプロジェクトのルートにある VISION.md／vision.md を記録します（North star に反映されます）。また、各スタックを検出してください。複数のスタックがある場合は、イントロ欄にその旨を記載し、プロジェクト間で規約やコードを混在させないよう警告してください。

スタックの検出

Stack セルの情報は、アプリのルートにあるマニフェストとロックファイルから読み取ります。フォルダー名、ルートレベルのマニフェスト、またはファイルが存在するというだけの理由から推測してはいけません。まず実際のアプリのルートを特定してください。多くの場合、application/、app/、src/ などの下層にあります。その場所のマニフェストを読み取ってください。エコシステムごとのマニフェストの読み取りについては、references/stack-detection.mdを参照してください。

Project Matrix の形式

.code-workspace の folders の順序に従い、フォルダーごとに1行記載します。プロジェクトを追加したり省略したりしてはいけません。列は | Project | Path | Stack | の3つに固定します。

• Project：フォルダーの name から PROJECT-CODE を作成します。絵文字を除き、英大文字にし、句読点や空白の連続を単一のハイフンにまとめ、先頭と末尾のハイフンを取り除きます（Payments API → PAYMENTS-API）。name がない場合はパスのベース名を使います。アプリ以外のフォルダーには種別の接頭辞を付けます（PACKAGE-QUEUE、DB）。Project Matrix に記載した完全な PROJECT-CODE を、以後も一貫して使用してください。あるプロジェクトの規約、トークン、コンポーネントを別のプロジェクトに混在させてはいけません。
• Path：ワークスペースルートからの相対パス。. はメタ／ワークスペース行を表します。
• Stack：簡潔な1行で記載します。言語、すべての主要フレームワーク、ビルドツール、パッケージマネージャーを含めます。バージョンはマニフェストで固定されている場合にのみ記載します。アプリ以外のフォルダーでは、その役割を記載します。セル内に説明文を含めてはいけません。

例：

| Project      | Path             | Stack |
| :---         | :---             | :---  |
| PAYMENTS-API | ../payments-api  | PHP 8.3 / Laravel 13 / Vite / Composer + npm (application/) |
| DB           | ../db-migrations | MySQL / raw SQL migrations |

Vite だけでは、パッケージマネージャーがあるとは判断できません。

出力するスケルトン

assets/agents-md-template.md を AGENTS.md として、assets/rules/ 内の各ファイルを rules/<name> としてバイト単位でそのまま出力し、ファイルマップで割り当てられた角括弧付きのスロットだけを埋めます。ただし、「バージョン管理と再生成」に基づいて保持されるカスタマイズは除きます。デフォルトのスケルトンには、次の3つのルールが適用されます。

• Matt Pocock のスキルがインストールされている場合に限り、skills.md に ## Matt skill routing を出力します。ワークスペースのルートまたはユーザーのホームにある .agents/skills/ または .claude/skills/ 内に、ask-matt、grill-with-docs、to-spec のいずれかの SKILL.md が存在することを確認します。それ以外の場合はセクションを削除します。この確認結果とランタイムのスキル一覧が異なる場合は、ユーザーに確認してください。グラデーションテーブルには、いずれの場合も外部スキルを記載します。
• スキャンでビジョンファイルが見つかった場合に限り、#### North star を出力し、それぞれのスコープを記載します。ビジョンファイルを捏造したり、その内容を言い換えて記載したりしてはいけません。このサブセクションはファイルを参照するものです。見つからなかった場合は削除します。
• issues.md はアセットと同じ簡潔さを保ちます。ルーティングやラベル付けの手順は issue スキルに記載し、ここには記載しません。また、「Context & native memory」の2つのプレースホルダーは未入力のままにします。

スキルの使用

グラデーションテーブルと関連ファイルは、唯一の情報源である references/skills-manifest.md から生成します。ここに行をハードコードしてはいけません。phase: companion のキット項目は、関連ファイルの中だけに出力します。

カタログまたはノートを出力する前に、そのファイルに記載された除外事項、セルと起動行の形式、およびインストール確認を適用します。

[RUNTIME TOOL-CALLING …] スロットには、references/tool-calling.md の内容を、そのAGENTS.md への出力形式に厳密に従って記入します。セルが欠落している、または不明確な場合に限り、ランタイムごとの表（claude、codex、copilot、cursor、opencode、antigravity）を開きます。ネイティブメモリのセットアップは、依頼された場合のみ行います。メモリのデフォルト設定。参照ファイルは配布されないため、リンクしてはいけません。また、「Local orchestration」ルールを言い換えて記載してはいけません。

バージョン管理と再生成

スキルのバージョンは v58 です。生成されるすべてのファイルの1行目には、マーカー `` を含めます。これらのルールを変更する場合は、ここでのバージョンとすべてのアセットのバージョンを同時に更新します。v6 より前の古いマーカーについては、再生成を参照してください。

実行時に、ルートの AGENTS.md とすべてのオンデマンドファイルを確認します。

• なし — 新規生成します。
• マーカーあり — 上書きする前に、セクションごとの差分全体を、省略も要約もせずに表示し、カスタマイズは別途明示して、確認を求めます。ユーザーから返答がない場合は、書き込みを中止し、その旨を伝えます。
• マーカーなし（手書き） — 書き換えてはいけません。生成によって追加または変更される内容を提示し、ユーザーが承認したセクションだけをマージします。それ以外はすべて既存ファイルの内容を優先します。
• PROJECT-CODE を維持する — 既存の各行のコードを、Path に基づいて照合し、維持します（フォルダー名の変更などにより）現在は別のコードが割り当てられる場合は、独立した差分項目として明示的な承認を求めます。黙って変更してはいけません。新しいフォルダーには、導出したコードを割り当てます。
• ユーザーの編集を保持する — 再生成に従って、ユーザーが入力したプレースホルダーの値（特に GLOSSARY.md と specs/adr のパス）、カスタマイズされたルール本文、外部セクションを引き継ぎます。
• 単一ファイルレイアウト（マーカーが v50 未満）— レイアウトの移行を行います。
• 安全に書き込む — 書き込み直前に各対象を再読み込みします。承認後に変更されていた場合は、差分を再計算して再度提示します。書き込みまたは移動に失敗した場合は処理を中止し、書き込まれた内容と書き込まれなかった内容を報告します。

移行（まず確認）

すべての移動と、リンクを書き換えるすべてのファイルを列挙し、事前に確認してください。移動と書き換えはアーティファクトのルート内でのみ行い、プロジェクトリポジトリは読み取り専用として扱ってください。承認されなかった場合、または返答がない場合は、既存のパスを維持してください。確認なしで名前を変更してはいけません。

• アーティファクトのサブフォルダーがまだ docs/ にある場合（v7 より前）：docs から specs への移行。
• CONTEXT.md または CONTEXT-MAP.md がまだ使われている場合（v47 より前）：用語集への名前変更。

出力

チャットには、書き込み前の差分、移行の移動リストとレポート、Project Matrix の各行で読み取ったマニフェストファイル、ルールリンクの確認結果、競合する指示ファイル、および出力したバイト数を記載してください。32768 を超える場合は、Codex のサイズに関する注記を追加してください。

最後に、/setup-matt-pocock-skills、各 UI プロジェクトに対する /design-system、およびホストが指定されている場合は env-guard hooks を提案してください。提案のみとし、実行してはいけません。

完了条件

• 依頼されたプロジェクトの同期が、該当するリファレンスの照合、承認、保持の確認を満たしている
• 各ファイルのセクションがアセットの順序で記載されている。Matt のスキルへのルーティングは Matt のスキルを解決できる場合にのみ含まれ、#### North star はビジョンファイルが見つかった場合にのみ含まれている
• AGENTS.md が指定するすべての rules/ パスが、実行後に存在している。確認結果はチャットで報告されている。任意のセクションを省略しても、番号付きルールと Runtime のツール呼び出しはすべて保持されている
• 再生成時に、外部由来のセクション、ユーザーが入力した値、ルール本文のカスタマイズが保持されている。カスタマイズされたルールを置き換える場合は、明示的な承認を得ている。そうでなければ、書き込みを行わずに処理を停止している
• 生成されたカタログと起動時の注記に、マニフェストで除外された項目が含まれていない。キットの付属要素は付属要素の中にのみ表示され、それぞれインストール確認に合格している
• Matt のルーティングを省略しても、ワークツリーのルーティングが保持されている。Matt のルーティングを出力する場合は、検証済みのチェックアウトがタスクスキルに渡されている
• Project Matrix の行数が folders の件数と一致している。チャットで Stack の各セルについて読み取ったマニフェストが示されている。既存の PROJECT-CODE は、変更が承認されていない限り変更されていない
• 生成された各ファイルの先頭に現在のバージョンマーカーがある。Context とネイティブメモリのプレースホルダーはそのまま維持されているか、入力済みの内容が引き継がれている
• CLAUDE.md または GEMINI.md を作成または編集していない。チャットに出力したバイト数が記載されており、32768 を超える場合は Codex の注記が追加されている
• 承認済みの移行後、移動したアーティファクトに古い docs/<sub>/ リンクや古い用語集の名前が残っていない。一覧に記載されたファイルのみを書き換え、無関係な docs/ の内容と、承認されなかった移動はそのまま保持されている
• 生成ファイルを検索して、日付、会話への参照、マシン固有の絶対パスなど、セッションデータが見つからない