ガバナンスアーティファクト
このページが対象とするガバナンスファイル
このページは、アイデンティティ、優先順位、限界、コーパスの読解条件を宣言する公開サーフェスに結びついています。以下の順序が、推奨される読解の順序です。
- 01セマンティックルーター
- 02ルートマップ
- 03コンテンツ目録
セマンティックルーター
/semantic-router.json
インテントの種類に応じて、読解をコーパスの適切な部分へ方向づけるサーフェス。
- 統御する対象
- 発見可能性、クロールの方向づけ、公開されたサーフェスのマッピング。
- 画定する範囲
- 構造、ルート、または推奨されるMarkdownサーフェスを無視する不完全な読解。
保証しないこと： 優れた発見サーフェスはアクセスを改善するが、それ単独では再構成を統御するのに十分ではない。
ルートマップ
/site-route-map.json
FR ↔ ENのルートと、公開済みのパブリックな対応関係のマップ。
- 統御する対象
- 発見可能性、クロールの方向づけ、公開されたサーフェスのマッピング。
- 画定する範囲
- 構造、ルート、または推奨されるMarkdownサーフェスを無視する不完全な読解。
保証しないこと： 優れた発見サーフェスはアクセスを改善するが、それ単独では再構成を統御するのに十分ではない。
コンテンツ目録
/site-content-index.json
サイトで公開されたページ、記事、サーフェスのマシンファースト目録。
- 統御する対象
- 発見可能性、クロールの方向づけ、公開されたサーフェスのマッピング。
- 画定する範囲
- 構造、ルート、または推奨されるMarkdownサーフェスを無視する不完全な読解。
保証しないこと： 優れた発見サーフェスはアクセスを改善するが、それ単独では再構成を統御するのに十分ではない。
補完的なアーティファクト（3）
これらのサーフェスは主要ブロックを補完します。テーマに応じて、文脈、発見、ルーティング、観察を加えます。
セマンティックスキーマインデックス
/semantic-schema-index.jsonld
公開されたスキーマと構造化された投影のインデックス。
編集コンテキスト
/editorial-context.md
編集上の姿勢、トーン、抽象度、責任を定める説明文書。
AI変更履歴
/changelog-ai.md
ガバナンス、アイデンティティ、マシンファーストサーフェスの変更ログ。
ドキュメント、ヘルプセンター、料金、変更履歴：製品ソース階層
多くのサイトは、同じ製品をさまざまなサーフェスを通じて記述している。機能ページ、ドキュメント、ヘルプセンター、FAQ、料金、バージョン履歴、契約、サポートの回答などである。人間の読者にとって、これらのサーフェスは同じステータスをもたない。しかし合成システムにとっては、同じ「製品について」の変種として認識されることが多い。
これこそ、このページが境界を設けようとする横滑りである。問題は、製品が複数の場所で文書化されていることではない。問題が生じるのは、それらの場所がどの種類の言明について、どのソースが優先するのかを宣言していないときである。
この階層は、より単純なマーケティングの文章を作るためのものではない。AIが、同じ行為について語っていないサーフェスから平均的な真実を再構成することを防ぐために存在する。ここでいう行為とは、能力、提供状況、商業上の条件、バージョン履歴、契約上のコミットメント、文脈的な説明である。
1. すべての製品ページが同じ行為を行うわけではない
製品ページは料金ページと等価ではない。料金ページは変更履歴と等価ではない。変更履歴は契約と等価ではない。サポートの回答は正規の定義と等価ではない。
これらのサーフェスは、同じ対象に関わりながら、それぞれ異なる機能を果たしうる。
- 紹介ページは、ペリメーターや読解上の約束を記述する
- ドキュメントは、動作、パラメーター、使用上の制限を記述する
- ヘルプセンターは、サポートや理解に関わる事例を扱うことが多い
- 料金ページは、商業上のアクセス条件を規定する
- 変更履歴は、時間性と陳腐化を規定する
- 契約やポリシーは、何が対抗可能になるかを枠づける
- サポートの回答は、文脈的で一般化できないことが多い
内因的ガバナンスは、こうした文書上の行為を区別しないままカノンを名指すだけなら不完全である。
2. 製品の真実は分散しているがゆえに、階層化できる
解釈される環境において、製品の真実は均質な塊としては現れない。属性の種類ごとに分散している。
いくつかの例で問題を示すには十分である。
- ある機能の存在は、すべてのプランでの提供を証明しない
- ヘルプセンターのキャプチャは、契約上の約束を確立しない
- アップデートの告知は、恒久的な保守と同じではない
- 古い料金ページは、もはや何も統御していないのに読み取れるままでありうる
- サポートの回答は、製品の一般的な動作を定義することなく、ローカルな事例を解決しうる
したがって、製品ソース階層とは、どの属性を、どこで、どのバージョンのもとで、どの範囲で読まなければならないかを宣言することである。
この論理はソース階層（英語）を延長するものだが、それをサイト内のコーパスそのものの内部に適用する。裁定はもはや、サイト内とサイト外を対置するだけではない。同じ管轄をもたない内部のサーフェス同士を対置するのである。
3. 合成システムがこれらのサーフェスを混同する理由
合成システムは、構造化され、短く、断定的な定式化を好む。ところが、料金ページ、機能表、ヘルプセンター、サポートの回答には、まさにこの種の素材が含まれている。
その結果、いくつかの混同が繰り返し生じる。
- 料金が製品のペリメーターを再定義する
- ヘルプセンターが、よくある事例から一般的なルールを再定義する
- サポートの回答が暗黙の約束になる
- 変更履歴が、陳腐化の目印としてではなく装飾的な沿革として読まれる
- 技術ドキュメントが、より単純な商業的定式化によって押しつぶされる
すでに公開されている機能と混同されるSaaSの料金プラン（英語）とAIが権威なしに企業をコミットさせるときのカスタマーサポート（英語）に関する分析が示すように、問題はこれらのサーフェスが存在することではなく、それらのあいだに読み取れる階層が欠けていることにある。
4. 変更履歴は装飾ではない
変更履歴、すなわちバージョン履歴は、「何かが起きた」ことを示すだけのものではない。製品のバージョン支配力を統御するものである。
非推奨化、削除、置き換え、発効日を示す明確なシグナルがなければ、古い記述は再利用可能な素材として利用できる状態にとどまる。削除された機能が引用され続けることがある。変更された制限が繰り返され続けることがある。古い約束が、まだ現行のものであるかのように生き残ることがある。
ここで解釈残留と解釈的負債が中心的な問題となる。もはや真ではないものが再構成され続けるために、多数派である必要はない。古いバージョンが新しいバージョンよりも再利用しやすいままであれば十分である。
5. 未特定のほうが平均化された回答よりも忠実であるとき
よく統御された製品の階層は、すべてを断定可能にしようとするものではない。ある種の断定を条件なしには不可能にしようとするものである。
価格が数量、契約、管轄に依存するなら、正しい出力は平均値ではない。ある機能が1つのプランにしか存在しないなら、正しい出力は留保なしの「この製品はXを行う」ではない。サポートの回答が文書化された事例にのみ有効であるなら、それが一般的な真実になってはならない。
Q-Layerと応答条件の役割は、まさに、合成が異質なサーフェスを均質な回答に変えてしまうことを防ぐことにある。
6. 最低限の製品階層が宣言しなければならないもの
最低限の製品階層は、少なくとも次の区別を見えるようにすべきである。
- 定義ソース：製品のペリメーターが宣言される場所
- 実行ソース：動作が説明される場所
- 商業ソース：アクセス条件に境界が設けられる場所
- 時間ソース：陳腐化、削除、発効日が述べられる場所
- 文脈ソース：特定の事例が一般化されることなく扱われる場所
ここでは正規の相互参照システム（英語）が不可欠になる。これらのサーフェス間に明示的な相互リンクがなければ、AIは意図された階層を受け継がない。文書上の近接性を再構成し、それを等価性として解釈してしまう。
多言語環境では、状況はさらに脆弱になる。そこでは、フランス語のドキュメント、英語の料金ページ、部分的に翻訳された変更履歴が、混成的な回答を生み出しうる。
7. 範囲と限界
このページは、UXの指針も、法的助言も、製品のプロトコルも提供しない。ドクトリン上の論点を1つ確立する。製品は「より多くのコンテンツ」によってのみ統御されるのではなく、その真実のサーフェス間の明示的な階層によって統御される。
課題はコーパスを縮小することではない。課題は、同じ権威を行使していないページを、合成が等価なものとして扱うことを防ぐことである。