Cuando un sistema se vuelve imposible de mantener, la culpa casi nunca es de las líneas. Es de los límites.
He visto código feo, con nombres horribles y sin pruebas, aguantar ocho años en producción sin dar guerra, porque cada parte tenía una responsabilidad clara y no se metía con las demás. Y he visto código impecable, con su cobertura y su linter, que nadie se atreve a tocar porque cambiar el precio de un producto obliga a modificar seis módulos.
Lo primero se arregla leyendo. Lo segundo se arregla reescribiendo, y eso cuesta meses.
Por eso las decisiones de arquitectura merecen más tiempo que las discusiones de estilo, aunque suenen menos divertidas. Dónde vive cada dato, quién puede escribirlo, qué pasa cuando ese servicio no responde.
No hace falta un documento de cuarenta páginas. Un diagrama en una hoja y tres reglas que el equipo respete ya te ponen adelante de la mayoría.