Saltar al contenido principal

TDE — detección de drift que sobrevive al Charter

Cada Charter tiene una sección Risks para cosas que podrían salir mal dentro de su alcance. Pero hay deuda más grande que cualquier Charter individual: herencia de una decisión previa, propagación entre módulos, deuda que necesita un Charter dedicado para arreglarse. Eso es un TDE (Transversal Debt Entry / Entrada de Deuda Transversal).

Por qué importa​

  • "Todo es un riesgo" derrota la lista de riesgos. Sin una categoría de orden superior, los asuntos transversales importantes se ahogan en el ruido de R<N> por-Charter. TDE los rescata con criterios de elegibilidad explícitos.
  • La deuda tiene que sobrevivir al Charter que la encontró. Cuando un Charter cierra, su lista de riesgos cierra con él. La deuda heredada necesita su propio documento que sobrevive a través de Charters y puede priorizarse contra otra deuda rastreada.
  • Puntuar le gana a las vibras. Los TDE llevan una matriz impact × effort y un status: identified | prioritized | resolved. El framework ayuda al equipo a decidir qué arreglar a continuación; los TDE resueltos quedan en el repo como historial de auditoría.

Elegibilidad — cuatro criterios​

Una entrada de deuda se convierte en TDE si cualquiera de estos aplica:

  1. Herencia — se propaga desde un Charter previo (patrón estricto o reuso implícito de patrón).
  2. Cross-módulo — cruza módulos de código O cruza fronteras de ejecución de Charter.
  3. Necesita su propio Charter — la remediación es lo bastante no trivial como para requerir un Charter futuro dedicado.
  4. Necesita priorización humana — el equipo tiene que decidir si/cuándo arreglarlo; el agente no debería decidir unilateralmente.

Si ninguno aplica, queda como riesgo R<N> del Charter. La skill /straymark-new TDE recorre esta verificación.

Cómo funciona​

.straymark/06-evolution/technical-debt/
├── TDE-001-config-loader-coupling.md     status: prioritized
├── TDE-002-i18n-fallback-incoherence.md  status: identified
└── TDE-003-stale-validators.md           status: resolved (2026-04-30)

Cada documento tiene frontmatter (tde_id, status, impact, effort, created_at, resolved_at), una descripción de la deuda, los criterios que cumple y — una vez priorizado — el Charter planeado o la ruta de remediación.

straymark metrics surfacea TDEs abiertos por impacto y antigüedad. CI puede fallar cuando un TDE de alto impacto lleva más de N días identified sin priorización.

Aprende más​