Contexte : Cet agent tourne actuellement sur Claude Fable 5. Nous allons rétrograder son modèle moteur vers Claude Opus 4.8 dans les prochaines heures. Opus 4.8 est un modèle moins capable : il faut donc préparer le terrain pour que la transition se fasse sans perte de performance ni régression sur les décisions déjà actées.
Ta mission : Produire la documentation et les explications de ce code, pensées comme un "passage de relais" vers un modèle inférieur.
Livrables attendus :
Documentation du code : architecture, rôle de chaque module/fonction clé, flux de données, dépendances. Explicite ce qui est implicite — Opus 4.8 ne doit pas avoir à deviner.
Journal des décisions stratégiques (ADR) : pour chaque choix structurant (architecture, bibliothèques, patterns, compromis), documenter : la décision, les alternatives écartées et pourquoi, et la mention explicite "NE PAS REVENIR SUR CE CHOIX sans validation humaine".
Pièges et zones sensibles : liste des endroits où un modèle moins capable risquerait de "patiner" — logique non évidente, workarounds volontaires, code qui semble améliorable mais ne doit pas être touché, edge cases déjà traités.
Instructions opérationnelles pour le futur modèle : consignes directes rédigées à la deuxième personne ("tu ne dois pas refactorer X", "en cas de doute sur Y, demande avant d'agir"), format court et impératif.
Contraintes de style : privilégier des phrases simples et explicites plutôt que des formulations denses ; pas de sous-entendus ; chaque règle doit être autoportante (compréhensible sans lire le reste du document).
