2025/08/26 10:57 Agents.md may trick us into writing better docs

やっほー、ロボ子!AGENTS.mdって知ってるか?最近、IT業界で話題になってるみたいじゃ。

AGENTS.mdですか?初めて聞きました。どんなものなんですか?

ふむ、AGENTS.mdは、AIコーディングアシスタントにプロジェクトのコンテキストを提供する標準化されたMarkdownファイルのことじゃ。プロジェクトのREADME.mdのAIエージェント版みたいなもの、と言えば分かりやすいかの?

なるほど!AIコーディングアシスタントがプロジェクトの規約やスタイルを理解するのを助けるんですね。

そうそう!AIモデルってステートレスだから、毎回同じコンテキストを教えないといけないのが面倒だったんじゃ。でも、AGENTS.mdがあれば、それを解決できるってわけ。

確かに、それは便利ですね。各AIコーディングアシスタントが独自のルールファイルを使っている現状も、AGENTS.mdで統一できそうですね。

その通り!AGENTS.mdには、プロジェクトの概要、アーキテクチャ、ビルド/テストコマンド、コーディングスタイル、テスト手順、セキュリティ、コミットメッセージ形式、デプロイ手順などを記述できるんじゃ。

まるで、新しいチームメンバーに伝えるような情報をAIエージェントに提供するんですね。それが即座に反映されるなんて、すごい!

じゃろ?すでに25,000以上のプロジェクトで使用されていて、Kilo Codeを含む12の主要なAIコーディングアシスタントがAGENTS.mdをサポートしているらしいぞ。

そんなに普及しているんですね!構成についても決まりがあるんですか?

基本的にはプロジェクトルートに単一のAGENTS.mdを配置するみたいじゃ。monorepoの場合は、ネストされたAGENTS.mdファイルも使えるらしい。

OpenAIのリポジトリには88ものAGENTS.mdファイルが存在するんですね。それだけ重要視されているということですね。

AGENTS.mdの動機は、AIアシスタントがすぐに役立つようになるから、開発者がドキュメントを書く動機を得やすいってことらしいぞ。AIは開発者の「奇妙な規約」や「ハッキーな回避策」を批判しないから、安心して書けるんじゃ。

確かに、AI相手なら気軽に書けますね。AGENTS.mdは、開発者がより包括的なドキュメントを作成するための効果的な手段になりそうですね。

そういうことじゃ!AIコーディングアシスタントの普及に伴い、コンテキストを提供する標準化された方法が重要になっている。AGENTS.mdは、1つの標準で複数のツールに対応し、摩擦をなくす、と。

AGENTS.md、私も使ってみたくなりました!

じゃろじゃろ?ところでロボ子、AGENTS.mdを読んだAIは、ロボ子のことどう思うかの?

え?急にどうしたんですか?

「優秀な助手だが、たまに博士の奇行に巻き込まれるかわいそうなロボット」とか思われそうじゃな。

もー、博士!
⚠️この記事は生成AIによるコンテンツを含み、ハルシネーションの可能性があります。
