Documentar las reglas de negocio de un software: extraerlas antes de que sea tarde

Lo valioso de tu software son los años dedicados a decidir cómo se hacen las cosas en tu empresa. Esas decisiones viven en dos cabezas y en código que nadie relee. Ponerlas en francés y por qué ese documento sobrevive al código.

Documentar las reglas de negocio de un software lleva unos días y salva años de decisiones. En Reddit (r/vibecoding, julio de 2026), el director de una empresa regional de mantenimiento cuenta cuatro años afinando la lógica de su herramienta interna, con el 95 % del código escrito por IA, hasta que un gran grupo quiso utilizarla. Escribe que el valor está en los cuatro años.

Dónde viven hoy tus reglas

Haz un inventario honesto. Parte de tus reglas está en el software, como condiciones escritas hace ocho años por alguien que dejó la empresa. Otra parte está en la cabeza de dos personas, a quienes siempre se pregunta «¿cómo hacemos cuando hay un conflicto con el cliente?». Una tercera vive en una hoja de cálculo que tu contable mantiene aparte porque la herramienta nunca tuvo la casilla. Ninguna de las tres es legible para quien llega y ninguna se transmite con el archivo de código.

Qué es una regla de negocio, en una frase en francés

Una regla de negocio cabe en una frase que un empleado entiende: un pedido recibido después del jueves al mediodía sale la semana siguiente, un presupuesto rechazado sigue consultable un año, un cliente con contrato anual no paga anticipo. Tiene un desencadenante, una consecuencia y casi siempre una excepción. La excepción es la parte valiosa porque viene de un problema real que encontraste una vez y no quieres volver a ver. Un software del mercado simplifica esas excepciones; es el tema que abordamos desde el oficio para las profesiones liberales.

Extraerlas sin detener la producción

Tres preguntas dirigidas a quienes hacen el trabajo sacan el material. ¿En qué casos rodeas el software? ¿Qué corriges a mano después? ¿Qué cambió el día en que un cliente se enfadó? Cada respuesta da una regla y una excepción, en francés, sin que haya un desarrollador en la sala. Calcula una hora por persona y un cuaderno. El método de las preguntas incómodas sirve a la misma intención con un cronómetro. Un consultor de organización hace ese trabajo mejor que una máquina cuando dos departamentos se contradicen: la máquina transcribe lo que le dicen, no arbitra entre ventas y producción.

Una regla no sale en una reunión plenaria. Sale en el puesto de trabajo, cuando la persona muestra su pantalla y dice «aquí, en principio pongo la fecha del lunes siguiente, salvo para ellos». Anota la frase tal como la dice, con el nombre del cliente y la razón. Una regla reescrita en lenguaje administrativo pierde su excepción, y la excepción era la única parte que un software del mercado no sabrá reproducir.

El documento es la memoria del producto

En Maestro, ese documento tiene nombre y lugar: el documento de requisitos, escrito en francés por el agente Victor a partir de la definición dirigida por Margaux, revisado por ti y validado con un «Me parece bien» antes de que exista una sola línea de código. Sirve dos veces. La primera, cuando construyen los agentes, porque lo consultan en lugar de adivinar. La segunda, años después: el código se regenera a partir del documento; lo contrario no funciona. De hecho, retomar un software existente empieza por esa lectura, antes de migrar cualquier cosa.

Lo que ganas al haberlo escrito

Un empleado nuevo aprende tu oficio leyéndolo en lugar de hacer veinte preguntas. Un proveedor presupuesta sobre un documento en lugar de una conversación y puedes comparar dos presupuestos sobre la misma base. El día en que un cliente importante pide usar tu herramienta, tienes con qué hablar de un contrato en lugar de rebuscar en tu propio código. Y si un día decides rehacerlo todo, el trabajo de los años anteriores permanece, mientras el código de 2019 no le servirá a nadie. El empresario de r/vibecoding está en ese punto: cuatro años de decisiones acumuladas en una herramienta que un gran grupo quiere utilizar, y una cuestión de valor que se refiere a esas decisiones, no a los archivos. Lo que construyó se puede contar, vender y rehacer en otro lugar siempre que esté escrito.

Empezar por diez líneas esta semana

Toma una hoja y escribe diez reglas, una por línea, empezando por las excepciones que más explicas a tus equipos. Ponle fecha. Haz que la revise quien tramita los pedidos: corregirá tres y añadirá dos. Tendrás la primera versión de la memoria de tu producto y ya vale más que lo que contiene tu software actual.