Una nueva herramienta de Git registra decisiones humano-IA para que no pierdas el razonamiento detrás de ellas
ADRs4AI permite a los equipos llevar el control de versiones del vaivén con la IA, para que cada elección conserve su 'por qué' para el futuro.
Qué podrías hacer con ello
- Un desarrollador o trabajador del conocimiento podría capturar sus conversaciones de vaivén con una IA y convertirlas en registros de decisiones permanentes con seguimiento en Git para que el razonamiento nunca se pierda cuando se cierra la ventana de chat 1.
- Un fundador de proyecto podría revisar en su teléfono las preguntas abiertas generadas por una IA y tocar "Aceptar" para registrar su fallo como un commit de Git sin necesitar ser un ingeniero experto 1.
- Un equipo de investigación podría mantener un registro vivo y con control de versiones de cada decisión de diseño y su fundamento para que los colaboradores futuros puedan entender por qué se tomaron las decisiones y qué podría demostrarlas erróneas 1.
Tus conversaciones con la IA ahora dejan un rastro
Cuando trabajas con una IA, el pensamiento que genera —opciones que considera, recomendaciones que da, la confianza detrás de cada una— normalmente desaparece al cerrar la ventana del chat. ADRs4AI evita eso convirtiendo cada sesión en un archivo almacenado en un repositorio Git, el mismo sistema que usan los desarrolladores para rastrear cambios en el código 1.
Cada registro sigue un formato sencillo. Indica la pregunta, enumera las opciones que la IA consideró, incluye la recomendación de la IA, su razonamiento, qué tan confiado está, e incluso qué probaría que la recomendación es errónea 1. Luego una persona revisa el registro y acepta, sobreescribe o edita la respuesta . El resultado es un documento vivo donde ambos lados de la conversación se preservan.
Una nota desordenada se convierte en un registro estructurado
El flujo de trabajo comienza con un seed —solo escribe o dicta tus pensamientos, por más desordenados que sean 1. La IA entonces organiza ese volcado en ADRs que conservan tus palabras reales junto con las opciones, el razonamiento y las preguntas abiertas . Cada pregunta tiene una etiqueta con un prefijo como "### QST:" para que pueda encontrarse al instante buscando, o destacarse automáticamente en la extensión de VS Code .
Un ejemplo real proviene del proyecto frontier-model-observatory, donde un ADR preguntaba cómo deberían las correcciones preservar lo que se creía anteriormente 1. GPT 5.6 Sol, ejecutado a través de Perplexity Computer, produjo las opciones, el razonamiento, la puntuación de confianza y un falsificador —la prueba que demostraría que la recomendación era errónea . La decisión final de una sola línea vino del fundador Jérémie Lumbroso en su teléfono a través de la app para iOS ADRs4AI . Ese es el mecanismo completo en práctica: la IA carga el razonamiento, el humano gasta un solo juicio, y el registro guarda el porqué .
Se tarda diez minutos en empezar
Los creadores dicen que un primer proyecto puede configurarse en unos diez minutos 1. Creas un repositorio privado desde la plantilla de ADRs4AI, rellenas un archivo CLAUDE.md de nivel superior, ejecutas unos pocos comandos git para hacer commit del registro inicial y luego invitas a tu agente a asumir la misión . Desde allí, vuelcas pensamientos en un seed, respondes la primera pregunta y repites el bucle .
Qué es y qué no es
ADRs4AI no está diseñado para archivar cada línea de un chat, almacenar memorias en una base de datos vectorial, actuar como plataforma de orquestación o afirmar que la IA tiene una identidad persistente 1. Simplemente registra lo que se decidió, por qué y qué permanece abierto —para que tú futuro, o cualquier otra persona en el proyecto, pueda seguir el hilo sin empezar desde cero . El creador dice que el método se construyó mediante la práctica diaria con colaboradores de IA y está pensado para funcionar tanto para principiantes como para ingenieros experimentados .
Esta historia informa sobre una tendencia con fines informativos. No es consejo ni ánimo para hacer nada de ello.
Los datos clave
- ADRs4AI almacena decisiones humano-IA como archivos con control de versiones en Git
- Una extensión de VS Code muestra preguntas abiertas con diagnósticos y enlaces profundos
- Una app para iOS permite a los usuarios revisar y responder registros en el teléfono
- Los registros incluyen opciones, recomendaciones, razonamiento, confianza y falsificadores
- El bucle toma unos diez minutos desde un repositorio vacío hasta una primera respuesta