Generate or update AGENTS.md files in repository roots. Use when the user asks to "create AGENTS.md", "update AGENTS.md", "generate AGENTS.md", "refresh AGENTS.md", or mentions "AGENTS.md" in the context of documenting project structure for AI agents. Covers project structure, directory layout, key file roles, architecture patterns,tech stack, and conventions.
リポジトリルートに AGENTS.md ファイルを生成・更新し、AIコーディングエージェントに構造化されたプロジェクト知識(ディレクトリ構成、主要ファイル、アーキテクチャパターン、技術スタック、規約)を提供する。
AGENTS.md はAI向けのプロジェクト概要ドキュメントである。CLAUDE.md(Claude Code 固有のコマンド、注意点、ワークフローのヒントを対象とする)とは異なり、AGENTS.md はあらゆるAIコーディングエージェントがコードベースをナビゲートし理解するために必要な構造的・アーキテクチャ的な知識に焦点を当てる。
タスクの種類を判断する:
scripts/explore_structure.py でディレクトリツリーを生成する。<!-- auto-generated --> マーカー付き)と手動編集セクション(<!-- manual --> マーカー付きまたはマーカーなし)を区別する。<!-- auto-generated --> マーカーが付いたセクションの内容を再生成する。手動編集セクションはそのまま保持する。自動生成コンテンツと手動編集コンテンツを区別するために、HTMLコメントを使用する:
<!-- auto-generated: section-name -->
## セクションタイトル
[自動生成された内容]
<!-- end: section-name -->
マーカーなし、または <!-- manual --> マーカー付きのセクションはユーザーが管理するものとして扱われ、更新時に上書きされることはない。
新規に AGENTS.md を作成する場合、すべてのセクションにデフォルトで <!-- auto-generated --> マーカーが付与される。ユーザーはこれらのマーカーを削除するか <!-- manual --> に変更することで、セクションの所有権を取得できる。
.gitignore や LICENSE のような自明なファイルは、非自明な内容を含まない限り列挙しない。