La complejidad rara vez llega anunciándose. Se acumula en nombres imprecisos, decisiones sin dueño y capas que nadie puede explicar por completo.
La explicación como propiedad del sistema
Un sistema comprensible no es un sistema simple. Es un sistema donde cada pieza tiene una razón que puede exponerse, discutirse y comprobarse.
«Toda abstracción que no pueda ser verificada formalmente es deuda técnica pospuesta.»
Cuaderno de sistemas, entrada 01
Coste de complejidad
C = D + V + OUna decisión que puede leerse
La arquitectura también es una forma de documentación. Cuando una decisión tiene dueño, motivo y evidencia, el sistema conserva memoria.
typescript
explainable-system.ts
type Decision = {
owner: string;
evidence: string[];
};
const explainable = (decision: Decision) =>
Boolean(decision.owner && decision.evidence.length);Referencias para continuar
El objetivo no es eliminar toda complejidad, sino hacer visible cuál merece la pena conservar.