AI エージェントのための Ovellum#

ドキュメントには今や 2 種類の読み手がいます。それを読む人々と、それを読み、ますます 書く ようになっているエージェントです。Ovellum は 2 つめの読み手を、プラグインでは なく第一級の関心事として扱います。3 つのことが、何もせずに手に入ります。

読み取り対応#

ビルドのたびに、HTML の隣に機械可読なコンパニオンを出力します。 llmstxt.org の慣習に従っています:

• /llms.txt — 全ページのリンク優先のインデックス。
• /llms-full.txt — コーパス全体を 1 つの Markdown ストリームに。
• 各ページの .md ミラー — HTML の背後にある Markdown をそのまま。

エージェントは、レンダリング済みページをスクレイピングする代わりに、きれいな Markdown としてドキュメントを読めます。デフォルトでオン。site.ai を参照してください。

エージェントから操作可能#

エージェントは、人間向けの出力を解析せずに Ovellum を操作できます。build、check、 diff は安定した終了コードとともに --json を話し、 ovellum mcp は Model Context Protocol サーバーを起動して操作をツールとして公開します。セットアップはコピー＆ペーストで済みます — 生成される AGENTS.md と Claude Skill が、使い方を エージェントに伝えます。

安全に編集可能#

これは、他のどんなドキュメントツールも提供しないものです。Ovellum の hybrid マージエンジンが手書きの文章を 保護ゾーンの中に保つため、エージェントは 生成ドキュメントに本物の文章を寄与し、それを次回の再生成でも生き延びさせることが できます — 人間が @manual マーカーの間を編集するのと、まったく同じ保証です。MCP 経由なら ovellum_write_zone ツールです。

そして、リファクタリングがその文章の足場を動かしても、文章は失われません。 ovellum diff がリネームの可能性を示し、 再配置できないものは黙って捨てられる代わりに、レビュー用に .ovellum/orphans/ へ隔離されます。

読み取り対応、操作可能、そして安全に編集可能 — 人間の文章と生成ドキュメントを正直に 保つのと同じアンチドリフトの契約を、エージェントにも広げたものです。まずは 自動化と AI エージェントガイドから。