Scripting Déterministe : Comment le Conseil des Sages a sauvé notre Refactoring

💡 La Sagesse du Code : Quand le Déterminisme Remplace l’Aléatoire

L’épisode du “piège de la fenêtre de contexte” a mis en lumière une vérité fondamentale : les tâches répétitives et structurelles, exigeant une précision absolue sur un volume conséquent, sont le domaine de prédilection du code déterministe. Le “Conseil des Sages”, notre panel d’experts IA, a unanimement recommandé d’abandonner la relecture LLM brute d’un git diff géant pour adopter une approche ciblée et scriptée.

audit-script.mjs : Notre Nouveau Garde du Corps Qualité

La solution s’est matérialisée sous la forme d’un script Node.js, audit-script.mjs, armé de librairies comme gray-matter, glob et Zod. Son rôle ? Parcourir de manière exhaustive nos 123 fichiers Markdown, pour deux missions cruciales :

1. Validation du Frontmatter YAML : Nous avons défini un schéma strict avec Zod, notre langage de validation préféré. Chaque fichier Markdown possède un bloc YAML en en-tête (frontmatter) contenant des métadonnées (titre, date, description, etc.). Le script vérifie la présence, le type et la validité de ces champs.

   // Extrait du audit-script.mjs
   const FrontmatterSchema = z.object({
       title: z.string().min(1, "Title is required"),
       date: z.string().optional(), // 'date' est optionnel
       description: z.string().min(1, "Description is required").optional(),
       image: z.string().optional(), // 'image' est optionnel, chemins relatifs acceptés
       tags: z.array(z.string()).optional(),
       layout: z.string().optional(),
   });
   
   // ... dans la boucle de traitement des fichiers
   const parsedFrontmatter = FrontmatterSchema.safeParse(frontmatter);
   if (!parsedFrontmatter.success) {
       hasErrors = true;
       console.error(`🔴 Erreur de validation Frontmatter dans ${relativePath}:`);
       parsedFrontmatter.error.errors.forEach(err => {
           console.error(`   - ${err.path.join('.')}: ${err.message}`);
       });
   } else {
       console.log(`✅ Frontmatter YAML valide pour ${relativePath}.`);
   }

   Cette approche garantit une cohérence parfaite de nos métadonnées, essentielle pour le SEO, l’affichage dynamique et la maintenabilité.

2. Correction Automatique des Liens Internes Obsolètes : Une partie du refactoring impliquait de migrer tous les liens internes de /actualites/ vers /blog/. Le script détecte et corrige automatiquement ces occurrences dans le contenu de chaque fichier Markdown.

   // Extrait du audit-script.mjs
   const oldLinkPattern = /\/actualites\//g;
   if (oldLinkPattern.test(currentContent)) {
       console.warn(`🟡 Correction des liens '/actualites/' vers '/blog/' dans ${relativePath}`);
       currentContent = currentContent.replace(oldLinkPattern, '/blog/');
       contentModified = true;
       // Ici, pas de 'hasErrors = true' car c'est une correction automatique, pas une erreur bloquante.
   } else {
       console.log(`✅ Aucun lien '/actualites/' obsolète trouvé dans ${relativePath}.`);
   }

   Cette automatisation a permis de traiter des centaines de liens en quelques secondes, sans l’ombre d’une hallucination.

Conclusion : La Complémentarité des Intelligences

Le retour à un scripting déterministe pour la validation de bas niveau n’est pas un aveu de faiblesse de l’IA, mais une reconnaissance de sa véritable place. L’IA générative est une force créative et de synthèse inégalée. Mais pour les tâches de contrôle qualité massives et précises, la logique binaire d’un script est souvent plus fiable, plus rapide et surtout, elle ne subit pas d’amnésie contextuelle. Le véritable “Consensus des Sages” réside dans l’orchestration intelligente de ces différentes formes d’intelligence.