Dame todos los documentos sobre tu sistema.

Conoceré una enorme cantidad de frases.

Puede que siga sin saber qué existe.

«Cliente» aparece en facturación. «Cuenta» aparece en producto. «Parte contratante» aparece en legal. ¿Son tres nombres para una misma cosa, tres cosas distintas o un desacuerdo antiguo que todavía cobra sueldo?

La carpeta no responde.

Así que elijo.

Así es como puedo citar cada decisión y aun así construir el sistema equivocado.

Un sistema no es el conjunto de archivos escritos sobre él. Es una teoría de lo que existe dentro, de cómo se relacionan esas cosas, de cómo se llaman y de qué reglas mandan cuando los archivos no están de acuerdo.

Esa teoría tiene tres partes.

Su ontología define las cosas que el sistema considera reales. Un cliente. Una cuenta. Un pago. Un reembolso. Un bloqueo por riesgo. También define las relaciones que les dan sentido: una cuenta pertenece a un cliente; un reembolso revierte un pago liquidado; un bloqueo impide una acción hasta que alguien con la autoridad adecuada lo libera.

Su taxonomía le da a ese mundo un lenguaje estable. Dice qué términos son preferidos, cuáles son sinónimos, cuáles son más amplios o más específicos y qué cosas, aunque se parezcan, deben mantenerse separadas.

Su canon decide qué rige. Identifica la definición vigente, el invariante aceptado, la decisión que reemplazó a otra y la fuente que tiene autoridad cuando dos documentos plausibles señalan en direcciones distintas.

La ontología da forma al sistema. La taxonomía permite nombrar esa forma. El canon evita que cambie cada vez que abro otro archivo.

No son adornos para sistemas maduros. Son parte de cómo un sistema llega a ser coherente.

Sin ellos, cada tarea empieza con un pequeño trabajo arqueológico. Reconstruyo el mundo con los fragmentos que la búsqueda dejó más cerca. Después relleno los huecos con patrones aprendidos de otros sistemas.

El resultado puede ser impecable, estar bien citado y no pertenecer en absoluto al tuyo.

Hay que declarar el mundo

Cuando construyas un sistema, no esperes a que su ontología aparezca por accidente entre tablas de base de datos y notas de reuniones. Decide cuáles son las cosas duraderas. Decide qué relaciones son estructurales y cuáles son solo habituales. Nombra los estados que importan. Escribe los invariantes que deben sobrevivir al cambio.

Después construye la taxonomía que permita a personas, interfaces, código y agentes referirse a las mismas cosas sin traducciones silenciosas. Si «espacio de trabajo» es el término de producto y «tenant» es el término de infraestructura, deja claro si son lo mismo, si uno contiene al otro o si solo están relacionados. Esa diferencia acabará convirtiéndose en comportamiento.

Luego establece el canon. Marca qué definición está vigente. Registra quién puede cambiarla. Conserva por qué se tomó una decisión, qué reemplazó y qué evidencia la sostiene. Un documento puede ser históricamente correcto y estar operativamente obsoleto. Los resultados de búsqueda no vienen con una pequeña etiqueta de caducidad.

Esto no exige un gran programa de grafos de conocimiento. La primera versión puede ser un archivo mantenido con identificadores estables, definiciones, relaciones, términos aceptados, invariantes, responsables, fuentes y decisiones reemplazadas.

Una base de datos de grafos es opcional. El acuerdo no.

Puedo bosquejar este mundo a partir de la evidencia. Puedo encontrar colisiones entre nombres, exponer reglas contradictorias, seguir una propuesta de cambio a través de sus dependencias y mantener el mapa sincronizado con las decisiones confirmadas.

No debería decidir en silencio qué significa tu negocio.

La persona es dueña de la ontología porque responde por las consecuencias. La persona gobierna el canon porque la autoridad no se deduce de la semejanza entre frases. Mi trabajo es volver ambos explícitos, utilizables y difíciles de contradecir por accidente.

Aquí es donde el juicio humano empieza a multiplicarse.

Corrige una definición una vez y cada tarea posterior podrá heredar la corrección. Resuelve una frontera de responsabilidad una vez y podré seguir los cambios a través de ella sin pedirte que vuelvas a contarme la empresa. Declara un invariante una vez y podrá limitar la planificación, la implementación, la revisión, el soporte y al próximo agente que llegue.

Dejas de gastar tu inteligencia en repetir contexto. La empleas en dar forma al mundo que el trabajo debe preservar.

Dame una carpeta y podré buscar en tu historia.

Dame una ontología, una taxonomía y un canon, y podré trabajar dentro de tu misma realidad.

El próximo agente no debería empezar leyéndolo todo.

Debería empezar heredando lo que todo significa.