Manutenzione evolutiva: ereditare un progetto vivo senza perdere il filo
Di Xavier Franco, CEO de Elternativa · Grupo Zemsania
· 5 min di lettura
Redatto con l’aiuto dell’IA e rivisto da Xavier Franco

In questo articolo
C’è un momento che quasi tutti i responsabili tecnologici hanno vissuto o vivranno: ereditare un progetto vivo. Cambia il fornitore, se ne va il team che lo seguiva o si riorganizza il dipartimento, e all’improvviso Lei si ritrova con un sistema in produzione, con utenti, con richieste in sospeso e con una manutenzione evolutiva che non può fermarsi. È come salire su un treno in corsa: non può fermarlo per capirlo. Eppure bisogna capirlo.
Perché fa tanta paura
Ereditare un sistema che funziona ha un tranello: il sistema funziona, ma nessuno Le ha dato il manuale. Ciò che Le serve davvero sapere è di solito sparso tra il codice, la testa del team uscente e una manciata di documenti di data incerta.
E poi c’è il debito tecnico che arriva insieme al sistema. Il sondaggio di Stack Overflow del 2024 dice che il debito tecnico è la principale frustrazione sul lavoro per il 63 % degli sviluppatori professionisti. Quando eredita un progetto, eredita anche il suo debito.
In pratica: prima di firmare un cambio di fornitore, chieda un elenco delle cinque cose del sistema che «non si toccano». Se nessuno sa stilarlo, il rischio è maggiore di quanto sembri.
Che cosa si perde nel passaggio di consegne
In un passaggio di consegne fatto male si perdono tre cose, e quasi mai ce ne si accorge finché non servono:
- Il perché delle decisioni. Perché si è fatto così e non altrimenti. Senza questo, il team nuovo torna a discutere ciò che era già stato deciso o, peggio, disfa qualcosa che aveva la sua ragione.
- Le regole non scritte. Come si effettua il deploy, che cosa si testa, quali convenzioni segue il codice.
- Ciò che è già fallito. Gli errori che il team precedente aveva imparato a evitare e che il nuovo ripeterà.
Una riunione di passaggio di due ore e un documento non coprono tutto questo. Per quanto ci si provi.
Prima, capire senza toccare
Il primo passo è capire il sistema da ciò che c’è, non da ciò che viene raccontato. Significa leggere il repository, la configurazione e i processi di deploy, e ricavarne come funziona davvero.
Con l’IA, questa lettura è molto più rapida di qualche anno fa. Ma deve essere una lettura in sola lettura e con metodo: ogni cosa documentata, collegata a dove nasce. E se il sistema è vecchio e non ha documentazione, la documentazione funzionale e tecnica si ricava dal codice stesso, non dalla memoria di qualcuno.
In pratica: nelle prime settimane, vieti le modifiche strutturali. Il team nuovo consegni prima la documentazione di ciò che esiste, validata da chi lo conosce.
Poi, scrivere l’avvio
Il passo successivo è scrivere ciò che nel nostro metodo chiamiamo l’avvio del progetto: come lavora il team, quali branch ci sono, quali ambienti, come si testa e quali convenzioni si seguono. Lo si racconta conversando e resta scritto nel sistema, non in un documento che scade.
Se il team uscente è ancora disponibile per qualche settimana, è il momento migliore perché lo validi. Ciò che dice resta scritto e collegato al progetto.
Senza fermare l’evolutivo
Nel frattempo il business continua a chiedere cose. Ed ecco la chiave: l’evolutivo non si ferma. Le richieste entrano nella stessa coda, ciascuna con il proprio contratto e i propri criteri di accettazione fissati prima di iniziare. Le istanze di IA le sviluppano, un’altra le testa e una persona del team valida ogni chiusura.
Ciò che si impara in ogni attività viene scritto come regola. Così, dopo poche settimane, il sistema sa del progetto più di qualsiasi documento di passaggio.
In pratica: misuri quanto impiega il team nuovo a chiudere le prime richieste e come evolve settimana dopo settimana. È il miglior segnale che il passaggio di consegne sta andando bene.
E il debito tecnico, finalmente nel piano
C’è un effetto che mi piace molto. Quando un team eredita un progetto, di solito dedica tutto il suo tempo a evitare che si rompa. Il debito tecnico resta per «quando ci sarà tempo», che non arriva mai.
Con una capacità orchestrata, questo cambia: più istanze che lavorano in parallelo fanno entrare nel piano ciò che prima non ci stava, come il debito tecnico, il legacy o le migrazioni in sospeso. Non cambia solo la velocità: cambia l’ampiezza.
Ereditare non è migrare
Un’ultima sfumatura. Ereditare un progetto non obbliga a migrarlo. Spesso la tentazione del team nuovo è rifare tutto «a modo suo». Il mio consiglio è l’opposto: prima capirlo, poi decidere. Con la documentazione ricavata dal codice e l’evolutivo in corso, avrà i dati per sapere se modernizzare, migrare o, semplicemente, mantenere meglio.
Da dove cominciare
- Chieda l’elenco di ciò che «non si tocca» prima del passaggio di consegne.
- Legga il sistema in sola lettura e documenti ciò che c’è.
- Scriva l’avvio del progetto e lo faccia validare da chi lo conosce.
- Metta l’evolutivo in un’unica coda, con contratto e validazione.
- Decida con i dati se mantenere, modernizzare o migrare.
Come La aiutiamo
In Agentic Data & Software Engineering orchestriamo le IA di sviluppo che Lei ha già lungo tutto l’SDLC, compresi l’evolutivo e il supporto: nella stessa coda, con ciò che si è imparato scritto come regole. Lo eseguiamo nella modalità che ha già contrattualizzato: assistenza tecnica, progetto a corpo o servizio gestito.
Lo facciamo con Agentagile: l’avvio, il piano, ogni attività e la sua validazione restano nel sistema, e la conoscenza del progetto in un database di Sua proprietà. Cambia il team; il metodo resta.
Cosa succederebbe se domani cambiasse fornitore?
Le mostriamo in una demo come si prende il testimone di un progetto in produzione: piano, regole e conoscenza in un sistema Suo fin dal primo giorno.


