Documento bueno frente a documento decorativo

Un documento de arquitectura es útil cuando alguien puede contrastarlo con el sistema real y de él salen decisiones que un equipo aplica. Es decorativo cuando describe intenciones sin dueño, sin fecha y sin nada contra lo que comprobarlas. El tamaño no ayuda: un documento corto puede ser excelente y uno largo, una pared de buenas intenciones.

Casi siempre el decorativo se delata en el mismo lugar: no tiene a nadie que responda por cada sección, no cita las pruebas que lo respaldan y no dice qué se descartó. Con esas tres ausencias, nadie puede equivocarse con él, y por eso nadie lo usa.

Un documento que no se revisa envejece sin que nadie lo note. Los sistemas cambian cada mes y un diagrama de hace tres años describe una empresa que ya no existe. La fecha de la última revisión de cada sección es la señal más barata de si el documento está vivo.

Mira las secciones del plan corporativo y compara sus fechas de revisión. Una de ellas lleva bastante más tiempo sin tocarse que las demás.

La evidencia es lo que convierte una afirmación en un hecho comprobable: un inventario, un acta, un diagrama versionado, una excepción con vencimiento. Un documento que afirma «nuestra arquitectura se alinea con los marcos internacionales» sin citar nada es una promesa. Quien lo lee solo puede creerlo o no.

Busca en las secciones cuál de los dos documentos no cita evidencia en ninguna de ellas. No hace falta mirar cada fila: hay una consulta que filtra justo eso.

El documento bueno no está libre de decisiones flojas, pero las muestra y las deja revisar. Una decisión de arquitectura debe decir qué otras opciones se consideraron y por qué se descartaron. Cuando la razón es «es lo habitual» y la lista de alternativas está vacía, la decisión no es una decisión: es una costumbre con fecha.

Revisa la tabla de decisiones del documento del portal y encuentra la que no se puede defender con lo que está escrito.