Tech debts¶
Quando o N45 encontra algo que deveria ser tratado depois — testes em quarentena, decisões de escopo adiadas, infraestrutura ausente — ele registra como um tech debt em vez de fazer o workflow falhar.
Como são criados¶
Tech debts podem vir de:
- Testes em quarentena — um executor marcou um teste como flaky ou dependente de ambiente e adicionou à lista de quarentena
- Escopo adiado — durante o discovery, você marcou algo como "fora do escopo" por enquanto
- Pushbacks de validação — uma mudança rejeitada durante a validação que exigiria fluxo estruturado
- Manual — qualquer coisa que você adicione explicitamente via comandos do N45
Onde vivem¶
Tech debts são armazenados em .n45/planning/tech-debts/, um arquivo por débito. Cada entrada contém:
- Título e descrição
- Severidade (baixa / média / alta)
- Origem (de onde veio)
- Status (aberto / em andamento / resolvido)
- Artefatos relacionados (qual spec, qual task)
Como aparecem¶
| Onde | O que você vê |
|---|---|
/n45-status |
Tech debts abertos listados sob "Itens abertos" |
/n45-feat pra nova spec |
Débitos abertos no mesmo escopo oferecidos como inclusões opcionais |
| Retrospectiva do roadmap | Débitos criados durante o trabalho são resumidos |
Resolvendo um débito¶
Você não resolve um débito editando o arquivo — resolve tratando ele como trabalho:
- Inclua numa spec de feat estruturada ("fechar débito N quando isso for entregue")
- Ou use
/n45-fixse o débito descreve um bug ou estado quebrado
Uma vez que o trabalho relacionado é mesclado, o N45 fecha o débito automaticamente.