Saltar a contenido

Tech debts

Cuando N45 encuentra algo que debería tratarse más adelante — tests en cuarentena, decisiones de alcance pospuestas, infraestructura ausente — lo registra como un tech debt en lugar de hacer fallar el workflow.

Cómo se crean

Los tech debts pueden venir de:

  • Tests en cuarentena — un ejecutor marcó un test como flaky o dependiente de entorno y lo agregó a la lista de cuarentena
  • Alcance pospuesto — durante el discovery, marcaste algo como "fuera de alcance" por ahora
  • Pushbacks de validación — un cambio rechazado durante validación que requeriría flujo estructurado
  • Manual — cualquier cosa que agregues explícitamente vía comandos de N45

Dónde viven

Los tech debts se almacenan en .n45/planning/tech-debts/, un archivo por deuda. Cada entrada contiene:

  • Título y descripción
  • Severidad (baja / media / alta)
  • Origen (de dónde vino)
  • Estado (abierto / en progreso / resuelto)
  • Artefactos relacionados (qué spec, qué task)

Cómo aparecen

Dónde Qué ves
/n45-status Tech debts abiertos listados bajo "Elementos abiertos"
/n45-feat para nuevo spec Deudas abiertas en el mismo alcance ofrecidas como inclusiones opcionales
Retrospectiva del roadmap Deudas creadas durante el trabajo son resumidas

Resolviendo una deuda

No resuelves una deuda editando el archivo — la resuelves tratándola como trabajo:

  • Inclúyela en un spec de feat estructurada ("cerrar deuda N cuando esto entre")
  • O usa /n45-fix si la deuda describe un bug o estado roto

Una vez que el trabajo relacionado se mergea, N45 cierra la deuda automáticamente.