Il contesto che manca ai vostri agenti
Il perché di una scelta tecnica esiste già, sparso fra codice, ticket chiusi e documenti. Brain lo tiene insieme, ancorato alle righe che lo realizzano, e lo interrogate dal vostro agente di coding.
- Requisiti e specifiche funzionali
- Decisioni architetturali, con il loro perché
- Relazioni fra i componenti del sistema
- Storia delle scelte: cosa è stato sostituito, e quando
- Documentazione agganciata al codice, non accanto
Brain
Una sola fonte, ancorata al codice
services/auth/session.py88-140
Claude Code
Cursor
GitHub Copilot
OpenAI CodexCosa fa il Brain nella vostra software factory
Si parte dai requisiti, perché è lì che il valore si vede prima. Ogni use case arriva in due forme: una skill per gli agenti e una vista sul web per le persone.
› utenteDevo ricostruire il modulo di autenticazione. Quali requisiti ci stanno dietro?
grep -r "session" services/41 file
apro services/auth/session.py1.240 righe
apro services/auth/tokens.py386 righe
apro services/auth/throttle.py212 righe
apro services/auth/middleware.py174 righe
seguo gli importaltri 9 file
apro services/auth/legacy/sso.py640 righe
apro tests/auth/28 file
cerco su Jira "auth"312 ticket
leggo AUTH-1180, AUTH-1204, AUTH-1250nessun perché
cerco su Confluence "sessioni"7 pagine, ultima modifica 2023
deduco il comportamento dal codice
› agenteHo ricostruito tre comportamenti dal codice. Il perché dei token opachi non è scritto da nessuna parte, quindi lo deduco dal codice stesso.
a) serviva poter revocare una sessione subito, e con un JWT firmato non si può
b) un requisito di compliance sul trattamento dei dati di sessione
c) si è voluto evitare la rotazione delle chiavi di firma
Analisi Impatti
Dal requisito al codice toccato e a ciò che ne dipende, con le decisioni e i vincoli architetturali che valgono lì.
Onboarding di persone e agenti
Il brief di progetto o di azienda in una lettura sola. E da qualunque file si risale al suo perché.
Debito tecnico, con le sue ragioni
Ogni voce di debito legata alla decisione o all'incidente che l'ha prodotta. Non “c'è del debito”, ma questo debito viene da lì.
I vostri strumenti alimentano il Brain
Si collega a quello che il team già usa. Nessuna migrazione preliminare e nessun caricamento massivo da fare prima.
ClickUpTask, progettiJiraRequisiti, issueLinearIssue, cicliAzure DevOpsWiki, task, repositoryGitHubRepository di codiceGitLabRepository di codiceConfluenceDocumenti, ADRNotionDocumenti, wiki, noteUn contesto interrogabile
Entità collegate fra loro, ognuna ancorata al punto di codice a cui si riferisce, con la sua storia: cosa è stato sostituito, quando e perché. Ciò che entra lo propongono gli automatismi, lo confermano le persone.
In una software factory la conoscenza è dispersa
Sta in strumenti diversi, in sessioni che si chiudono e nelle persone. Il contesto è quello che la tiene insieme, e vale più dello strumento che ci lavora sopra, perché sopravvive a ogni cambio di modello o di applicazione.
Costi sotto controllo
Un agente senza contesto riscopre la codebase a ogni sessione, e lo fa a vostre spese. Con un contesto curato consuma meno e sbaglia meno.
Una skill per gli agenti, una vista per le persone
Gli agenti lo usano dentro gli strumenti che il team già ha. Le persone lo esplorano dal web, con ricerca, contesto di ogni entità e coda di conferma.
Misurato, non promesso
Su un cliente, dare all'agente il glossario del dominio ha portato lo stesso compito dal 60% al 100% di successo su dieci ripetizioni. Un caso solo, e ve lo diciamo.
I tre momenti in cui il problema si presenta
Chi lavora con noi ci è arrivato per la stessa strada. Team di dimensioni medie o grandi, una codebase che nessuno ha documentato, e la conoscenza distribuita fra diversi strumenti. Poi arriva uno di questi tre momenti.
Va sviluppata una feature nuova
Prima di scriverla bisogna capire cosa tocca, e se qualcosa di simile era già stato fatto.
Va capito com'è fatto il sistema
Una migrazione, un sistema ereditato, un fornitore che cambia. Il codice c'è, il motivo no.
Una persona se ne va
Va in pensione o cambia lavoro, e con lei esce l'unica ricostruzione affidabile di come funziona quella parte.
Ogni volta tocca a qualcuno andare a ricostruire, e quel tempo non era a budget. Si allunga la consegna su quella parte, senza che nessuno l'avesse previsto.
Dietro ai tre momenti c'è un denominatore comune: il codice si accumula, il perché no. Ogni cambiamento lascia righe che funzionano e una ricostruzione di come ci si è arrivati che non è scritta da nessuna parte. Chi arriva dopo riparte dal codice, e il resto se lo ricostruisce col suo tempo.
Con gli agenti il divario si allarga invece di chiudersi. Producono più cambiamento in meno tempo, e quando la sessione si chiude la traccia di come ci sono arrivati non resta a nessuno.
Il punteggio di allineamento, su una scala da 0 a 1, tra come i migliori agenti riorganizzano in commit leggibili il lavoro appena concluso, e come lo organizzerebbe una persona sullo stesso cambiamento. Meno della metà.
AtomicCommitBench, Lin, Zhou, Li (Beihang University), luglio 2026, su 800 episodi di sviluppo reali su 10 progetti Python maturi.
Non è codice sbagliato, il codice funziona. È la storia di come e perché ci si è arrivati che si perde, anche per l'agente che l'ha appena scritta.
Quello che un CTO chiede per primo
Quello che di solito troviamo
Tre domande a cui potete rispondere senza di noi. Nelle aziende con cui parliamo, quasi sempre almeno una risposta manca.
- Quanto ci mette una persona nuova a fare la prima modifica in autonomia, su un repository che non ha scritto.
- Quando qualcuno chiede perché una scelta tecnica è stata fatta, dove va a cercare, e quante volte finisce col chiedere a un collega.
- Quante regole di business esistono solo dentro il codice, senza un documento che le spieghi.
Se non è un tema che vi riguarda ce lo diciamo e ci fermiamo lì.
Trenta minuti con uno dei fondatori, senza costi e senza impegno.
Niente da installare e niente accessi da darci.
Cosa succede nei 30 minuti
- 1Scegliete un modulo che avete già in produzione.
- 2Lo diamo in pasto a Brain e guardiamo insieme cosa tira fuori: quali requisiti ci stanno dietro, e dove si sono persi.
- 3Le note della sessione ve le tenete voi, anche se poi non se ne fa niente.
Cosa succede dopo
- 1Scegliete le fonti da connettere, partendo da quelle che il team usa ogni giorno.
- 2Il Brain si popola da lì, e ogni voce resta ancorata alle righe di codice a cui si riferisce.
- 3Lo interrogate dal vostro agente di coding, dentro gli strumenti che avete già.