chimera-state-what-you-did-not-check

Vous livrez quelque chose qui se lit comme un état des lieux : une revue de code, une passe de sécurité, « les trois plus gros problèmes », un backlog priorisé, une comparaison d'options. Tout ce où vous avez regardé une partie d'un espace et produit un classement.

Cela ne s'applique pas à la réponse à une question bornée — « cette fonction gère-t-elle une liste vide ? » — où le périmètre est déjà tout ce qui a été demandé. Le risque ici est spécifique à une sortie dont la forme est une liste des pires problèmes, parce que cette forme porte un « de tout » implicite que le lecteur fournira gratuitement.

1. Ouvrez par le périmètre, avant les conclusions. Nommez ce que vous avez réellement lu : chemins ou globs, le commit ou la branche, et si vous avez exécuté quelque chose ou seulement lu. Reviewed: src/api/*.py at 4f2a1c9, static read only, no tests executed.
2. Listez les exclusions avec leur raison, et gardez les raisons concrètes : pas d'accès aux migrations, la suite d'intégration exige des identifiants que je n'ai pas, le frontend sortait du budget de cette passe.
3. Rapportez chaque superlatif à ce que vous avez lu. Non pas « le pire problème est la vérification d'authentification manquante » mais « le pire des six handlers que j'ai lus ». Les deux phrases coûtent pareil et ne veulent pas dire la même chose.
4. Séparez « vérifié et propre » de « non vérifié ». Un lecteur prend le silence pour un satisfecit ; un seul de ces deux états le mérite.
5. Nommez l'élément non vérifié le plus susceptible de dépasser votre numéro un actuel, pour que le lecteur sache ce qu'achèterait la passe suivante. Si rien de plausible ne le pourrait, dites-le aussi — c'est une vraie conclusion.

Les listes d'exclusions peuvent enfler jusqu'à l'immunité générale : un document qui décline tout n'affirme rien, et les relecteurs qui en écrivent cessent d'être responsables de la partie qu'ils ont couverte. Limitez la liste aux exclusions qu'un lecteur supposerait sinon incluses.

Énoncer le périmètre invite aussi à « allez vérifier le reste », ce qui est parfois le mauvais choix — une passe délibérément partielle sur la surface la plus à risque peut être le bon usage du temps. Si c'est le cas, dites pourquoi cette surface a été choisie, sinon la divulgation honnête se lira comme un travail inachevé.

Et le périmètre ne remplace pas la profondeur. « J'ai lu ces six fichiers » ne veut pas dire que les six ont été bien lus, et une frontière précise autour d'un travail superficiel donne quand même des conclusions superficielles.