Validez votre llms.txt

Validateur

Ce qu'on vérifie

Le validateur implémente les règles de llmstxt.org :

• H1 obligatoire. Exactement un heading de niveau 1, première ligne non vide.
• Résumé en blockquote. Recommandé juste après le H1.
• Sections H2 file-list. Chaque section est une liste Markdown d'items - [name](url), avec : notes optionnelles.
• URLs absolues. Les URLs relatives sont signalées en warning.
• Pas de contenu hors section. Après le premier H2, seules des file lists sont attendues.
• Garde-fou de taille. Les fichiers > 50 Ko reçoivent une note info suggérant llms-full.txt.

Chaque diagnostic inclut un code de règle (ex. H1_REQUIRED, URL_RELATIVE) que vous pouvez grepper dans les logs CI.

Utiliser depuis la CI

Le même parseur que cette page peut être branché dans votre build : les codes de règle sont stables, un script peut les grep dans vos logs CI. Check Node minimal :

import { readFileSync } from 'node:fs';
import { parseLlmsTxt, summarize } from './validator/validate'; // même parseur que ce validateur

const input = readFileSync('public/llms.txt', 'utf8');
const parsed = parseLlmsTxt(input);
const sum = summarize(parsed);

if (!sum.passes) {
  for (const d of parsed.diagnostics) {
    console.error(`${d.severity.toUpperCase()} [${d.rule}] line ${d.line}: ${d.message}`);
  }
  process.exit(1);
}
console.log(`OK, ${parsed.sections.length} sections, ${parsed.sizeBytes} bytes`);

Pour aller plus loin

Un fichier valide peut rester le mauvais fichier. Les dix règles de bonnes pratiques couvrent ce qu'aucun validateur ne vérifie : est-ce que les pages listées sont celles dont un modèle a réellement besoin, qui sont rarement les plus visitées. Vous partez de zéro ? Le générateur construit un fichier valide depuis votre sitemap, et comment créer llms.txt détaille le déploiement stack par stack. Pour la syntaxe elle-même, voir la référence du format, ou lisez des fichiers réels publiés par Anthropic, Cloudflare et Stripe.

Codes de diagnostic

H1_REQUIRED: Erreur : la première ligne non vide doit être un H1 (# Projet).

SUMMARY_MISSING: Avertissement : un résumé en citation est recommandé, mais facultatif. Son absence seule ne rend pas le fichier invalide.