Preguntas frecuentes

El Provenance Manifesto es una propuesta sobre cómo las organizaciones deberían gestionar y preservar las decisiones que dan forma a sus sistemas.

Los sistemas de software modernos no se crean únicamente a partir de código. Están formados por miles de decisiones: elecciones arquitectónicas, compromisos técnicos, suposiciones, respuestas operativas y razonamientos de producto. En la mayoría de las organizaciones estas decisiones se discuten en reuniones o chats y con el tiempo desaparecen.

El Provenance Manifesto propone que las decisiones se traten como artefactos de primera clase, cuya procedencia — el contexto, el razonamiento, las alternativas y su evolución — debe preservarse como parte del conocimiento de la organización.

El manifiesto aborda un problema ampliamente extendido conocido como pérdida de contexto organizacional.

Las decisiones importantes suelen estar dispersas entre reuniones, hilos de chat, documentos de diseño y pull requests. Con el tiempo, el razonamiento detrás de esas decisiones desaparece. Los nuevos ingenieros se ven obligados a redescubrir las mismas restricciones, repetir los mismos debates arquitectónicos y reconstruir las mismas soluciones temporales.

Esto conduce al redescubrimiento repetido de decisiones arquitectónicas, una memoria institucional frágil, procesos de incorporación más lentos, suposiciones ocultas en los sistemas y herramientas de IA que generan respuestas sin el contexto original de las decisiones.

La procedencia de decisiones se refiere al origen, el contexto y la evolución trazables de una decisión.

Una decisión bien preservada normalmente incluye:

• el problema que debía resolverse
• el contexto y las restricciones en ese momento
• las alternativas que se evaluaron
• el razonamiento detrás del enfoque elegido
• las personas responsables de la decisión
• la evolución posterior de la decisión

La procedencia de decisiones explica por qué un sistema existe en su forma actual, no solo lo que el sistema hace actualmente.

La documentación tradicional describe los sistemas. La procedencia de decisiones explica cómo y por qué esos sistemas llegaron a existir.

La documentación suele describir el estado actual de un sistema. Como los sistemas evolucionan, la documentación se vuelve rápidamente obsoleta. Las decisiones, en cambio, forman la cadena de razonamiento detrás de la evolución del sistema.

El Provenance Manifesto propone que las decisiones se conviertan en la unidad principal de conocimiento, a partir de la cual se puedan reconstruir la documentación, las explicaciones y el razonamiento generado por IA.

Los sistemas de inteligencia artificial pueden analizar repositorios de código, documentación e historial de commits. Sin embargo, estas fuentes rara vez contienen todo el razonamiento detrás de las decisiones de diseño.

Sin procedencia de decisiones, los sistemas de IA pueden explicar qué hace un sistema, pero tienen dificultades para explicar por qué fue diseñado de esa manera.

Por ejemplo, las herramientas de IA pueden no saber:

• por qué se tomó un determinado compromiso arquitectónico
• por qué existe una restricción en el sistema
• por qué se introdujo una solución temporal
• por qué se rechazó un enfoque alternativo

Cuando se preserva la procedencia de decisiones, los sistemas de IA obtienen acceso a la capa de razonamiento del conocimiento de ingeniería y pueden ayudar a los humanos con explicaciones y análisis más profundos.

Los Architecture Decision Records (ADR) son un paso importante hacia la preservación del razonamiento arquitectónico. Sin embargo, en muchas organizaciones los ADR permanecen como documentos estáticos almacenados en repositorios.

El Provenance Manifesto propone un modelo más amplio en el que las decisiones son:

• artefactos en evolución en lugar de registros estáticos
• conectadas con otras decisiones y eventos
• conocimiento organizacional consultable
• integradas con flujos de desarrollo y sistemas de IA

En este modelo, las decisiones forman un grafo organizacional de decisiones en evolución, en lugar de documentos aislados.

El Provenance Manifesto está dirigido a personas que participan en el diseño, la construcción y la operación de sistemas complejos.

Esto incluye ingenieros de software, arquitectos de sistemas, líderes de ingeniería, líderes de producto, investigadores que trabajan en desarrollo asistido por IA y organizaciones que construyen sistemas basados en conocimiento.

Cualquier persona interesada en mejorar cómo las organizaciones preservan y desarrollan el conocimiento de ingeniería puede participar en la discusión.

No. El Provenance Manifesto describe principios, no un producto.

Las organizaciones pueden implementar estas ideas utilizando diferentes tecnologías y enfoques, como registros de decisiones arquitectónicas, sistemas de conocimiento estructurados, modelos de conocimiento basados en grafos, entornos de desarrollo asistidos por IA o marcos de gobernanza para la gestión de decisiones.

El manifiesto es intencionalmente independiente de la tecnología para que las ideas puedan evolucionar en diferentes ecosistemas.

Agile transformó la forma en que los equipos gestionan el trabajo y la colaboración.

DevOps transformó la forma en que los equipos gestionan la entrega, la infraestructura y las operaciones.

El Provenance Manifesto se centra en cómo las organizaciones gestionan las decisiones y el conocimiento institucional.

Aborda una capa diferente del ciclo de vida del software: el razonamiento y el contexto que guían la arquitectura, la evolución del producto y el comportamiento operativo.

No. Como otros manifiestos en la historia de la ingeniería de software, el Provenance Manifesto está pensado para evolucionar mediante discusión, crítica y colaboración.

Su propósito es iniciar una conversación más amplia sobre cómo las organizaciones deberían gestionar la procedencia de decisiones y la memoria institucional en la era de la inteligencia artificial.

Existen varias maneras de contribuir al desarrollo del Provenance Manifesto.

Puede discutir las ideas públicamente, proponer mejoras al manifiesto, contribuir con traducciones, ayudar a refinar los principios o compartir experiencias reales relacionadas con la procedencia de decisiones y la memoria organizacional.

Las directrices de contribución están disponibles en el repositorio del proyecto.

El Provenance Manifesto fue iniciado por Yauheni Kurbayeu, basándose en investigaciones y discusiones sobre procedencia de decisiones, memoria organizacional y desarrollo de software asistido por IA.

El objetivo no es crear un proyecto personal, sino iniciar una discusión abierta dentro de la comunidad de ingeniería sobre cómo debería preservarse y gobernarse el conocimiento de las decisiones.

Puede explorar el manifiesto y sus principios en:

https://provenancemanifesto.org

Otros artículos y discusiones exploran la procedencia de decisiones, la memoria institucional y la preservación del conocimiento en los sistemas de software modernos.