Provenance Manifesto
arrow_back Volver a la bitácora

Por qué las decisiones deben convertirse en un artefacto de primera clase

Yauheni Kurbayeu

Por qué las decisiones deben convertirse en un artefacto de primera clase

Why Decisions Must Become a First-Class Artifact

Author: Yauheni Kurbayeu
Published: Mar 14, 2026


Durante la mayor parte de la historia del desarrollo de software, las decisiones han vivido en un lugar extraño. Influyen en todo lo que construimos, pero rara vez existen como artefactos del propio sistema. Ocurren en conversaciones, revisiones de diseño, hilos de Slack y reuniones de arquitectura. A veces aparece un resumen en un documento, pero con más frecuencia el razonamiento se disuelve silenciosamente en el flujo diario de entrega.

Lo que permanece no es la decisión en sí, sino el resultado de esa decisión.

Preservamos el código, la arquitectura, la infraestructura, las APIs y la documentación. Estos artefactos describen en qué se convirtió el sistema, pero rara vez explican por qué se convirtió en eso. Durante muchos años esto no parecía ser un problema serio, en gran parte porque los entornos tecnológicos evolucionaban a un ritmo relativamente manejable. Los sistemas podían permanecer estables durante largos periodos y el razonamiento original detrás de su diseño rara vez necesitaba revisarse.

La suposición que se está rompiendo

Esa suposición ahora se está rompiendo.

En la era aumentada por IA, el entorno que rodea a nuestros sistemas cambia mucho más rápido que antes. Los frameworks evolucionan más rápido, las capacidades de la infraestructura cambian, las restricciones regulatorias aparecen y desaparecen, y nuevas herramientas impulsadas por IA alteran constantemente la economía de construir software. A medida que este ritmo se acelera, los artefactos que antes considerábamos duraderos comienzan a envejecer mucho más rápido.

Arquitecturas que eran óptimas hace dos años de repente parecen innecesariamente complejas. Restricciones que antes obligaban a tomar decisiones de diseño específicas desaparecen silenciosamente. Limitaciones de plataforma que moldearon la implementación original ya no son relevantes. Cuando las organizaciones se enfrentan a estos momentos de cambio, a menudo se dan cuenta de que, aunque todavía poseen el artefacto, ya no poseen el razonamiento que lo creó.

Recuerdan lo que construyeron, pero no pueden explicar claramente por qué lo construyeron de esa manera.

Sin ese razonamiento, la evolución se vuelve incierta. Los equipos dudan en cambiar los sistemas porque sospechan que aún pueden existir restricciones invisibles. Los ingenieros heredan decisiones arquitectónicas cuyos compromisos ya no se comprenden. Con el tiempo, el sistema se convierte lentamente en algo familiar para cualquier desarrollador experimentado: una estructura tecnológica que todavía funciona, pero cuyos orígenes han sido en gran medida olvidados.

En muchos casos, el verdadero capital intelectual de la organización ya ha desaparecido.

El verdadero activo nunca fue el artefacto en sí. Fue la cadena de razonamiento que lo produjo: las suposiciones que se consideraban válidas en ese momento, las restricciones que moldearon la arquitectura, las alternativas que fueron rechazadas y los riesgos que influyeron en la decisión final. Cuando este razonamiento desaparece, el artefacto se convierte en una instantánea congelada del pensamiento del pasado.

Una analogía histórica sencilla

La historia humana ofrece una analogía simple que facilita ver esta distinción.

A lo largo de los siglos, la humanidad ha creado toda una secuencia de tecnologías de transporte:

  • la rueda
  • el carruaje
  • el automóvil
  • el avión
  • el cohete

A primera vista, estas parecen invenciones separadas pertenecientes a eras tecnológicas completamente diferentes. Sin embargo, si observamos con más detalle, todas representan variaciones de la misma decisión subyacente.

Los humanos querían moverse de un lugar a otro más rápido y de manera más eficiente.

La decisión permaneció constante, mientras que las implementaciones evolucionaron a medida que la tecnología avanzaba. El carruaje no desapareció porque la idea detrás de él fuera incorrecta; desapareció porque se hicieron posibles mejores formas de implementar la misma intención. Si los historiadores hubieran preservado solo el diseño físico del carruaje y hubieran perdido el razonamiento detrás de él, ese artefacto eventualmente se convertiría en poco más que una pieza de museo.

El razonamiento, sin embargo, continúa generando nuevas soluciones.

Esta distinción se vuelve aún más importante en la era de la inteligencia artificial. Los sistemas de IA reducen drásticamente el costo de producir artefactos. El código puede generarse en minutos. Las arquitecturas pueden proponerse automáticamente. Las configuraciones de infraestructura pueden ensamblarse con niveles crecientes de automatización. A medida que el costo de producir el qué continúa disminuyendo, el valor relativo del por qué aumenta.

Sin embargo, la mayoría de las organizaciones todavía tratan el razonamiento como algo temporal, algo que solo existe durante el momento de la discusión.

Si la IA acelera la producción de sistemas, las organizaciones necesitarán una nueva capacidad para preservar el razonamiento detrás de ellos. En lugar de almacenar únicamente los artefactos finales, necesitaremos sistemas que registren las decisiones mismas como entidades estructuradas. Estos sistemas capturarían las suposiciones, restricciones, compromisos, riesgos y caminos alternativos que moldearon el resultado.

En otras palabras, el desarrollo de software necesitará una capa de memoria para las decisiones.

Una vez que las decisiones se convierten en artefactos de primera clase, algo cambia fundamentalmente. Cuando el entorno evoluciona, ya no estamos obligados a redescubrir el razonamiento detrás del sistema mediante arqueología y especulación. En cambio, podemos volver a la decisión original, actualizar las suposiciones que ya no son válidas y regenerar la implementación de una manera que refleje el nuevo contexto.

Este enfoque transforma los sistemas de estructuras estáticas en algo más cercano a diseños vivos. El artefacto puede cambiar repetidamente a medida que la tecnología evoluciona, pero el razonamiento que impulsa esos cambios permanece visible y trazable.

En el mundo aumentado por IA, las organizaciones más resilientes no serán necesariamente aquellas con las arquitecturas más pulidas hoy. Serán aquellas que preserven la línea intelectual detrás de esas arquitecturas, permitiéndoles evolucionar continuamente a medida que cambia el entorno.

Las arquitecturas pueden envejecer, los frameworks pueden desaparecer y la infraestructura puede ser reemplazada, pero las decisiones pueden evolucionar siempre que su razonamiento permanezca visible.

Y una vez que el por qué se preserva, el qué siempre puede reconstruirse.

arrow_back Volver a la bitácora