AIエージェントがドキュメントを正しく読み込めるか？新たな仕様が登場
エージェント対応ドキュメントドキュメントサイトは人間だけでなく、ClaudeやCopilotなどのコーディングAIエージェントによって消費されるようになっていますが、既存のサイトはこれらのエージェントのアクセスパターンに対応できていないのが現状です。
この問題に対処するため、ドキュメントサイトがエージェントをどれだけサポートできているかを評価する新たな仕様が策定されました。
主な要件として、コンテンツ発見のための「llms.txt」インデックスの作成や、Markdown形式でのページ提供が推奨されています。
本仕様には7つのカテゴリにわたる23のチェックが含まれており、開発者向けツールafdocsも提供され、AI時代のドキュメント改善を後押しします。
AIエージェントがウェブサイトのドキュメントを正しく読み取れるかどうかが、今後のAI活用における重要な課題となっています。従来のウェブサイトは人間が読むことを前提に設計されているため、Claude CodeやGitHub CopilotといったコーディングAIエージェントが情報を取得しにくいという問題が指摘されています。この課題を解決するため、ドキュメントサイトの設計基準を定めた新しい仕様が発表されました。
AIエージェントのための新ドキュメント仕様
この新仕様は、AIエージェントがドキュメントを「消費」する視点に立って、ウェブサイトの設計を評価する23のチェック項目を定義しています。従来のサイトでは、エージェントがコンテンツの途中で途切れてしまったり、CSSの羅列に埋もれてしまったり、必要な情報にたどり着けないケースが多発していました。
具体的には、コンテンツの発見可能性（llms.txtの存在など）や、Markdown形式の提供、ページサイズ、コンテンツ構造など、7つのカテゴリにわたる詳細な評価基準が設けられています。これにより、AIが情報を正確に取得できるサイト作りが推進される見込みです。
ドキュメント最適化のための実践的対策
ドキュメント作成者（ドキュメンタリスト）がすぐに取り組める最も効果的な対策として、いくつかのポイントが提示されています。まず、50KB未満のllms.txtを作成し、これをすべてのドキュメントページにポインターとして設置することが、最も効果的な情報発見メカニズムだとされています。
また、ページコンテンツを50KB未満に保ち、巨大なページを分割することや、Markdown形式でのページ提供をサポートすることが推奨されています。URLの変更時には、同一ホスト内でのHTTPリダイレクトを使用するなど、URLの安定性を保つことが重要です。
評価ツールと背景にある研究
この仕様を実際にテストするためのCLIツール「afdocs」も提供されています。このツールは、定義された23のチェック項目をドキュメントサイトに対して実行し、問題点や修正すべき箇所を報告します。
この仕様は、ClaudeやCopilotといった具体的なAIエージェントプラットフォームを用いた研究論文から生まれたものです。これらの研究では、エージェントがどのようにHTMLやMarkdownを処理し、どこで情報が途切れるのかといった、具体的な動作原理が深く分析されています。
まとめ
AIの進化に伴い、ウェブサイトの設計思想も変化しています。今後は、人間だけでなくAIエージェントが情報を効率的に利用できる「エージェントフレンドリー」なドキュメント構造が求められるでしょう。この新仕様は、そのための具体的なガイドラインを提供するものです。
原文の冒頭を表示（英語・3段落のみ）
For AI agents: a documentation index is available at /llms.txt — markdown
versions of all pages are available by appending index.md to any URL path.
Documentation sites are increasingly consumed by coding agents (Claude Code,
※ 著作権に配慮し、引用は冒頭3段落までです。続きは元記事をご覧ください。