なぜエージェントにやさしいのか

まずエージェントが読む

採用担当者、ハイアリングマネージャー、クライアントは、ページを読む前にAIアシスタントにこう尋ねることが増えています。 "この候補者を要約して"、"この人はHead of AIの役割に合う？"、"AI戦略を手伝ってくれるのは誰？" エージェントは取得し、読み、絞り込み、要約します。見た目の良いページだけの個人サイトでは、レイアウトをスクレイピングしたり、文脈を見落としたり、空白を補完してしまったりと、エージェントに推測を強いることになります。

Jenksの仕事は常に、この種のレバレッジに関するものでした。XeroでのAPIとSDK、Linktreeでのデベロッパープラットフォーム、FilecoinとBabylonでのエコシステムづくりなど、彼は長年にわたり他のビルダーが使えるプラットフォームを作ってきました。彼のリーダーシップのモットー「私はチームが輝くのを助けることで導きます」はAIにも自然に広がります。すなわち、他のエージェントが良い仕事をできるようにするインターフェースを作るということです。だからこそ、彼自身のサイトも、彼が企業のプラットフォームづくりで助言するのと同じやり方で構築されています。人々かつそれを使うエージェントのために。

ここでいう「エージェントにやさしい」とは

• Discoverable: ルートのllms.txtがエージェントに必要なすべてを一覧します。/brief.mdがワンページの出発点で、/.well-known/site-agent.jsonと/openapi.jsonがインターフェースを記述します。
• Structured: /experience.jsonと/llms-full.txtがタグ、ロールレンズ、日付、主要成果とともに全文書を提供し、エージェントが推測ではなくフィルタできるようにします。
• Callable: リモートのMCPサーバー、REST API、そしてローカルのMCPサーバーも兼ねるCLI——同一の仕様から生成される同じツールをどこでも使えます。
• Honest: 回答は根拠に基づき、実績と可能なことを分け、ギャップを明示します（根拠と誠実さを参照）。
• Documented for agents: これらのドキュメントはDiátaxisに従います——チュートリアル、ハウツー、リファレンス、解説——そしてすべてのページは生のMarkdownとしても提供されます。
• Multilingual: 7言語で、各言語とも同じ構造です。

なぜDiátaxisなのか

エージェントと人ではニーズが異なります。システムを学ぶ、タスクを完了する、正確なパラメータを参照する、設計判断を理解する——これらを混ぜるとどのページも悪くなります。Diátaxisは各ページを1つの仕事に絞ることで、エージェントがそのページを見つけて引用しやすくもします。

プロジェクトのルール

サイトが成長してもエージェントにやさしい状態を保つための2つのルールがあります。これらはリポジトリのAGENTS.mdに明記され、コードに取り組むAIは必ず従います。

1. 新機能はすべてのサーフェスに同時提供する。 人のために機能を追加したら、その仕様にも追加します——結果としてREST API、MCPサーバー、CLI、生成されたリファレンスドキュメントにも反映されます——さらに、ダウンロード可能なCLIバイナリを再ビルドし、エージェント向けページで公開します。
2. あらゆる変更はすべての言語をカバーする。 コンテンツとインターフェース文言は7言語すべてで更新します。英語で作成し、他の6言語はリリース前に用語集で検証しつつ再生成します。

得られる成果

lens=solution-architectでlist_experienceを呼べるエージェントは、数秒で正確で出典付きの回答をユーザーに提供できます。これは質問者にとってもJenksにとってもより良く、Jenksが企業とともに構築を支援する「AI対応の組織」の実例になります。