Un nuovo strumento Git registra le decisioni umano-AI così non si perde il ragionamento alla base
ADRs4AI permette ai team di gestire in versione controllata il loro dialogo con l'AI, così ogni scelta conserva il suo "perché" per il futuro.
Cosa se ne potrebbe fare
- Uno sviluppatore o un lavoratore della conoscenza potrebbe catturare le proprie conversazioni a due vie con un'AI e trasformarle in registri decisionali permanenti tracciati da Git, così il ragionamento non si perde mai quando la finestra della chat chiude 1.
- Il fondatore di un progetto potrebbe esaminare le domande aperte generate da un'AI sul telefono e toccare un Accetta per registrare la propria decisione come commit Git, senza bisogno di essere un ingegnere esperto 1.
- Un team di ricerca potrebbe tenere un registro vivo e controllato in versione di ogni scelta progettuale e della sua motivazione, così i futuri collaboratori possano capire perché le decisioni sono state prese e cosa potrebbe confutarle 1.
Le tue conversazioni AI lasciano ora una traccia scritta
Quando lavori con un'AI, il pensiero che produce — le opzioni che considera, le raccomandazioni che dà, il livello di confidenza dietro ciascuna — normalmente scompare quando la finestra della chat chiude. ADRs4AI evita che accada, trasformando ogni sessione in un file archiviato in un repository Git, lo stesso sistema usato dagli sviluppatori per tracciare le modifiche al codice 1.
Ogni registro segue un formato semplice. Indica la domanda, elenca le opzioni considerate dall'AI, include la raccomandazione dell'AI, la sua motivazione, il livello di confidenza e anche cosa potrebbe dimostrare che la raccomandazione è sbagliata 1. Poi un essere umano rivede il registro e accetta, sovrascrive o modifica la risposta . Il risultato è un documento vivo in cui entrambi i lati della conversazione vengono preservati.
Un appunto disordinato diventa un registro strutturato
Il flusso di lavoro inizia con un seed — basta scrivere o dettare i propri pensieri, per quanto disordinati 1. L'AI poi organizza quel scarico in ADR che mantengono le tue parole reali insieme alle opzioni, al ragionamento e alle domande aperte . Ogni domanda è etichettata con un prefisso come "### QST:" così può essere trovata istantaneamente con una ricerca, oppure fatta emergere automaticamente dall'estensione VS Code .
Un esempio reale arriva dal progetto frontier-model-observatory, dove un ADR chiedeva come le correzioni dovrebbero preservare ciò che era stato precedentemente creduto 1. GPT 5.6 Sol, eseguito attraverso Perplexity Computer, ha prodotto le opzioni, la motivazione, il punteggio di confidenza e un falsificatore — il test che avrebbe dimostrato che la raccomandazione era sbagliata . La decisione finale di una riga è arrivata dal fondatore Jérémie Lumbroso sul suo telefono tramite l'app iOS ADRs4AI . Questo è il meccanismo completo in pratica: l'AI porta il ragionamento, l'umano spende un solo giudizio, e il registro mantiene il perché .
Ci vogliono dieci minuti per partire
I creatori dicono che un primo progetto può essere configurato in circa dieci minuti 1. Si crea un repository privato dal template ADRs4AI, si compila un file CLAUDE.md di livello superiore, si eseguono alcuni comandi git per registrare il record iniziale e poi si invita il proprio agente ad assumere la missione . Da lì, si versano pensieri in un seed, si risponde alla prima domanda e si ripete il ciclo .
Cos'è e cos'è non
ADRs4AI non è progettato per archiviare ogni riga di una chat, memorizzare ricordi in un database vettoriale, fare da piattaforma di orchestrazione o sostenere che l'AI abbia un'identità persistente 1. Registra semplicemente ciò che è stato deciso, il perché e cosa rimane aperto — così il futuro te stesso, o chiunque altro nel progetto, può seguire il filo senza ricominciare da zero . Il creatore dice che il metodo è stato costruito attraverso la pratica quotidiana con collaboratori AI ed è pensato per funzionare tanto per principianti quanto per ingegneri esperti .
Questa storia riporta una tendenza a scopo puramente informativo. Non costituisce consiglio né invito a fare alcuno di questi passaggi.
I fatti principali
- ADRs4AI archivia le decisioni umano-AI come file con version control in Git
- Un'estensione VS Code fa emergere le domande aperte con diagnostica e link profondi
- Un'app iOS permette agli utenti di esaminare e rispondere ai record dal telefono
- I record includono opzioni, raccomandazioni, motivazione, confidenza e falsificatori
- Il ciclo richiede circa dieci minuti da un repository vuoto alla prima risposta