Agentic engineering: sviluppare con gli agenti IA e mantenere il controllo

Che cos’è l’agentic engineering?

Un agente di coding è più di una chat che suggerisce frammenti di codice. Lavora direttamente nella cartella del tuo progetto: legge file, cerca nel codice, esegue test, modifica più file e controlla da solo il risultato. Il coding agentico descrive ciò che fa l’agente. L’agentic engineering descrive la disciplina che c’è intorno: come scrivi gli incarichi, rendi verificabili i risultati e mantieni la responsabilità.

Il termine ha un padrino noto. Nel febbraio 2025 Andrej Karpathy, cofondatore di OpenAI, ha coniato “vibe coding” per un modo di programmare in cui ti abbandoni completamente alle vibrazioni e dimentichi perfino che il codice esiste. Collins l’ha scelta come parola dell’anno 2025. Un anno dopo, nel febbraio 2026, Karpathy ha indicato “agentic engineering” come il suo termine preferito per la versione professionale: agentic, perché per la maggior parte del tempo il codice non lo scrivi più tu ma guidi e sorvegli degli agenti; engineering, perché richiede competenza ed esperienza.

Agentic engineering e vibe coding: la differenza

Entrambi usano gli stessi strumenti. La differenza sta in quanto definisci prima e in quanto a fondo controlli dopo.

Il vibe coding non è un errore: è uno strumento per il momento giusto. Molti vibe coder passano all’engineering quando l’esperimento diventa qualcosa che usano altre persone.

Tu guidi: incarico, revisione, decisione

Con l’agentic engineering il tuo lavoro cambia. Digiti meno codice e fai tre cose con più cura:

• Incarico: descrivi cosa va costruito e come capire quando è finito. Più l’incarico è preciso, meno giri di correzioni servono.
• Revisione: leggi il diff, guardi i risultati dei test e provi il risultato. Un agente si ferma quando il lavoro sembra finito; solo una revisione mostra se lo è davvero.
• Decisione: merge o rielaborazione, prossima attività o cambio di rotta. Queste decisioni restano a te.

Attriti tipici quando lavori ogni giorno con agenti di coding

Se lavori ogni giorno con gli agenti, conosci questi punti:

• I punti aperti spariscono nella cronologia della chat. Alla fine di una sessione restano tre cose. Qualche giorno dopo sono sepolte sotto nuovi messaggi o chiuse insieme alla sessione.
• Le attività per te si nascondono nelle risposte lunghe. L’agente ha bisogno di una chiave API, di un record DNS o di un’approvazione nell’App Store e lo menziona nel quarto paragrafo del suo riepilogo.
• Più sessioni, più progetti. In una finestra c’è la pagina del corso, in una seconda un bugfix, in una terza una ricerca. Solo tu sai quale stato si trova dove.
• Finestre di contesto piene. Le sessioni lunghe peggiorano gli agenti, ed è per questo che Anthropic consiglia di ripartire da zero con /clear tra attività non collegate. Ciò che non è in un file, per l’agente a quel punto è perso.

I rimedi hanno una cosa in comune: lo stato del lavoro va nei file, non nella chat.

In pratica: flussi di lavoro con Claude Code che reggono

Attività come file invece della cronologia della chat

Crea ogni attività come file che l’agente può leggere e modificare: con titolo, stato, responsabile e una cronologia. Così ogni nuova sessione inizia con “Svolgi le tue attività aperte” e l’agente trova tutto ciò che gli serve, anche dopo /clear o in un altro strumento. Alla fine di una sessione l’incarico è: “Crea attività per i punti aperti.”

Specifiche con criteri di accettazione

Per tutto ciò che va oltre una riga scrivi una specifica: obiettivo, requisiti e criteri di accettazione da spuntare. Nelle sue best practice per Claude Code, Anthropic consiglia, per le funzioni più grandi, di lasciare che l’agente faccia domande e scriva prima una specifica, e poi di avviare l’implementazione in una nuova sessione. Le buone specifiche nominano i file coinvolti, dicono cosa è escluso e finiscono con un controllo che dimostra che tutto funziona.

Stabilire il grado di autonomia: esegui, bozza, chiedi

Non tutte le attività tollerano la stessa libertà. Un aggiornamento di dipendenza l’agente può eseguirlo direttamente. I testi per la home page dovrebbe prepararli come bozza da approvare. Per una migrazione del database dovrebbe chiedere prima. Decidilo per ogni attività, non una volta per tutte.

Restituzioni invece di riepiloghi

Quando l’agente ha finito, non dovrebbe solo rispondere ma restituire l’attività: da verificare, con una nota su cosa ha fatto e dove si trova il risultato, oppure con una domanda se manca qualcosa. Ciò che solo tu puoi fare, lo crea come attività separata per te.

Revisione con prove

Chiedi prove invece di affermazioni: l’output dei test, il comando eseguito, uno screenshot. Dai all’agente qualcosa che può controllare da solo, come test o una build. Per le modifiche più grandi aiuta la modalità piano di Claude Code (Shift+Tab): l’agente legge e pianifica prima di cambiare qualcosa. E un secondo sguardo in un contesto nuovo, per esempio da un subagente, trova le lacune che l’agente non vede nel proprio codice. Le attività di codice le svolge nel proprio branch; sul merge decidi tu.

AGENTS.md e CLAUDE.md: il manuale per il tuo agente

Ogni sessione inizia senza alcun ricordo della precedente. Ciò che l’agente deve sapere sul tuo progetto va quindi in un file che legge all’inizio. AGENTS.md è un formato aperto per questo scopo, una specie di README per agenti, oggi curato dall’Agentic AI Foundation sotto la Linux Foundation. Codex, Cursor e molti altri strumenti lo leggono. Claude Code legge CLAUDE.md e ricorre ad AGENTS.md quando non c’è un CLAUDE.md; con @AGENTS.md includi l’uno nell’altro. Gemini CLI legge GEMINI.md; il nome del file si può cambiare.

# AGENTS.md

## Comandi
- Test: npm test
- Prima di concludere: npm run lint && npm run typecheck

## Regole
- Lavora in un branch tuo, mai su main.
- Nessun push e nessun deploy senza approvazione.
- Nuove dipendenze solo dopo aver chiesto.

## Attività
Le attività sono in TandemLoop, collegato come ./tandemloop.
Leggi prima ./tandemloop/AGENTS.md. Ciò che posso fare solo io
(accessi, approvazioni, decisioni) crealo lì come attività per me.

Tieni il file breve. Per CLAUDE.md Anthropic consiglia meno di 200 righe e solo ciò che l’agente non può ricavare dal codice. Se ripete un errore, la regola va nel file; se segue una regola già da tempo, puoi toglierla.

Strumenti: Claude Code, Codex, Cursor, Gemini CLI

Lo strumento che scegli conta meno di come lavori. Se istruzioni, specifiche e attività stanno in file, puoi cambiare agente e quello nuovo riparte dallo stesso stato.

Come TandemLoop supporta l’agentic engineering

TandemLoop è un’app di to-do per Mac, iPad e iPhone in cui tu e il tuo agente condividete le stesse attività. Sono file di testo nel tuo iCloud Drive; il tuo agente li legge e li scrive direttamente e segue un manuale fornito da TandemLoop. Non servono plug-in né API.

Più agenti e sessioni leggono la stessa cartella e vedono lo stesso stato. Dovrebbe scrivere uno solo alla volta, altrimenti la sincronizzazione tramite iCloud può creare copie in conflitto. La pagina Un’app di to-do per lavorare con gli agenti IA mostra l’intero flusso di lavoro; la guida Claude Code e Obsidian descrive come appare la stessa configurazione in un vault di Obsidian.

Oltre al codice, TandemLoop è un’app di to-do completa con Inbox, progetti, scadenze e viste personalizzate. Se segui il metodo GTD, lascia che l’agente faccia una prima cernita dell’Inbox e prepari la revisione settimanale.