Gates et validation
Evidence Gate, Fact Gate, Knowledge Gate, Scope Gate, Verification Gate, Design Gate et Context Budget Gate.
Gates et validation
Un gate est un contrôle. Il évite que Codex avance sur une supposition ou livre sans preuve.
Gates principaux
| Gate | But | Application concrète |
|---|---|---|
| Evidence Gate | Vérifier les sources avant de planifier. | RepoMap ou KG -> fichiers candidats -> lecture code réel -> tests/logs. |
| Fact Gate | Empêcher les conclusions factuelles non prouvées. | Si Codex peut vérifier dans le repo, les logs, les tests ou la documentation officielle, il doit vérifier avant d'affirmer. |
| Knowledge Gate | Construire la carte du changement. | Lire CODEBASE_MAP.md, puis les fichiers réels. En mode Nexus, le KG oriente mais le code réel tranche. |
| Scope Gate | Rester dans le périmètre du lot. | Pas de dépendance, migration, webhook, cron ou relaxation CORS sans validation. |
| Verification Gate | Prouver que le changement fonctionne. | Exécuter les commandes utiles ou documenter pourquoi c'est impossible. |
| Design Gate | Contrôler la qualité UI/UX. | Obligatoire pour toute UI non triviale. |
| Context Budget Gate | Prévenir la perte de contexte. | Créer NEXT_SESSION_PROMPT.md quand la session devient risquée. |
SR Core et SR Nexus KG
En mode SR Core, Codex s'appuie sur CODEBASE_MAP.md, les fichiers SR et la lecture directe du code.
En mode SR Nexus KG, un Knowledge Graph Nexus peut aider à identifier fichiers, routes, composants, services, dépendances, tests et zones à risque.
Le KG oriente la recherche, mais il ne remplace jamais la lecture du code réel. Si le KG et le code divergent, le code réel tranche.
Mauvais et bon Fact Gate
Mauvais :
C'est probablement un problème d'affichage.Bon :
J'ai vérifié src/pages/Dossier.tsx et api/dossiers.ts. Le backend renvoie bien status, mais le composant affiche legacyStatus. La cause vérifiée est donc le mapping frontend.Si Codex n'a pas vérifié :
Fact Gate non satisfait : je dois lire <source> avant de conclure.Commande de contexte
L'utilisateur n'a normalement pas à l'exécuter lui-même. Codex doit la lancer lorsque la session devient longue, que plusieurs lots ont été enchaînés, qu'un gros lot vient d'être terminé ou que le contexte semble confus.
python3 scripts/codex/context_budget_report.py --root . --compact| Statut | Comportement attendu |
|---|---|
| green | Codex peut continuer. Il n'a pas besoin d'en parler sauf demande explicite. |
| yellow | Codex peut continuer, mais doit être prudent si la prochaine tâche est longue. |
| orange / red | Codex doit préparer NEXT_SESSION_PROMPT.md et recommander une nouvelle conversation. |
| stale / ambiguous / unknown | Le rapport n'est pas fiable. Codex doit sécuriser la reprise. |
Validation humaine stricte
Codex peut analyser sans validation préalable. Mais tout changement de fichier, publication, push, migration, dépendance, configuration, action destructive ou changement métier exige validation explicite du périmètre.