llms.txt バリデータのエラー：却下すべきか、警告すべきか？

V2 提案では、H1 のプロジェクト名またはサイト名だけが必須セクションです。バリデーターは、H1 がない場合や不正な H1、壊れたファイルリストのリンク構文を拒否すべきです。公開ルールがより厳しいプロファイルを明確に定義していない限り、概要がないこと、相対 URL、大きなファイルを無効とは判定すべきではありません。

重要なポイント

• 必須構文と編集上の指針には、異なる重大度が必要です。
• 測定した H1 先頭のレスポンス 113 件のうち 90 件が引用ブロックを使い、残りの 23 件はその頻度が要件ではないことを示しています。
• 機械可読なルールコードにより、CI の動作を監査できます。

何をエラーにすべきですか？

エラーは、提案に従ってパーサーが解釈できないコンテンツを特定するべきです。空のファイル、最初の意味のある行が H1 でない場合、追加の H1、Markdown リンクではないファイルリスト項目などが例です。

行番号と安定したルールコードが重要です。H1_REQUIRED は実行可能ですが、「ファイルが悪い」ではありません。CI ジョブは、主観的なスタイルの好みではなく、文書化されたエラーに対してだけゼロ以外で終了するべきです。

何を警告として残すべきですか？

引用ブロックの概要は任意です。説明用の前文、H2 セクション、リンク後の注記、Optional セクションも任意です。バリデーターは理解しやすくなる場合に推奨できますが、提案を書き換えてはいけません。

相対 URL には、元のコンテキストの外では曖昧になり得るため、注意書きが必要です。ただし V2 は、絶対 URL だけを構文上可能な形式とはしていません。ファイルサイズもコンテキスト次第です。小さく厳選したファイルのほうが消費しやすい場合でも、大きなドキュメントマップが意図的なことはあります。

本番のファイルはどのようなものですか？

私たちのディレクトリスナップショットには、テキストを返し H1 で始まる 113 ファイルが含まれます。90 ファイルは引用ブロックの概要を使っています。中央値は H2 セクション 7 件と解析済みリストリンク 76 件で、観測されたセクション数は 0 から 84 の範囲です。

これらの分布は、頻度を有効性と混同してはいけない理由を示します。よくある機能だからといって自動的に必須とは限らず、珍しくても許可された構造だからといって自動的に誤りとは限りません。正式なルールと実例を並べて確認します。

透明性のある重大度ポリシー

正確なルール、その重大度、仕様のバージョンを公開します。3 つの層を分けます。

1. エラー: パーサーが必要な構造を構築できません。
2. 警告: 許可されたコンテンツによって移植性や明確さが下がる場合があります。
3. 情報: サイズや発見関係の欠落など、運用上の観測です。

無料バリデーターで行単位の診断を確認し、そのうえで、構文チェッカーでは判断できない選択についてベストプラクティスガイドを参照します。

形式リファレンスは文法を定義し、検証済みの実例は本番ファイルの違いを示します。

引用ブロックがないと無効ですか？

いいえ。V2 では任意ですが、役立つことが多い機能です。

50 KB を超えるファイルは無効ですか？

提案に普遍的な最大値はありません。サイズは情報提供のレビューを促すことはあっても、作り上げた構文エラーにはなりません。

有効なファイルでも質が低いことはありますか？

はい。構文だけでは、選ばれたページが最新か、関連性があるか、安全かを判断できません。