Parcours de lecture

Le handbook peut se lire dans l'ordre, mais sa valeur augmente lorsqu'il accompagne une situation réelle. Les parcours ci-dessous privilégient les chapitres qui aident à prendre une décision maintenant ; ils renvoient ensuite vers les approfondissements nécessaires.

Par rôle

Vous êtes…	Commencez par	Puis approfondissez
Développeuse ou développeur sur un changement	Pourquoi, Découvrir, Découper, Preuves	Revue, refactoring, contrats et livraison selon l'impact
Tech Lead ou Staff Engineer	Ingénierie, Complexité, Frontières, Architecture évolutive	Équipes, gouvernance, dette, modernisation et capacité
Engineering Manager	Responsabilité, Feedback, Métriques, Équipes	Fiabilité, dette, compétences et adoption du handbook
Product Manager ou Designer	Qualité, Modèle de domaine, Expérimentation, Accessibilité	Impact, cohorte, dégradation et métriques de résultat
Personne d'astreinte ou SRE	Observabilité, Incidents, Fiabilité	Déploiement progressif, capacité, sécurité et runbooks

Par situation

Je dois livrer un changement à risque

1. Découvrir le comportement et évaluer l'impact.
2. Remplir la fiche de changement.
3. Concevoir la réversibilité et les preuves.
4. Préparer le plan de livraison et l'exposition progressive.

Je modifie une donnée, un contrat ou une migration

1. Lire Données et Contrats.
2. Vérifier Temps et concurrence si des événements, reprises ou versions sont impliqués.
3. Utiliser le plan de migration.
4. Préparer les comptes, échantillons, exceptions et la réconciliation avant le premier lot.

Nous venons de vivre un incident

1. Stabiliser le service avec Incidents.
2. Préserver les faits dans le modèle de conduite et analyse.
3. Identifier la classe de risque dans la carte risques → pratiques.
4. Transformer l'apprentissage en barrière, signal ou capacité et vérifier son effet.

Nous n'arrivons plus à changer un système legacy

1. Lire Legacy puis Créer de la sécurité.
2. Choisir une contrainte dominante et écrire une première trajectoire avec Moderniser.
3. Ne migrer à grande échelle qu'avec le plan de migration et des preuves de contenu.

Je dois décider d'une évolution d'architecture

1. Clarifier la décision, les frontières et les dépendances avec Frontières et Couplage.
2. Examiner le coût de changement avec Complexité et Architecture évolutive.
3. Rédiger une ADR concise lorsque le rayon d'action le justifie.

Parcours d'adoption pour une équipe

Une équipe qui débute ne doit pas chercher à appliquer simultanément tout le handbook. Choisir une friction, un parcours de lecture et une expérimentation limitée à partir du guide d'adoption. Le résultat attendu est une amélioration observable du système de travail, pas un score de conformité.

À retenir

Le handbook est un outil de décision. Commencer par votre rôle ou votre situation, suivre les liens vers les mécanismes pertinents, puis revenir à la carte des risques lorsque l'impact traverse plusieurs frontières.