Codex comprend mal l’architecture existante

Codex crée un helper déjà existant, choisit le mauvais dossier ou contourne un pattern que le projet utilise partout ailleurs. Ce symptôme donne souvent l’impression que le modèle est mauvais ou que l’outil n’est pas assez puissant. En pratique, il révèle surtout un problème de système de travail : contexte dispersé, sortie mal définie, critères implicites ou validation trop tardive.

• Repérer exactement où le résultat devient inutilisable.
• Distinguer problème d’outil, problème de contexte et problème de validation.
• Mesurer le coût réel : reprises, erreurs, perte de confiance ou blocage d’équipe.

L’agent passe trop vite à l’implémentation sans explorer les responsabilités, conventions, tests et décisions historiques. L’IA complète ce qui manque avec des hypothèses plausibles. Tant que ces hypothèses restent invisibles, chaque nouvelle tentative peut sembler différente alors que la vraie faille reste la même : le workflow ne dit pas assez clairement ce qui doit être stable.

• Écrire les règles que l’IA ne doit plus deviner.
• Séparer contexte permanent, demande du moment et décisions déjà prises.
• Nommer les limites : ce que l’IA peut proposer, modifier ou refuser.

Demande une phase d’exploration sans édition, puis un plan qui cite fichiers analogues, conventions locales et risques. La correction ne consiste pas à chercher un prompt miracle. Elle consiste à transformer la tâche en processus relisible : objectif, entrées, étapes, critères de sortie et revue. Cette structure réduit les variations et rend les erreurs plus faciles à corriger.

• Commencer par un brief court avec objectif, public, contraintes et livrable attendu.
• Découper la tâche en étapes : cadrage, production, critique, correction et livraison.
• Conserver les décisions utiles dans une note ou un fichier de contexte réutilisable.

Le patch doit ressembler au reste du repo : mêmes noms, mêmes exports, mêmes niveaux de tests et mêmes frontières de modules. Un bon contrôle qualité n’a pas besoin d’être lourd. Il doit seulement arriver au bon moment, avec une grille claire. Plus le livrable influence une décision, un client, un repo ou une donnée métier, plus la revue doit être explicite.

• Demander une revue adverse pour identifier omissions, contradictions et hypothèses fragiles.
• Vérifier sources, exemples, données, tests ou critères d’acceptation selon le livrable.
• Garder une validation humaine pour les décisions sensibles ou les sorties externes.

Le code fonctionne dans l’instant, mais crée une deuxième architecture difficile à maintenir. Ce risque est souvent progressif : au début, tu corriges vite. Puis les corrections deviennent la norme, les standards se dispersent et les personnes arrêtent de faire confiance aux sorties IA. Le coût n’est plus seulement technique ; il devient organisationnel.

• Accumulation de dette invisible dans les contenus, fichiers, specs ou automatisations.
• Difficulté à transmettre la méthode à une autre personne ou à une équipe.
• Perte du gain de temps initial parce que chaque sortie demande une reprise manuelle.

Ce sujet concerne surtout les équipes qui veulent utiliser Codex sur des codebases réels. Workshop ChatGPT/Codex est le point de départ le plus pertinent si tu veux traiter ce blocage sur des cas réels, avec une méthode directement applicable. AI App Builder peut compléter quand le problème touche aussi aux documents, au code, aux workflows ou à la production d’équipe.

• Travailler sur tes propres exemples plutôt que sur des démonstrations génériques.
• Produire des modèles de contexte, checklists et workflows réutilisables.
• Décider quoi automatiser, quoi garder manuel et quoi valider avant usage réel.