Il mio agente AI per il coding continuava a fallire — Cosa ho cambiato

Sei settimane fa, il mio agente AI per il coding produceva spazzatura.

Scriveva funzioni che compilavano ma non facevano nulla. Superava i test per i motivi sbagliati. Risolveva un bug ma ne creava tre nuovi.

Pensavo che il problema fosse l'agente. Mi sbagliavo. Il problema era la mia mancanza di disciplina.

Uso un agente AI per il 40% del mio lavoro di ingegneria. Gestisce refactoring, generazione di test e investigazione dei bug. Quando il mio codebase era disordinato, l'IA rendeva quel disordine tre volte peggiore.

L'IA non sostituisce la disciplina. Amplifica ciò che già possiedi.

Ecco come ho cambiato il mio workflow per migliorare i risultati:

  • I test devono verificare il comportamento, non lo stato. Smetti di scrivere test come "assert user is not None." È una bugia. Un test dovrebbe controllare dati specifici come "assert user.email == expected_email." Se il test è debole, l'IA ne approfitterà.

  • Leggi ogni singolo diff. Prima accettavo i refactoring senza guardare il codice. Questo portava a dipendenze circolari e un'architettura disordinata. Se non riesci a spiegare perché una modifica è migliore, rifiutala.

  • Rendi lo stato esplicito. Non lasciare che l'IA "capisca da sola" come gestire cache o sessioni. Definisci queste cose nei tuoi prompt o schemi. Lo stato inferito porta a bug silenziosi che mandano in crash la produzione.

  • Scrivi i tuoi test per le modifiche dell'agente. Ogni volta che l'agente modifica il codice, scrivo prima un test creato da un essere umano. Costa 15 minuti, ma fa risparmiare ore di debugging.

  • Esigi fallimenti espliciti. Se una modifica supera i test ma rompe la logica, il sistema deve segnalarlo. Non accettare mai "i test passano, rilascia" come una metrica valida.

I risultati:

  • I bug a settimana sono scesi da 5 a meno di 1.
  • Il tempo di debugging è sceso da 6 ore a 1 ora a settimana.

L'agente non è cambiato. Sono cambiato io.

Se usi agenti AI, sistema prima il tuo codebase. Migliora i tuoi test, chiarisci il tuo stato e rendi più rigorose le tue revisioni.

L'agente è uno specchio. Assicurati di avere qualcosa che valga la pena amplificare.

Fonte: https://dev.to/susiloharjo/my-ai-coding-agent-kept-breaking-what-i-changed-4l5f

Community di apprendimento opzionale: https://t.me/GyaanSetuAi