El modelo vive en el repositorio

Guardar el modelo junto al código tiene tres ventajas que ninguna otra ubicación da a la vez. Se versiona: cada cambio queda con fecha y autor, y se puede ver qué se pensaba hace seis meses. Se revisa: quien propone un cambio de diseño puede tocar el modelo en la misma propuesta, y quien la revisa lo ve junto. Y está a mano: nadie tiene que pedir permiso a otro equipo para consultarlo.

Los archivos son de texto sencillo —listas y tablas en un formato legible— para que una diferencia entre dos versiones se lea sin herramientas especiales.

No hace falta revisar el modelo con cada propuesta de cambio: corregir un redondeo o cambiar un texto no toca la arquitectura. Sí obliga a revisarlo cualquier cambio que altere lo que el diagrama dice: un flujo nuevo, un almacén nuevo, un tercero nuevo, una forma distinta de autenticar o una frontera que se mueve. Son los cuatro o cinco disparadores que conviene dejar escritos en el propio modelo, para que quien abra un cambio los reconozca sin ser experto.

Además de esos disparadores, una revisión programada —cada seis meses, por ejemplo— cubre lo que se movió poco a poco sin que nadie lo notara.

Abre el repositorio de Farolito con la terminal. Hay una carpeta con el modelo y otra con el historial de cambios fusionados desde su última revisión. Lee primero qué terceros y qué flujos documenta el diagrama del modelo y compara con el historial. Un cambio que añade comunicación con alguien que el modelo no nombra es justo lo que el modelo está para frenar.

El historial se compara con el modelo igual que se compara un inventario con lo que hay en la estantería.

Un modelo dice de sí mismo cuándo se revisó por última vez. Ese dato, junto con el historial, es lo que permite saber cuánta deriva hay entre el diagrama y el sistema. El LEEME del modelo de Farolito lo recoge junto con las reglas de cuándo se revisa. Léelo y anota la fecha de la última revisión completa.

Sin fecha de última revisión no hay forma de saber si el modelo está al día o solo parece que sí.