Va sviluppata una feature nuova
Prima di scriverla bisogna capire cosa tocca, e se qualcosa di simile era già stato fatto.
Software Factory Brain
Il contesto che manca ai vostri agenti
Il perché di una scelta tecnica esiste già, sparso fra codice, ticket chiusi e documenti. Il Brain lo tiene insieme, ancorato alle righe che lo realizzano, e lo interrogate dal vostro agente di coding.
session.pytokens.pythrottle.pymiddleware.pylegacy/sso.py
REQ-01scadenza dopo 30 minsession.py 88-140ancoraggio esatto
REQ-02logout su tutti i dispositivisession.py 210-244
REQ-03rallenta dopo un tentativo fallitothrottle.py 12-58
78% con requisito · 22% non documentato
oggimarzo 2024
DEC-0212JWT firmatiattivasostituita
DEC-0418token opachi
session.py 88-140confermatada: codice · pull request GitHub · file caricati · issue tracker · monitoraggiointerrogabile oggi da Claude Code, da Brain Studio e da assistenti come Claude, ChatGPT o Copilot
I tre momenti in cui il problema si presenta
Il codice si accumula, il perché no. Con gli agenti il divario cresce: più modifiche, e nessuna traccia di come ci si è arrivati.
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.
Quando la sessione si chiude, la traccia di come l'agente ci è arrivato non resta a nessuno.
Cosa fa il Brain nella vostra software factory
Si parte dai requisiti, perché è lì che il valore si vede prima.
› utenteDevo ricostruire il modulo di autenticazione. Quali requisiti ci stanno dietro?
cerca nel Brain: requisiti di services/auth3 requisiti · 1 decisione
leggo i record collegati12 ancoraggi al codice
› agente
+--------+---------------------------------------------+--------------------+ | req | comportamento | ancorato a | +--------+---------------------------------------------+--------------------+ | REQ-01 | la sessione scade dopo 30 min di inattività | session.py 88-140 | | REQ-02 | il logout revoca su tutti i dispositivi | session.py 210-244 | | REQ-03 | un tentativo fallito rallenta i successivi | throttle.py 12-58 | +--------+---------------------------------------------+--------------------+
Il 22% del modulo non ha un requisito che lo spieghiservices/auth/legacy/
› utenteE il perché dei token opachi?
leggo DEC-0418 e le sue fontiISS-0077 · sostituisce DEC-0212
› agenteRevoca immediata, dopo ISS-0077 (il logout non chiudeva le sessioni sugli altri dispositivi, marzo).
DEC-0418, proposta in una sessione Claude Code il 12 set., confermata da una persona del team il 13 set.
Sostituisce DEC-0212, JWT del 2024.
3 passaggi
Senza contesto, un agente riscopre la codebase a ogni sessione, e lo fa a vostre spese. Con il Brain parte da ciò che il team ha già confermato.
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ì.
Cosa succede nei 30 minuti
- 1Scegliete un modulo che avete già in produzione.
- 2Lo diamo in pasto al 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.