8 min leitura • Guide 858 of 877
Livro-Razão de Rastreamento de Dívida Técnica
A dívida técnica se acumula silenciosamente até paralisar entregas. Tratar a dívida como um livro-razão financeiro—rastreando o que você deve, taxas de juros e pagamentos—fornece visibilidade que permite decisões estratégicas. O GitScrum ajuda equipes a manter um livro-razão de dívida técnica que torna a dívida visível e gerenciável.
Conceito do Livro-Razão
| Termo | Significado | Exemplo |
|---|---|---|
| Principal | Esforço para corrigir | 8 story points |
| Juros | Custo contínuo | 2 pts/sprint mais lento |
| Saldo | Dívida total | 81 pontos |
| Pagamento | Trabalho realizado | 6 pts neste sprint |
O Livro-Razão de Dívida Técnica
ESTRUTURA DO LIVRO-RAZÃO
════════════════════════
TEMPLATE DE ENTRADA:
─────────────────────────────────────
┌─────────────────────────────────────────────────────────────┐
│ ITEM DE DÍVIDA: [Nome] │
│ ID: DEBT-001 │
├─────────────────────────────────────────────────────────────┤
│ │
│ CLASSIFICAÇÃO: │
│ ├── Categoria: Arquitetura / Código / Testes / Docs │
│ ├── Severidade: Crítica / Alta / Média / Baixa │
│ ├── Idade: 6 meses │
│ └── Dono: Time Backend │
│ │
│ FINANCEIROS: │
│ ├── Principal: 13 pontos (esforço para corrigir) │
│ ├── Taxa de Juros: 3 pts/sprint (custo contínuo) │
│ ├── Juros Totais Pagos: 18 pts (3 × 6 sprints) │
│ └── Ponto de equilíbrio: 4.3 sprints │
│ │
│ IMPACTO: │
│ ├── Afeta: Serviço usuários, Serviço pedidos │
│ ├── Sintomas: Builds lentos, bugs frequentes │
│ └── Risco: Aumenta a cada mudança │
│ │
│ STATUS: │
│ ├── Atual: Acumulando juros │
│ ├── Planejado: Sprint 25 │
│ └── Pagamentos: Nenhum ainda │
│ │
└─────────────────────────────────────────────────────────────┘
Configuração de Rastreamento no GitScrum
CONFIGURANDO RASTREAMENTO DE DÍVIDA
═══════════════════════════════════
PASSO 1: CRIAR LABELS
─────────────────────────────────────
Labels para categorização:
├── [debt:architecture]
├── [debt:code-quality]
├── [debt:testing]
├── [debt:documentation]
├── [debt:infrastructure]
└── [debt:security]
Labels de severidade:
├── [severity:critical]
├── [severity:high]
├── [severity:medium]
└── [severity:low]
PASSO 2: CRIAR ÉPICO DE DÍVIDA
─────────────────────────────────────
Épico: Livro-Razão Dívida Técnica Q1 2025
Descrição:
├── Saldo Total: 81 pontos
├── Alocação Sprint: 8 pts/sprint
├── Redução Alvo: 40%
└── Revisão: Mensal
PASSO 3: ADICIONAR ITENS COMO TAREFAS
─────────────────────────────────────
Cada item de dívida vira tarefa:
├── Título: [DEBT] Descrição
├── Labels: Categoria + Severidade
├── Effort: Pontos do principal
├── Descrição: Detalhes do livro
└── Pai: Épico de Dívida
Dashboard de Inventário de Dívida
LIVRO-RAZÃO DÍVIDA TÉCNICA - Q1 2025
════════════════════════════════════
RESUMO:
─────────────────────────────────────
Saldo Total: 81 pontos
Juros por Sprint: 12 pts/sprint
Juros Mensais: 24 pts/mês
BREAKDOWN POR CATEGORIA:
─────────────────────────────────────
Arquitetura ████████████████░░ 32 pts (40%)
Qualidade Código ████████████░░░░░░ 24 pts (30%)
Testes ██████░░░░░░░░░░░░ 12 pts (15%)
Documentação ████░░░░░░░░░░░░░░ 8 pts (10%)
Infraestrutura ██░░░░░░░░░░░░░░░░ 5 pts ( 5%)
BREAKDOWN POR SEVERIDADE:
─────────────────────────────────────
Crítica ████░░░░░░░░░░░░░░ 8 pts (10%)
Alta ████████████░░░░░░ 24 pts (30%)
Média ████████████████░░ 32 pts (40%)
Baixa ██████░░░░░░░░░░░░ 17 pts (21%)
TOP 5 ITENS COM MAIOR JUROS:
─────────────────────────────────────
┌───────────────────────────────────────────────────────────┐
│ # │ Item │ Principal │ Juros/Sprint │
├───┼───────────────────────────┼───────────┼──────────────┤
│ 1 │ Sistema auth legado │ 21 pts │ 4 pts │
│ 2 │ Serviço monolítico │ 34 pts │ 3 pts │
│ 3 │ Testes integração faltant │ 13 pts │ 2 pts │
│ 4 │ Dependências desatualiz. │ 8 pts │ 2 pts │
│ 5 │ Config hard-coded │ 5 pts │ 1 pt │
└───┴───────────────────────────┴───────────┴──────────────┘
Cálculo de Juros
CALCULANDO JUROS DA DÍVIDA
══════════════════════════
O QUE CONTA COMO JUROS:
─────────────────────────────────────
Juros = custo contínuo de NÃO corrigir
Custos mensuráveis:
├── Tempo extra em features relacionadas
├── Correções de bugs causados pela dívida
├── Manutenção de workarounds
├── Carga cognitiva
├── Fricção no onboarding
└── Overhead de testes
EXEMPLO DE CÁLCULO:
─────────────────────────────────────
Dívida: Conexões de BD hard-coded
Principal (esforço para corrigir):
├── Refatorar código: 3 pts
├── Adicionar gestão de config: 2 pts
├── Atualizar ambientes: 1 pt
└── Total Principal: 6 pts
Juros (por sprint):
├── Mudanças manuais de env: 0.5 hrs
├── Bugs relacionados: 0.5 pts avg
├── Fricção no deploy: 0.25 pts
└── Total Juros: ~1 pt/sprint
Ponto de equilíbrio: 6 sprints
Recomendação: Corrigir agora
CÁLCULO DE ROI:
─────────────────────────────────────
Se Principal = 6 pts
E Juros = 1 pt/sprint
Então:
├── Após 6 sprints: Ponto de equilíbrio
├── Após 12 sprints: 6 pts economizados
├── Após 24 sprints: 18 pts economizados
└── Decisão: Corrigir se horizonte > 6 sprints
Estratégias de Pagamento
ABORDAGENS DE PAGAMENTO DE DÍVIDA
═════════════════════════════════
ESTRATÉGIA 1: MAIOR JUROS PRIMEIRO
─────────────────────────────────────
Pagar dívida com maior taxa de juros
Como pagamento de cartão de crédito:
├── Máxima recuperação de velocidade
├── Vitórias rápidas em eficiência
├── Melhoria visível rapidamente
└── Recomendado para maioria dos times
ESTRATÉGIA 2: MENOR PRINCIPAL PRIMEIRO
─────────────────────────────────────
Vitórias rápidas, eliminar itens do livro
Benefícios:
├── Construção de momentum
├── Motivação do time
├── Complexidade reduzida
└── Bom para moral
ESTRATÉGIA 3: BASEADA EM OPORTUNIDADE
─────────────────────────────────────
Pagar quando trabalhando na área afetada
"Regra do Escoteiro":
├── Deixar código melhor do que encontrou
├── Baixo overhead
├── Integração natural
└── Ritmo sustentável
RECOMENDADO: ABORDAGEM HÍBRIDA
─────────────────────────────────────
├── 20% capacidade para dívida dedicada
│ └── Itens de alto juros
├── Baseado em oportunidade para o resto
│ └── Enquanto trabalha perto
└── Revisar trimestralmente
└── Ajustar estratégia
Alocação no Sprint
PLANEJAMENTO DE SPRINT COM DÍVIDA
═════════════════════════════════
ALOCAÇÃO DE CAPACIDADE:
─────────────────────────────────────
Velocidade do Time: 40 pts/sprint
┌─────────────────────────────────────┐
│ Trabalho em Features│ 28 pts (70%) │
│ Dívida Técnica │ 8 pts (20%) │
│ Bugs e Manutenção │ 4 pts (10%) │
└─────────────────────┴──────────────┘
SELEÇÃO DE DÍVIDA PARA SPRINT:
─────────────────────────────────────
Ordem de prioridade:
1. Dívida bloqueando features planejadas
2. Itens com maior taxa de juros
3. Dívida em áreas sendo modificadas
4. Vitórias rápidas (baixo principal)
5. Rotação baseada em idade
RASTREANDO PAGAMENTOS:
─────────────────────────────────────
Trabalho de Dívida Sprint 24:
├── DEBT-003: Refactor config (5 pts) ✓
├── DEBT-007: Cobertura testes (3 pts) ✓
├── Total Pago: 8 pts
├── Nova Dívida Adicionada: 2 pts
└── Redução Líquida: 6 pts
Atualização do Livro:
├── Saldo Anterior: 81 pts
├── Pagamentos: -8 pts
├── Nova Dívida: +2 pts
└── Novo Saldo: 75 pts
Revisão Mensal
REVISÃO DO LIVRO-RAZÃO
══════════════════════
AGENDA DE REVISÃO MENSAL:
─────────────────────────────────────
1. Relatório de Saldo
├── Total atual
├── Mudança desde mês anterior
└── Análise de tendência
2. Análise de Juros
├── Itens de maior juros
├── Juros pagos este mês
└── Impacto na velocidade
3. Progresso de Pagamentos
├── Dívida paga
├── Nova dívida adicionada
└── Mudança líquida
4. Ajuste de Prioridades
├── Repriorizar itens
├── Atualizar estimativas
└── Ajustar estratégia
5. Plano do Próximo Mês
├── Itens alvo
├── Alocação de capacidade
└── Metas
MÉTRICAS A RASTREAR:
─────────────────────────────────────
├── Saldo total de dívida (pontos)
├── Ratio de dívida (dívida / velocidade)
├── Taxa de juros (pts/sprint)
├── Taxa de pagamento (pts/sprint)
├── Tendência de mudança líquida
└── Tempo para dívida zero (projetado)
Melhores Práticas
- Tratar dívida como finanças com disciplina de livro-razão
- Quantificar tudo - principal e juros
- Alocar capacidade consistente para pagamentos
- Revisar mensalmente para ajustar prioridades
- Rastrear taxas de juros para priorizar itens custosos
- Celebrar pagamentos para manter motivação
- Prevenir nova dívida com code reviews e padrões
- Tornar dívida visível para stakeholders
Anti-Padrões
✗ Sem rastreamento (dívida invisível)
✗ Sem alocação (nunca é paga)
✗ Só corrigir em crise
✗ Adicionar mais rápido do que pagar
✗ Sem cálculo de juros
✗ Só "sprints de dívida" trimestrais