8 min lecture • Guide 858 of 877
Grand Livre de Suivi de la Dette Technique
La dette technique s'accumule silencieusement jusqu'à paralyser les livraisons. Traiter la dette comme un grand livre financier—suivant ce que vous devez, les taux d'intérêt et les paiements—fournit une visibilité qui permet des décisions stratégiques. GitScrum aide les équipes à maintenir un grand livre de dette technique qui rend la dette visible et gérable.
Concept du Grand Livre
| Terme | Signification | Exemple |
|---|---|---|
| Principal | Effort pour corriger | 8 story points |
| Intérêts | Coût continu | 2 pts/sprint de ralentissement |
| Solde | Dette totale | 81 points |
| Paiement | Travail effectué | 6 pts ce sprint |
Le Grand Livre de Dette Technique
STRUCTURE DU GRAND LIVRE
════════════════════════
MODÈLE D'ENTRÉE :
─────────────────────────────────────
┌─────────────────────────────────────────────────────────────┐
│ ÉLÉMENT DE DETTE : [Nom] │
│ ID : DEBT-001 │
├─────────────────────────────────────────────────────────────┤
│ │
│ CLASSIFICATION : │
│ ├── Catégorie : Architecture / Code / Tests / Docs │
│ ├── Sévérité : Critique / Haute / Moyenne / Basse │
│ ├── Âge : 6 mois │
│ └── Propriétaire : Équipe Backend │
│ │
│ FINANCIERS : │
│ ├── Principal : 13 points (effort pour corriger) │
│ ├── Taux d'Intérêt : 3 pts/sprint (coût continu) │
│ ├── Intérêts Totaux Payés : 18 pts (3 × 6 sprints) │
│ └── Point d'équilibre : 4,3 sprints │
│ │
│ IMPACT : │
│ ├── Affecte : Service utilisateurs, Service commandes │
│ ├── Symptômes : Builds lents, bugs fréquents │
│ └── Risque : Augmente avec chaque changement │
│ │
│ STATUT : │
│ ├── Actuel : Accumulation d'intérêts │
│ ├── Planifié : Sprint 25 │
│ └── Paiements : Aucun encore │
│ │
└─────────────────────────────────────────────────────────────┘
Configuration du Suivi dans GitScrum
CONFIGURER LE SUIVI DE DETTE
════════════════════════════
ÉTAPE 1 : CRÉER LES LABELS
─────────────────────────────────────
Labels pour catégorisation :
├── [debt:architecture]
├── [debt:code-quality]
├── [debt:testing]
├── [debt:documentation]
├── [debt:infrastructure]
└── [debt:security]
Labels de sévérité :
├── [severity:critical]
├── [severity:high]
├── [severity:medium]
└── [severity:low]
ÉTAPE 2 : CRÉER L'ÉPIQUE DE DETTE
─────────────────────────────────────
Épique : Grand Livre Dette Technique Q1 2025
Description :
├── Solde Total : 81 points
├── Allocation Sprint : 8 pts/sprint
├── Réduction Cible : 40%
└── Révision : Mensuelle
ÉTAPE 3 : AJOUTER LES ÉLÉMENTS COMME TÂCHES
─────────────────────────────────────
Chaque élément de dette devient une tâche :
├── Titre : [DEBT] Description
├── Labels : Catégorie + Sévérité
├── Effort : Points du principal
├── Description : Détails du livre
└── Parent : Épique de Dette
Tableau de Bord d'Inventaire
GRAND LIVRE DETTE TECHNIQUE - Q1 2025
═════════════════════════════════════
RÉSUMÉ :
─────────────────────────────────────
Solde Total : 81 points
Intérêts par Sprint : 12 pts/sprint
Intérêts Mensuels : 24 pts/mois
RÉPARTITION PAR CATÉGORIE :
─────────────────────────────────────
Architecture ████████████████░░ 32 pts (40%)
Qualité Code ████████████░░░░░░ 24 pts (30%)
Tests ██████░░░░░░░░░░░░ 12 pts (15%)
Documentation ████░░░░░░░░░░░░░░ 8 pts (10%)
Infrastructure ██░░░░░░░░░░░░░░░░ 5 pts ( 5%)
RÉPARTITION PAR SÉVÉRITÉ :
─────────────────────────────────────
Critique ████░░░░░░░░░░░░░░ 8 pts (10%)
Haute ████████████░░░░░░ 24 pts (30%)
Moyenne ████████████████░░ 32 pts (40%)
Basse ██████░░░░░░░░░░░░ 17 pts (21%)
TOP 5 ÉLÉMENTS AVEC PLUS D'INTÉRÊTS :
─────────────────────────────────────
┌───────────────────────────────────────────────────────────┐
│ # │ Élément │ Principal │ Intérêts/Spr │
├───┼───────────────────────────┼───────────┼──────────────┤
│ 1 │ Système auth legacy │ 21 pts │ 4 pts │
│ 2 │ Service monolithique │ 34 pts │ 3 pts │
│ 3 │ Tests intégration manq. │ 13 pts │ 2 pts │
│ 4 │ Dépendances obsolètes │ 8 pts │ 2 pts │
│ 5 │ Config hard-coded │ 5 pts │ 1 pt │
└───┴───────────────────────────┴───────────┴──────────────┘
Calcul des Intérêts
CALCULER LES INTÉRÊTS DE DETTE
══════════════════════════════
CE QUI COMPTE COMME INTÉRÊTS :
─────────────────────────────────────
Intérêts = coût continu de NE PAS corriger
Coûts mesurables :
├── Temps supplémentaire sur features liées
├── Corrections de bugs causés par la dette
├── Maintenance des contournements
├── Charge cognitive
├── Friction lors de l'onboarding
└── Surcharge de tests
EXEMPLE DE CALCUL :
─────────────────────────────────────
Dette : Connexions BD hard-coded
Principal (effort pour corriger) :
├── Refactoriser le code : 3 pts
├── Ajouter gestion config : 2 pts
├── Mettre à jour environnements : 1 pt
└── Total Principal : 6 pts
Intérêts (par sprint) :
├── Changements manuels env : 0,5 hrs
├── Bugs liés : 0,5 pts avg
├── Friction déploiement : 0,25 pts
└── Total Intérêts : ~1 pt/sprint
Point d'équilibre : 6 sprints
Recommandation : Corriger maintenant
CALCUL DU ROI :
─────────────────────────────────────
Si Principal = 6 pts
Et Intérêts = 1 pt/sprint
Alors :
├── Après 6 sprints : Point d'équilibre
├── Après 12 sprints : 6 pts économisés
├── Après 24 sprints : 18 pts économisés
└── Décision : Corriger si horizon > 6 sprints
Stratégies de Paiement
APPROCHES DE PAIEMENT DE DETTE
══════════════════════════════
STRATÉGIE 1 : INTÉRÊTS LES PLUS ÉLEVÉS D'ABORD
─────────────────────────────────────
Rembourser la dette avec le taux le plus élevé
Comme le paiement de carte de crédit :
├── Récupération maximale de vélocité
├── Victoires rapides en efficacité
├── Amélioration visible rapidement
└── Recommandé pour la plupart des équipes
STRATÉGIE 2 : PRINCIPAL LE PLUS BAS D'ABORD
─────────────────────────────────────
Victoires rapides, éliminer des éléments
Avantages :
├── Construction de momentum
├── Motivation de l'équipe
├── Complexité réduite
└── Bon pour le moral
STRATÉGIE 3 : BASÉE SUR L'OPPORTUNITÉ
─────────────────────────────────────
Payer en travaillant dans la zone affectée
"Règle du Scout" :
├── Laisser le code mieux qu'on l'a trouvé
├── Faible surcharge
├── Intégration naturelle
└── Rythme soutenable
RECOMMANDÉ : APPROCHE HYBRIDE
─────────────────────────────────────
├── 20% capacité pour dette dédiée
│ └── Éléments à intérêts élevés
├── Basé sur opportunité pour le reste
│ └── En travaillant à proximité
└── Réviser trimestriellement
└── Ajuster la stratégie
Allocation en Sprint
PLANIFICATION DE SPRINT AVEC DETTE
══════════════════════════════════
ALLOCATION DE CAPACITÉ :
─────────────────────────────────────
Vélocité de l'Équipe : 40 pts/sprint
┌─────────────────────────────────────┐
│ Travail Features │ 28 pts (70%) │
│ Dette Technique │ 8 pts (20%) │
│ Bugs et Maintenance │ 4 pts (10%) │
└─────────────────────┴──────────────┘
SÉLECTION DE DETTE POUR LE SPRINT :
─────────────────────────────────────
Ordre de priorité :
1. Dette bloquant les features planifiées
2. Éléments avec taux d'intérêt le plus élevé
3. Dette dans les zones en modification
4. Victoires rapides (faible principal)
5. Rotation basée sur l'âge
SUIVI DES PAIEMENTS :
─────────────────────────────────────
Travail Dette Sprint 24 :
├── DEBT-003 : Refactor config (5 pts) ✓
├── DEBT-007 : Couverture tests (3 pts) ✓
├── Total Payé : 8 pts
├── Nouvelle Dette Ajoutée : 2 pts
└── Réduction Nette : 6 pts
Mise à Jour du Livre :
├── Solde Précédent : 81 pts
├── Paiements : -8 pts
├── Nouvelle Dette : +2 pts
└── Nouveau Solde : 75 pts
Révision Mensuelle
RÉVISION DU GRAND LIVRE
═══════════════════════
AGENDA DE RÉVISION MENSUELLE :
─────────────────────────────────────
1. Rapport de Solde
├── Total actuel
├── Changement depuis le mois dernier
└── Analyse de tendance
2. Analyse des Intérêts
├── Éléments à intérêts les plus élevés
├── Intérêts payés ce mois
└── Impact sur la vélocité
3. Progression des Paiements
├── Dette remboursée
├── Nouvelle dette ajoutée
└── Changement net
4. Ajustement des Priorités
├── Reprioriser les éléments
├── Mettre à jour les estimations
└── Ajuster la stratégie
5. Plan du Mois Prochain
├── Éléments ciblés
├── Allocation de capacité
└── Objectifs
MÉTRIQUES À SUIVRE :
─────────────────────────────────────
├── Solde total de dette (points)
├── Ratio de dette (dette / vélocité)
├── Taux d'intérêt (pts/sprint)
├── Taux de paiement (pts/sprint)
├── Tendance de changement net
└── Temps vers dette zéro (projeté)
Bonnes Pratiques
- Traiter la dette comme des finances avec discipline de grand livre
- Tout quantifier - principal et intérêts
- Allouer une capacité constante pour les paiements
- Réviser mensuellement pour ajuster les priorités
- Suivre les taux d'intérêt pour prioriser les éléments coûteux
- Célébrer les paiements pour maintenir la motivation
- Prévenir la nouvelle dette avec code reviews et standards
- Rendre la dette visible aux parties prenantes
Anti-Patterns
✗ Sans suivi (dette invisible)
✗ Sans allocation (jamais payée)
✗ Corriger seulement en crise
✗ Ajouter plus vite que payer
✗ Sans calcul d'intérêts
✗ Seulement "sprints dette" trimestriels