Template de post-mortem d'incident pour un changement écrit par l'IA
Mis à jour le
Un template de post-mortem sans recherche de coupable pour les incidents dus à un changement de l'IA : la tâche, l'outil, les preuves à la fusion, et l'étape de revue ou la barrière qui l'a manqué.
Copiez ce template dans votre outil de suivi des incidents ou votre wiki. Remplacez les [crochets], supprimez les sections dont vous n'avez pas besoin, puis supprimez cette note. Restez sans recherche de coupable : décrivez ce que les personnes et les outils ont fait et ce qu'ils pouvaient voir, pas qui aurait dû être plus avisé.
- Incident : [identifiant et titre court]
- Gravité : [SEV1 / SEV2 / SEV3]
- Date et durée : [AAAA-MM-JJ, de HH:MM à HH:MM UTC]
- Auteur : [nom]
- Relu par : [noms]
- Statut : [brouillon / relu / actions terminées]
1. Résumé
[Deux ou trois phrases : ce qui a cassé, qui a été touché, pendant combien de temps, et ce qui l'a causé.]
2. Impact
- Utilisateurs ou clients touchés : [nombre ou proportion, et comment vous le savez]
- Ce qu'ils ont constaté : [erreurs, données erronées, lenteur, exposition de données]
- Données touchées : [aucune / lesquelles, et si certaines ont quitté vos systèmes]
- Coût : [crédits, remboursements, temps d'ingénierie, s'il est connu]
3. Le changement
| Question | Réponse |
|---|---|
| Pull request et commit | [liens] |
| Comment a-t-il été écrit ? | [agent de codage / assistant IA / personne] |
| Outil et modèle | [nom et version] |
| La tâche confiée à l'outil | [collez-la ou mettez un lien vers elle] |
| Le changement a-t-il fait uniquement ce que demandait la tâche ? | [oui / non : ce qu'il a fait d'autre] |
| Qui l'a demandé, et qui l'a approuvé ? | [rôles ; il devrait s'agir de personnes différentes] |
| Quels tests ont été exécutés sur la version fusionnée ? | [lien vers l'exécution ; certains ont-ils été ignorés ?] |
| Le diff des tests a-t-il supprimé, ignoré ou assoupli quelque chose ? | [oui / non] |
| Constats de revue ou de sécurité ouverts à la fusion | [aucun / liste, et façon dont ils ont été triés] |
| Le changement a-t-il été modifié après l'approbation ? | [oui / non ; a-t-il été réapprouvé ?] |
| Qu'a vu l'approbateur au moment d'approuver ? | [les preuves présentes sur la pull request à ce moment-là] |
4. Chronologie
Toutes les heures sont en UTC.
| Heure | Ce qui s'est passé |
|---|---|
| HH:MM | Tâche confiée à l'outil |
| HH:MM | Pull request ouverte |
| HH:MM | Approuvée par [rôle] |
| HH:MM | Fusionnée et déployée |
| HH:MM | Premier signe du problème : [alerte, ticket, utilisateur] |
| HH:MM | Incident déclaré |
| HH:MM | Atténué : [revert, feature flag désactivé, rollback] |
| HH:MM | Résolu |
5. Cause racine et facteurs contributifs
Ce qui n'allait pas dans le changement : [le défaut réel, p. ex. une erreur avalée et remplacée par un résultat vide]
Pourquoi il est passé. Pour chaque couche, indiquez si elle aurait pu le détecter et pourquoi elle ne l'a pas fait.
| Couche | Aurait-elle pu le détecter ? | Pourquoi elle ne l'a pas fait |
|---|---|---|
| La tâche | [oui / non] | [ambiguë, une contrainte manquante] |
| Les vérifications propres à l'outil | [oui / non] | |
| Tests | [oui / non] | [aucun test pour ce cas, test affaibli] |
| Revue automatisée | [oui / non] | [non exécutée, constat écarté, hors périmètre] |
| Revue humaine | [oui / non] | [trop volumineux, fichier à risque survolé, auto-approuvé] |
| Barrières qualité | [oui / non] | [barrière absente, barrière franchie sur des preuves périmées] |
| Staging ou canary | [oui / non] | |
| Supervision et alertes | [oui / non] | [combien de temps avant que quelqu'un s'en aperçoive] |
6. Ce qui a bien fonctionné
- [p. ex. Le revert n'a demandé qu'un clic et a pris quatre minutes.]
7. Actions
Privilégiez les actions qui modifient un système plutôt que celles qui demandent aux personnes d'être plus prudentes.
| Action | Type | Responsable | Échéance | Ticket |
|---|---|---|---|---|
| [p. ex. Ajouter un test pour une réponse amont vide] | [test] | [nom] | [AAAA-MM-JJ] | [lien] |
| [p. ex. Exiger la revue des propriétaires de code (code owners) pour le module de facturation] | [barrière ou permission] | [nom] | [AAAA-MM-JJ] | [lien] |
| [p. ex. Ajouter « pas de repli silencieux » à la checklist de revue] | [pratique de revue] | [nom] | [AAAA-MM-JJ] | [lien] |
| [p. ex. Limiter l'accès en écriture de l'agent à ses propres branches] | [configuration de l'agent] | [nom] | [AAAA-MM-JJ] | [lien] |
8. Enseignements
[Que diriez-vous à une autre équipe qui utilise les mêmes outils ? Un paragraphe.]
À propos de ce template
Cette section figure uniquement sur la page web, pas dans les téléchargements.
L'approche sans recherche de coupable suit le chapitre du livre SRE de Google Postmortem Culture: Learning from Failure, qui met l'accent sur « identifying the contributing causes of the incident without indicting any individual or team », c'est-à-dire identifier les causes contributives de l'incident sans mettre en cause aucune personne ni aucune équipe. La section 3 est ce qui rend ce template propre aux changements écrits par l'IA : vous devez savoir ce que l'approbateur pouvait voir au moment où il a approuvé, sinon vous ne pouvez pas distinguer une défaillance de la revue d'une défaillance des preuves.
Si vous utilisez AI CodeOps, le dossier de preuves du changement contient l'essentiel de la section 3 : la tâche, les modèles, les approbations, les constats, les exécutions de tests et la livraison. Le guide du rollback couvre l'étape d'atténuation de la section 4.
Questions fréquentes
Un post-mortem devrait-il rejeter la faute sur l'outil d'IA ?
Pas plus qu'il ne la rejetterait sur un compilateur. La question utile est de savoir quelle partie de votre processus a laissé passer le changement, et ce qu'il faut changer pour que le suivant soit détecté : une vérification, une barrière, une permission ou une habitude de revue.
En quoi ce template diffère-t-il d'un template de post-mortem classique ?
La section 3. Elle consigne la tâche confiée à l'outil, le modèle et les preuves que l'approbateur a vues à la fusion, afin que vous puissiez savoir si la revue a échoué ou si les preuves manquaient ou étaient fausses.
Qui devrait rédiger le post-mortem ?
Une personne qui a été impliquée, le demandeur et l'approbateur relisant tous deux le brouillon. Aucun des deux ne devrait être amené à se sentir fautif ; leur récit de ce qu'ils ont vu est l'apport le plus précieux.
Citer cette page
AI CodeOps (2026). Template de post-mortem d'incident pour un changement écrit par l'IA. https://aicodeops.dev/templates/ai-change-postmortem
Cette page et ses téléchargements sont sous licence CC BY 4.0 : copiez-les et adaptez-les pour votre équipe, et faites un lien vers cette page lorsque vous publiez votre version.
Voir aussi
- Qu'est-ce qu'une barrière qualité ?
- Effectuer le rollback d'un déploiement
- Dossiers de preuves
- Journaux d'audit, rôles et politiques pour le codage par IA
- Template de politique de codage par IA pour les équipes d'ingénierie
- Checklist de release pour équipes livrant du code écrit par l'IA
- Tous les templates