Libro Mayor de Deuda Técnica | GitScrum

Rastrea y gestiona la deuda técnica como un libro mayor financiero. Cuantifica, prioriza y paga deuda.

8 min de lectura

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