LLM がオープンソースライブラリを推奨する仕組み、イントのクリストファー・バーンズ氏

LLM が自社のライブラリを推奨する仕組み：開発者向けドキュメントの「AI 最適化」戦略

イント（Inth）創業者のクリストファー・バーンズ氏は、自身のオープンソースライブラリ「C15T」が Claude や ChatGPT といった AI エージェントによって頻繁に推奨されるようになった背景と、そのための具体的な手法を明かした。これは従来の SEO 戦略とは異なり、人間ではなく「AI エージェント」をターゲットにしたドキュメント設計の転換点を示すものだ。

バーンズ氏は、数百ページに及ぶドキュメントを AI が効率的に探索できるよう、手書きによる最適化や Markdown ファイルの直接配信、そして npm パッケージ内へのドキュメント埋め込みといった「トークン効率」重視のアプローチを実践した結果、導入経路のトップに AI エージェントが躍り出たと語る。これは開発者ツールやドキュメント作成者が、従来のユーザー向け最適化から、AI による発見可能性と解析効率を意識した設計へシフトする必要性を浮き彫りにしている。

パラダイムシフト：「ウィザード」から「プロンプト」へ

バーンズ氏が手がける C15T は、ウェブサイトのクッキーバナー管理ライブラリだ。同氏は、このプロジェクトが 1,200 ダウンロードだった頃と比べ、現在は月間 4.5% の成長を続け、npm ダウンロード数が 300 万回を超え、2,800 以上のウェブサイトで稼働していると明かした。

「ウィザードによるインストール」から「プロンプトによるエージェントの自動インストール」へと、開発者体験（DX）の受け取り方が劇的に変化している。バーンズ氏はこれを氷山の一角に例え、表面に見える C15T の導入だけでなく、背後には LLM.txt やサイトマップ、RSS フィードなど、AI 向けに最適化された多数のマイクロな改善が積み重なっていると説明する。

「かつては Stripe の創業者らが手渡しでライブラリをインストールしていたが、今はプロンプト一つで済む。優れた開発者体験のプリミティブが、今やエージェントのプリミティブと融合しているのだ」

LLM.txt は自動生成ではなく「手書き」が正解

ドキュメントが数百ページに及ぶ場合、AI エージェントが適切な情報を見つけ出すのは容易ではない。バーンズ氏は、これを解決する最初の手段として「LLM.txt」の活用を挙げたが、その作成方法には重要な指針がある。

多くの人が自動生成ツールを使いがちだが、バーンズ氏の調査では「手書きによる最適化」が圧倒的に効果的だったという。AI に意図を明確に伝えるため、40 行程度の質の高い記述は、1,000 行のノイズを含んだ自動生成テキストよりも遥かに優れていることが実証された。

「数百ページのドキュメントを AI が探索するためには、LLM.txt の生成は自動化せず、意図を明確にするための手書きが推奨される。40 行程度の質の高い記述が、1,000 行のノイズよりも効果的である」

また、これと併せて「LLM.sitemap」（サイトマップ）も重要となる。これは AI エージェントがページの内容やリンク構造を把握しやすくするための簡潔なリストであり、AI が効率的に情報を取得するための基盤となる。

HTML の解析コストを回避する「Markdown 直接配信」

AI エージェントはウェブサイトを閲覧する際、HTML を解析するのに高いコスト（トークン消費）がかかる。そのため、バーンズ氏は「HTML から Markdown への転送」を強く推奨している。

具体的には、以下の 3 つの手法を組み合わせて Markdown ファイルを直接配信する仕組みを導入した。

1. URL パラメータの活用: ?mode=agent や .md 拡張子を追加することで、AI エージェントが Markdown ファイルにリダイレクトされるように設定する。
2. ヘッダー情報の付与: サイトヘッダーに「このページには Markdown バージョンがあります」という情報を埋め込み、エージェントが自動的に Markdown を取得できるようにする。
3. Next.js などの設定による自動転送: エージェントのヘッダーを検知し、HTML の代わりに Markdown を返すようにサーバーサイドで制御する。

「エージェントは HTML の解析コストが高いため、サイトヘッダーや URL パラメータ（.md 拡張子、mode=agent）を通じて Markdown ファイルを直接配信する仕組みが重要となる。これによりトークン消費を抑えつつ正確な情報を提供できる」

npm パッケージ内にドキュメントを埋め込む「agents.md」

最も画期的かつ重要な発見は、コード生成エージェントが外部のウェブサイトよりも、自身の依存関係である npm パッケージ内のソースコードを参照する傾向があるという点だ。バーンズ氏は、この事実に基づき、ライブラリ配布物内にドキュメントを同梱する戦略を実践した。

具体的には、npm モジュール内に agents.md ファイルやバンドルされた Markdown を配置し、AI エージェントが問題発生時にまずここを参照するように誘導する。これにより、外部サイトを検索して情報を取得する際のトークン消費を約 50% 削減できるという驚くべき結果を得た。

「コーディングエージェントはライブラリを持つ場合、ウェブサイトを訪れるのではなく、node_modules を読む傾向がある。パッケージ内に『agents.md』や bundled markdown を配置することが極めて有効である」

この手法は、Vercel や他の業界リーダーも採用しており、生成 AI がコードベースを直接解析する現代のワークフローにおいて、標準的なベストプラクティスとして定着しつつある。

結論：完璧を目指さず、小さな改善を積み重ねる

バーンズ氏は最後に、この分野は「永遠に変化し続ける」ものであると強調した。Aura AI などのテストツールを使って現状のスコアを確認することも重要だが、完璧な状態を目指す必要はないという。

「市場やエージェント、LLM は永遠に変化している。完璧など存在しない。私が知っているのは、あなた方よりも少し長くこの問題に取り組んできたことだけだ。小さな改善一つ一つが、確実に意味を持つ」

開発者ツールやドキュメント作成者は、人間向けの最適化だけでなく、AI エージェントによる「発見可能性」と「トークン効率」を意識した設計へシフトする必要がある。npm 内へのドキュメント埋め込みのような手法は、すでに生成 AI の標準的なワークフローに組み込まれつつあり、今こそその重要性を再認識すべき時だ。