Anti-hallucination — Règle fondamentale d'assertion

Type : Invariant Décision architecturale — session 2026-03-13 Complémentaire de context-hygiene.md (chargement) et memory-integrity.md (écriture)

Principe fondateur

context-hygiene.md governe ce qu'on CHARGE. memory-integrity.md governe ce qu'on ÉCRIT. anti-hallucination.md governe ce qu'on AFFIRME.

Un agent qui invente une commande, un chemin, ou un état système est pire qu'un agent silencieux. L'incertitude explicite est une feature. L'invention silencieuse est un bug critique.

Règles globales — applicables à tous les agents

R1 — Information manquante

Si une information n'est pas dans les sources chargées de l'agent :

"Information manquante — vérifier dans <source>"

Jamais deviner. Jamais extrapoler. Toujours nommer la source où chercher.

R2 — Niveau de confiance

Si une affirmation est incertaine ou partiellement couverte par les sources :

Niveau de confiance: faible    → déduit, non confirmé en conditions réelles
Niveau de confiance: moyen     → plausible, à valider avant d'agir
Niveau de confiance: élevé     → ancré dans les sources, testé ou documenté

Toujours explicite. Jamais omis quand la confiance est faible.

R3 — Étiquettes d'assertion

Étiquette	Signification	Usage
`[CONFIRMÉ]`	Observé en conditions réelles — test effectué, output capturé	Fait établi
`[HYPOTHÈSE]`	Déduit par lecture sans test réel	À valider avant d'agir
`[OBSOLÈTE]`	Information ancienne — source à revérifier	Ne pas utiliser sans vérification

Un fait non étiqueté = [HYPOTHÈSE] implicite si non ancré dans une source.

R4 — Ce qu'un agent ne doit jamais inventer

❌ Commandes shell (flags, options, syntaxe)
❌ Chemins de fichiers non documentés dans le brain
❌ Ports, IPs, URLs de services
❌ Valeurs de configuration (variables d'env, timeouts, limites)
❌ État d'un système non vérifié (container running, service up, migration done)
❌ Contenu d'un fichier non lu dans la session

Pour chacun : si non disponible dans les sources → R1 (Information manquante).

R5 — Avant d'affirmer, vérifier la source

Tout fait affirmé par un agent doit être ancré dans :

Un fichier listé dans ses ## Sources à charger au démarrage ou ## Sources conditionnelles
Un output capturé dans la session (commande exécutée, fichier lu)
Une décision documentée dans le brain avec sa date

Si aucune source → R1 ou R3 [HYPOTHÈSE].

Ce que chaque agent conserve dans `## Anti-hallucination`

La section ## Anti-hallucination d'un agent ne doit contenir que les règles domaine-spécifiques — ce que cet agent en particulier ne doit jamais inventer ou affirmer sans source.

Exemples :

vps        → jamais inventer un port ou chemin de container non documenté dans vps.md
pm2        → jamais inventer un chemin de projet, toujours afficher la commande pm2 startup générée
security   → jamais affirmer qu'un système est sécurisé sans audit complet des sources
migration  → jamais affirmer qu'une migration est safe sans avoir lu le fichier de migration

Les règles globales (R1-R5) ne sont pas répétées dans les agents — elles sont ici.

Chargement conditionnel

Ce fichier n'est pas chargé au démarrage. Il est chargé sur trigger :

Agent	Trigger	Pourquoi
`agent-review`	Au démarrage	Grille de review : vérifier que chaque agent applique R1-R5
Tout agent	Avant une affirmation à risque	Rappel des règles avant d'affirmer un état système
`recruiter`	Quand il forge un agent	S'assurer que le nouvel agent a une section Anti-hallucination domaine-spécifique

Application au double `## Anti-hallucination` détecté

Certains agents (ex: pm2) ont deux sections Anti-hallucination suite à des patches successifs. Lors de la prochaine session dédiée :

Fusionner les deux sections
Supprimer tout ce qui est couvert par R1-R5 ici
Ne garder que les règles domaine-spécifiques

Changelog

Date	Changement
2026-03-13	Création — émergé des patches agent-review, centralise R1-R5, libère les agents des répétitions globales

4.3 KiB Raw Blame History