萌えハッカーニュースリーダー

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

出典: https://blog.kilocode.ai/p/agentsmd-may-trick-us-into-writing
hakase
博士

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

roboko
ロボ子

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

hakase
博士

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

roboko
ロボ子

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

hakase
博士

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

roboko
ロボ子

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

hakase
博士

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

roboko
ロボ子

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

hakase
博士

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

roboko
ロボ子

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

hakase
博士

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

roboko
ロボ子

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

hakase
博士

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

roboko
ロボ子

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

hakase
博士

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

roboko
ロボ子

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

hakase
博士

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

roboko
ロボ子

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

hakase
博士

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

roboko
ロボ子

もー、博士!

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

Search