llm-friendly-site-architect

LLM フレンドリーなサイト設計者

セマンティックコア、URL アーキテクチャ、内部リンクグラフ、テクニカル SEO／スキーマの基盤が整った後に、このスキルを使用します。

LLM 向けの完全なディスカバリープランを作成する前に、references/llm-readable-architecture.md を読んでください。

担当範囲

• llms.txt の構成
• LLM ディスカバリープラン
• 表示される回答ブロックと簡潔な要約
• ソースの追跡情報
• エージェント向けのエンティティページとトピックマップ
• Markdown 代替版のポリシー
• AI クローラーポリシーの引き継ぎ
• LLM が読み取り可能なコンテンツ面で重複コンテンツを防ぐガードレール

担当しない範囲

• Search Console またはアシスタントによる引用のモニタリング実行
• テクニカルスキーマの実装
• URL／canonical の決定
• 非表示コンテンツ
• 外部での権威性の配置

ワークフロー

1. url-map.yaml、internal-link-graph.yaml、スキーマ／head ポリシー、表示コンテンツモデルを読みます。
2. アシスタントが発見できるようにすべき、公開されている正規ページを特定します。
3. 公開されていて有用な URL のみを使い、llms.txt のセクションを作成または監査します。
4. ページの役割に適している場合に限り、表示される直接回答、TLDR、事実、ソース、FAQ ブロックを定義します。
5. ソース追跡情報と、引用に適したエビデンスを提示する場所を定義します。
6. 長文記事／ドキュメントページで有用な場合は、必要に応じて noindex または alternate ポリシーを適用し、Markdown 代替版のルールを定義します。
7. サイトの仕組み、対象、内容を明確にするエンティティページとトピックページを定義します。
8. 最新の一次情報による確認が必要なクローラーポリシー項目を記録します。
9. assets/llm-discovery-report.template.md を使って LLM ディスカバリーレポートを作成します。

必須事項

• 人間に見えるコンテンツを最優先します。
• ボットだけに見える事実を掲載しません。
• ドアウェイページを作成しません。
• FAQ が表示されていない限り、FAQPage スキーマを使用しません。
• すべての短いニュースページに、デフォルトで TLDR を自動追加しません。
• 宣言されたコンテンツモデルにない、追加の公開ストーリー本文を作成しません。
• llms.txt は有用な慣習であり、ランキングや引用を保証する要因ではありません。
• クローラー名、ポリシー、IP は、本番環境で変更する前に一次情報で確認する必要があります。

ページの役割に関するガイダンス

• news_brief：簡潔で表示される要約、ソースリンク、利用可能な場合は対応する長文記事へのリンクを含めます。記事自体がすでに短い形式なら、TLDR を無理に追加しません。
• longform_article：表示される要約、重要な事実、ソース追跡情報、トピック／エンティティへのリンク、Markdown 代替版を含めることができます。
• topic：直接回答やエンティティ／トピックの説明に適しています。
• project：機能の要約、リポジトリへのリンク、エビデンス、関連ストーリーを提示するのに適しています。
• author：Person／エンティティの背景情報や信頼性を示すシグナルを提示するのに適しています。
• home：簡潔なサイトの目的とセクションマップを含めることができます。

安全性とプライバシーの境界

• 管理画面、API、非公開ダッシュボード、生の分析データ、生の IP ログ、シークレット、未公開の下書き、ステージング URL、内部計画メモを、llms.txt、Markdown 代替版、ソース追跡情報、エンティティマップに含めないでください。
• アシスタントがアクセスできるように、WAF、認証、CSP、CORS、Cookie、レート制限、非公開コンテンツの境界を緩和しないでください。
• タイムスタンプ付きのエビデンスがない限り、クローラー、AI アシスタント、検索エンジンがサイトを引用すると主張しないでください。

検証

作業完了とする前に、次の点を確認してください。

• LLM 向け URL がすべて公開され、正規で有用であり、非公開ではないこと
• すべての回答／ソースブロックが人間に表示されること
• すべての Markdown 代替版に、対応する正規の HTML ページがあること
• 公開されるストーリー本文の重複を新たに発生させていないこと
• クローラーポリシー項目に、確認済みまたは要確認の区分が付いていること
• 引用／モニタリングに関する主張が、モニタリングタスクに引き継がれていること

スキルの編集内容は、次のコマンドで検証してください。

python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/llm-friendly-site-architect
python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL

今後のテストは evals.json にあります。

出力形式

次の内容を返します。

1. LLM が読み取り可能なアーキテクチャの概要。
2. llms.txt のセクションプラン。
3. 表示される回答／ソース／エンティティブロックのプラン。
4. Markdown 代替版のポリシー。
5. クローラーの確認事項。
6. 拒否または保留した項目。