8 min lectura • Guide 858 of 877
Libro Mayor de Seguimiento de Deuda Técnica
La deuda técnica se acumula silenciosamente hasta paralizar la entrega. Tratar la deuda como un libro mayor financiero—rastreando lo que debes, tasas de interés y pagos—proporciona visibilidad que permite decisiones estratégicas. GitScrum ayuda a los equipos a mantener un libro mayor de deuda técnica que hace la deuda visible y manejable.
Concepto del Libro Mayor
| Término | Significado | Ejemplo |
|---|---|---|
| Principal | Esfuerzo para arreglar | 8 story points |
| Interés | Costo continuo | 2 pts/sprint más lento |
| Balance | Deuda total | 81 puntos |
| Pago | Trabajo realizado | 6 pts este sprint |
El Libro Mayor de Deuda Técnica
ESTRUCTURA DEL LIBRO MAYOR
══════════════════════════
PLANTILLA DE ENTRADA:
─────────────────────────────────────
┌─────────────────────────────────────────────────────────────┐
│ ITEM DE DEUDA: [Nombre] │
│ ID: DEBT-001 │
├─────────────────────────────────────────────────────────────┤
│ │
│ CLASIFICACIÓN: │
│ ├── Categoría: Arquitectura / Código / Tests / Docs │
│ ├── Severidad: Crítica / Alta / Media / Baja │
│ ├── Antigüedad: 6 meses │
│ └── Dueño: Equipo Backend │
│ │
│ FINANCIEROS: │
│ ├── Principal: 13 puntos (esfuerzo para arreglar) │
│ ├── Tasa de Interés: 3 pts/sprint (costo continuo) │
│ ├── Interés Total Pagado: 18 pts (3 × 6 sprints) │
│ └── Punto de equilibrio: 4.3 sprints │
│ │
│ IMPACTO: │
│ ├── Afecta: Servicio usuarios, Servicio pedidos │
│ ├── Síntomas: Builds lentos, bugs frecuentes │
│ └── Riesgo: Aumenta con cada cambio │
│ │
│ ESTADO: │
│ ├── Actual: Acumulando interés │
│ ├── Planificado: Sprint 25 │
│ └── Pagos: Ninguno aún │
│ │
└─────────────────────────────────────────────────────────────┘
Configuración de Seguimiento en GitScrum
CONFIGURANDO SEGUIMIENTO DE DEUDA
═════════════════════════════════
PASO 1: CREAR LABELS
─────────────────────────────────────
Labels para categorización:
├── [debt:architecture]
├── [debt:code-quality]
├── [debt:testing]
├── [debt:documentation]
├── [debt:infrastructure]
└── [debt:security]
Labels de severidad:
├── [severity:critical]
├── [severity:high]
├── [severity:medium]
└── [severity:low]
PASO 2: CREAR ÉPICA DE DEUDA
─────────────────────────────────────
Épica: Libro Mayor Deuda Técnica Q1 2025
Descripción:
├── Balance Total: 81 puntos
├── Asignación Sprint: 8 pts/sprint
├── Reducción Objetivo: 40%
└── Revisión: Mensual
PASO 3: AGREGAR ITEMS COMO TAREAS
─────────────────────────────────────
Cada item de deuda se convierte en tarea:
├── Título: [DEBT] Descripción
├── Labels: Categoría + Severidad
├── Effort: Puntos de principal
├── Descripción: Detalles del libro
└── Padre: Épica de Deuda
Dashboard de Inventario de Deuda
LIBRO MAYOR DEUDA TÉCNICA - Q1 2025
═══════════════════════════════════
RESUMEN:
─────────────────────────────────────
Balance Total: 81 puntos
Interés por Sprint: 12 pts/sprint
Interés Mensual: 24 pts/mes
DESGLOSE POR CATEGORÍA:
─────────────────────────────────────
Arquitectura ████████████████░░ 32 pts (40%)
Calidad Código ████████████░░░░░░ 24 pts (30%)
Testing ██████░░░░░░░░░░░░ 12 pts (15%)
Documentación ████░░░░░░░░░░░░░░ 8 pts (10%)
Infraestructura ██░░░░░░░░░░░░░░░░ 5 pts ( 5%)
DESGLOSE POR SEVERIDAD:
─────────────────────────────────────
Crítica ████░░░░░░░░░░░░░░ 8 pts (10%)
Alta ████████████░░░░░░ 24 pts (30%)
Media ████████████████░░ 32 pts (40%)
Baja ██████░░░░░░░░░░░░ 17 pts (21%)
TOP 5 ITEMS CON MAYOR INTERÉS:
─────────────────────────────────────
┌───────────────────────────────────────────────────────────┐
│ # │ Item │ Principal │ Interés/Spr │
├───┼───────────────────────────┼───────────┼──────────────┤
│ 1 │ Sistema auth legacy │ 21 pts │ 4 pts │
│ 2 │ Servicio monolítico │ 34 pts │ 3 pts │
│ 3 │ Tests integración faltant │ 13 pts │ 2 pts │
│ 4 │ Dependencias desactualiz. │ 8 pts │ 2 pts │
│ 5 │ Config hard-coded │ 5 pts │ 1 pt │
└───┴───────────────────────────┴───────────┴──────────────┘
Cálculo de Interés
CALCULANDO INTERÉS DE DEUDA
═══════════════════════════
QUÉ CUENTA COMO INTERÉS:
─────────────────────────────────────
Interés = costo continuo de NO arreglar
Costos medibles:
├── Tiempo extra en features relacionadas
├── Correcciones de bugs causados por deuda
├── Mantenimiento de workarounds
├── Carga cognitiva
├── Fricción en onboarding
└── Overhead de testing
EJEMPLO DE CÁLCULO:
─────────────────────────────────────
Deuda: Conexiones de BD hard-coded
Principal (esfuerzo para arreglar):
├── Refactorizar código: 3 pts
├── Agregar gestión de config: 2 pts
├── Actualizar entornos: 1 pt
└── Total Principal: 6 pts
Interés (por sprint):
├── Cambios manuales de env: 0.5 hrs
├── Bugs relacionados: 0.5 pts avg
├── Fricción en deployment: 0.25 pts
└── Total Interés: ~1 pt/sprint
Punto de equilibrio: 6 sprints
Recomendación: Arreglar ahora
CÁLCULO DE ROI:
─────────────────────────────────────
Si Principal = 6 pts
Y Interés = 1 pt/sprint
Entonces:
├── Después de 6 sprints: Punto de equilibrio
├── Después de 12 sprints: 6 pts ahorrados
├── Después de 24 sprints: 18 pts ahorrados
└── Decisión: Arreglar si horizonte > 6 sprints
Estrategias de Pago
ENFOQUES DE PAGO DE DEUDA
═════════════════════════
ESTRATEGIA 1: MAYOR INTERÉS PRIMERO
─────────────────────────────────────
Pagar deuda con mayor tasa de interés
Como pago de tarjeta de crédito:
├── Máxima recuperación de velocidad
├── Victorias rápidas en eficiencia
├── Mejora visible rápidamente
└── Recomendado para mayoría de equipos
ESTRATEGIA 2: MENOR PRINCIPAL PRIMERO
─────────────────────────────────────
Victorias rápidas, eliminar items del libro
Beneficios:
├── Construcción de momentum
├── Motivación del equipo
├── Complejidad reducida
└── Bueno para moral
ESTRATEGIA 3: BASADA EN OPORTUNIDAD
─────────────────────────────────────
Pagar cuando se trabaja en área afectada
"Regla del Boy Scout":
├── Dejar código mejor que como se encontró
├── Bajo overhead
├── Integración natural
└── Ritmo sostenible
RECOMENDADO: ENFOQUE HÍBRIDO
─────────────────────────────────────
├── 20% capacidad para deuda dedicada
│ └── Items de alto interés
├── Basado en oportunidad para el resto
│ └── Mientras se trabaja cerca
└── Revisar trimestralmente
└── Ajustar estrategia
Asignación en Sprint
PLANIFICACIÓN DE SPRINT CON DEUDA
═════════════════════════════════
ASIGNACIÓN DE CAPACIDAD:
─────────────────────────────────────
Velocidad del Equipo: 40 pts/sprint
┌─────────────────────────────────────┐
│ Trabajo en Features │ 28 pts (70%) │
│ Deuda Técnica │ 8 pts (20%) │
│ Bugs y Manten. │ 4 pts (10%) │
└─────────────────────┴──────────────┘
SELECCIÓN DE DEUDA PARA SPRINT:
─────────────────────────────────────
Orden de prioridad:
1. Deuda que bloquea features planificadas
2. Items con mayor tasa de interés
3. Deuda en áreas siendo modificadas
4. Victorias rápidas (bajo principal)
5. Rotación basada en antigüedad
RASTREANDO PAGOS:
─────────────────────────────────────
Trabajo de Deuda Sprint 24:
├── DEBT-003: Refactor config (5 pts) ✓
├── DEBT-007: Cobertura tests (3 pts) ✓
├── Total Pagado: 8 pts
├── Nueva Deuda Agregada: 2 pts
└── Reducción Neta: 6 pts
Actualización del Libro:
├── Balance Anterior: 81 pts
├── Pagos: -8 pts
├── Nueva Deuda: +2 pts
└── Nuevo Balance: 75 pts
Revisión Mensual
REVISIÓN DEL LIBRO MAYOR
════════════════════════
AGENDA DE REVISIÓN MENSUAL:
─────────────────────────────────────
1. Reporte de Balance
├── Total actual
├── Cambio desde mes anterior
└── Análisis de tendencia
2. Análisis de Interés
├── Items de mayor interés
├── Interés pagado este mes
└── Impacto en velocidad
3. Progreso de Pagos
├── Deuda pagada
├── Nueva deuda agregada
└── Cambio neto
4. Ajuste de Prioridades
├── Repriorizar items
├── Actualizar estimaciones
└── Ajustar estrategia
5. Plan del Próximo Mes
├── Items objetivo
├── Asignación de capacidad
└── Metas
MÉTRICAS A RASTREAR:
─────────────────────────────────────
├── Balance total de deuda (puntos)
├── Ratio de deuda (deuda / velocidad)
├── Tasa de interés (pts/sprint)
├── Tasa de pago (pts/sprint)
├── Tendencia de cambio neto
└── Tiempo a deuda cero (proyectado)
Mejores Prácticas
- Tratar deuda como finanzas con disciplina de libro mayor
- Cuantificar todo - principal e interés
- Asignar capacidad consistente para pagos
- Revisar mensualmente para ajustar prioridades
- Rastrear tasas de interés para priorizar items costosos
- Celebrar pagos para mantener motivación
- Prevenir nueva deuda con code reviews y estándares
- Hacer deuda visible a stakeholders
Anti-Patrones
✗ Sin seguimiento (deuda invisible)
✗ Sin asignación (nunca se paga)
✗ Solo arreglar en crisis
✗ Agregar más rápido que pagar
✗ Sin cálculo de interés
✗ Solo "sprints de deuda" trimestrales