Template Impact Report: Breaks vs Must-change vs Risky
Un template Impact Report concret pour rendre le blast radius explicite avant de livrer.
L'artefact le plus manque dans le shipping assiste par IA, ce n'est pas la generation.
C'est l'Impact Report.
Parce qu'un diff peut sembler inoffensif et casser la realite: schema -> API/SDK -> UI flows -> auth/PII -> docs/support.
Les tests detectent une partie des "breaks". Ils ne detectent pas toute la derive.
Les 3 categories qui comptent
Un Impact Report est une classification:
-
Breaks Stop-ship. Quelque chose va casser.
-
Must-change Rien ne crash aujourd'hui, mais le systeme ment deja quelque part. C'est de la derive.
-
Risky Ca peut marcher, mais il faut verification + garde-fous de rollout.
La plupart couvrent (1) avec des tests. Elles couvrent (3) quand elles ont peur. Elles ignorent (2) car cela semble optionnel. Puis elles paient plus tard.
Template Impact Report (copier/coller)
INTENT (1 phrase): CHANGE SUMMARY: SURFACES TOUCHED: UI / API / DB / Policy / Docs
BREAKS (stop-ship):
- ...
MUST-CHANGE (updates obligatoires pour eviter la derive):
- ...
RISKY (verification + rollout):
- ...
VERIFY PLAN:
- tests:
- runtime signals:
- owner:
ROLLOUT PLAN:
- flag? staged? thresholds?
ROLLBACK PLAN:
Exemple: "c'est juste un renommage"
Renommer un champ touche: migration DB -> reponse API -> types client -> validation UI -> regles policy -> docs.
BREAKS: Les anciens clients crashent ou parsers faux.
MUST-CHANGE: Docs + exemples SDK + copy UI deviennent faux. Rien ne crash, mais la realite est incoherente.
RISKY: Performance de migration a grande echelle.
Le faire a la main en 10 minutes
- Ecrire l'intent (1 phrase)
- Lister les surfaces touchees (UI/API/DB/Policy/Docs)
- Pour chaque surface, demander: "quel est l'echec plausible le plus grave?"
- Classer en Breaks / Must-change / Risky
- Ajouter 1 signal de verification pour chaque item Risky
Ou ContractSpec Studio intervient
ContractSpec Studio genere un Impact Report a partir des memes inputs que le brief/Change Card, puis exporte les work items vers Linear/Jira.
Si vous voulez voir des exemples:
- https://www.contractspec.studio/
Si vous voulez un exemple rempli, voici des exemples de sorties.
Si vous voulez un exemple rempli, voici des exemples de sorties.Articles similaires
Outcome checks: deploy nest pas la fin (deploy + 14 jours)
Un planning simple de checks (+24h, +7j, +14j) pour que votre roadmap ne soit plus juste une histoire.
Template Change Card: la plus petite spec fiable pour les ingenieurs
Les PRD sont trop gros. Les tickets sont trop petits. Utilisez une Change Card: intention -> criteres -> surfaces -> verification -> rollout.
La boucle en 8 etapes: feedback -> impact verifie
Une boucle produit deterministe: preuves -> Change Cards -> Impact Reports -> exports -> checks de resultat.