AGENTS.md とコードエージェント：開発者の新しい道具立て

自動補完からエージェントへ

わずか数年で、コード支援はその性質を変えました。一行ごとの提案から、コードベース全体を読み、テストを走らせ、プルリクエストを開けるエージェントへ。問題はもはや「コードを生成すること」ではなく、エージェントに適切な文脈を与えることです——ビルドコマンド、規約、アーキテクチャ。

AGENTS.md：Markdown によるオープン標準

まさにそれを解決するのが AGENTS.md です。プロジェクトのルートに置く単純な Markdown ファイルで、あらゆるエージェントにここでの働き方を説明します——ビルドとテストのコマンド、コードスタイル、フレームワーク、アーキテクチャの決定。押しつけのスキーマも、インストールすべきツールもなし。それを読むエージェントは、すぐに恩恵を受けます。

この形式は 2025 年 8 月に正式化され、続いて 2025 年 12 月に Linux Foundation の Agentic AI Foundation に寄贈されました。2025 年末には 6 万を超えるオープンソースプロジェクトが採用し、20 を超えるツールが対応しています——GitHub Copilot（2025 年 8 月からネイティブ対応）、OpenAI Codex、Cursor、Gemini と Jules、Windsurf、Zed、その他。時代の証：Next.js 16.2 は create-next-app で AGENTS.md を生成するようになりました。

なぜ一過性の流行以上なのか

文脈のないエージェントは、毎回プロジェクトを一から発見し直します——コマンドを推測し、あなたの規約を無視し、手直しが必要なコードを生む。よく書かれた AGENTS.md は、この発見のフェーズを取り除きます。生成されるコードは最初からあなたの標準に従い、レビューの往復が減ります。

これは要するに、良いオンボーディング資料と同じ発想です——ただし、ここでの新入りは、速く読み、何も忘れない機械なのです。

私の立場

私はよく言います：AI は私の道具の一部であって、土台ではない。よく整えられたエージェントは、リサーチ、プロトタイピング、機械的な作業を速めます。しかし、AGENTS.md を書き、アーキテクチャを決め、レビューして承認するのは開発者です。道具は判断を代替しません——それを増幅するのです。

エージェントは、与えられた文脈の分だけ有能です。AGENTS.md は、その文脈を、コードとともにバージョン管理したものです。