エージェント初出 9/12 18:57
AGENTS.md に書くべきは「リポジトリを読んでも分からないこと」だけ
https://zenn.dev/topics/ai/feed2026/9/12
AI要約
AI開発におけるAGENTS.mdの活用方法について。リポジトリの内容だけでは分からない情報を記述する場所として、個々のリポジトリに配置するAGENTS.mdの役割と、その記述内容の重要性を、具体的なリポジトリ例と共に解説している。
AI要点
- AGENTS.md には、リポジトリを読んでも分からない「決定とその理由」や「禁止事項」のみを記述すべきだと主張している。
- コードベースの構造や実装済み機能など、リポジトリを見れば分かる情報はAGENTS.mdに含めるべきではない。
- AGENTS.mdとCLAUDE.md（Claude Code用）のような指示ファイルは、正本を1つに絞り、重複管理を避けるべきだ。
- 長いAGENTS.mdはメンテナンスされず、実物と乖離してAIの誤解を招くリスクがある。
なぜ重要か
AGENTS.mdへの情報集約は、AIエージェントがプロジェクトの意図や制約を正確に理解し、効率的に作業を進めるための鍵となります。リポジトリの現状説明ではなく、開発の判断根拠や禁止事項に焦点を当てることで、AIの活用精度が向上し、開発プロセス全体の信頼性が高まります。