Come far collaborare più Agenti AI sul codice senza disastri: Il Protocollo Intent-Sync
Stiamo entrando nell’era in cui non abbiamo più un solo assistente AI, ma una vera e propria flotta. Lavori con Cursor nel tuo IDE, tieni Claude Code aperto nel terminale per refactoring di massa, e magari hai un bot autonomo che risolve le issue di GitHub in background.
È il sogno di ogni sviluppatore, finché non si scontrano con la dura realtà: gli agenti AI sono ciechi l’uno rispetto all’altro.
Se due agenti decidono di modificare lo stesso file nello stesso momento, il risultato non è una collaborazione, ma una race condition distruttiva. Il codice viene sovrascritto, la logica si corrompe e tu passi le ore a fare il merge di conflitti creati dalle tue stesse AI.
Per risolvere questo problema, abbiamo costruito Intent-Sync (noto anche come Intent-Guard): un protocollo di coordinamento open-source leggero, atomico e a prova di bomba per agenti autonomi.
💥 Il problema: Non basta un “File Lock”
All’inizio potresti pensare: “Basta creare un file .lock nella cartella!”. Purtroppo, nel mondo del software engineering automatizzato, la situazione è più complessa.
- Race Conditions nell’Acquisizione: Se 10 agenti controllano un file
.locknello stesso millisecondo, tutti lo vedranno libero e scriveranno contemporaneamente. - Intenti Semantici: Se l’Agente A sta solo leggendo un file per capire il contesto, non dovrebbe bloccare l’Agente B che vuole modificarlo.
- Lease Orfane: Cosa succede se un agente crasha o va in timeout mentre detiene il lock? Il repository rimane bloccato per sempre.
Avevamo bisogno di un sistema che non si limitasse a bloccare i file, ma che coordinasse gli intenti.
🛠️ La Soluzione: Intent-Sync Architecture
Intent-Sync non è un ennesimo wrapper per AI, ma un vero e proprio strato di coordinamento infrastrutturale. Si compone di due elementi:
- Un Server FastAPI leggerissimo che funge da arbitro centrale (può girare in locale
localhost, sulla LAN aziendale, o su un server cloud). - Una CLI stateless (Command Line Interface) che gli agenti usano per dichiarare le proprie intenzioni prima di toccare il codice.
La Magia sotto il cofano: L’Acquisizione Atomica
Come facciamo a garantire che due macchine non ottengano mai il permesso di modificare lo stesso file nello stesso istante?
Abbiamo abbandonato soluzioni complesse per affidarci all’ingegneria collaudata: SQLite e la transazione BEGIN IMMEDIATE.
Quando un agente richiede una “lease” (un permesso temporaneo), il server apre una transazione esclusiva a livello di sistema operativo. Se 100 agenti richiedono lo stesso file contemporaneamente, il database li mette in fila. Esattamente un agente riceverà un 200 OK (ALLOW), mentre gli altri 99 riceveranno un 409 CONFLICT, con i dettagli su chi sta lavorando a quel file e perché.
🧠 Un “Conflict Engine” Intelligente
Il nostro server non blocca ciecamente tutto. Prima di approvare una richiesta, passa attraverso un Conflict Engine che valuta una matrice di compatibilità:
- Read vs Read?
ALLOW(Più agenti possono leggere lo stesso file). - Read vs Modify?
ALLOW(Un agente può leggere mentre l’altro scrive). - Modify vs Modify?
CONFLICT(Bloccato immediatamente). - Refactor vs Modify?
CONFLICT(Bloccato).
Inoltre, il motore comprende la struttura delle directory. Se l’Agente A richiede l’accesso a src/auth/*, il sistema bloccherà l’Agente B che tenta di modificare src/auth/session.py, ma lascerà passare chi tocca src/database.py.
🛡️ Sicurezza e Ownership a prova di AI
Gli agenti AI a volte hanno allucinazioni e provano a “forzare” i comandi. Per evitare che un agente rilasciasse per sbaglio il lock di un altro, abbiamo implementato un sistema di Ownership rigido.
Ogni lease è legata a un agent_id univoco. Se un bot tenta di forzare il comando release su un file su cui non sta lavorando, il server API restituisce un inesorabile 403 Forbidden. In aggiunta, ogni lease ha un Time-To-Live (TTL). Se un agente sparisce nel nulla, la sua lease scade automaticamente dopo 15 minuti (o il tempo configurato), liberando il repository.
🚀 Il futuro del Multi-Agent Software Engineering
Passare da un singolo assistente AI a una vera Software House di agenti autonomi richiede infrastrutture pensate per la concorrenza. Intent-Sync è il primo passo per trasformare l’attuale caos in un’orchestra ben diretta.
Vuoi provarlo nei tuoi progetti? È perfetto per coordinare strumenti come Claude Code, Cursor, Aider o Windsurf sullo stesso codebase.
👉 Scopri il codice su GitHub e inizia a far scalare i tuoi agenti AI in totale sicurezza.
AI Coding, Multi-Agent Systems, Claude Code, Cursor, Python
Domande frequenti
Questo strumento è gratuito?
Sì. Lo strumento ShortPrompt è disponibile gratuitamente direttamente dal browser.
I risultati sono indicativi?
Sì. Le stime possono variare in base ai dati inseriti, alla piattaforma, alla nicchia e al tipo di collaborazione. Per decisioni fiscali o professionali è sempre opportuno verificare la propria situazione con un professionista.
Posso usare il risultato per una collaborazione con un brand?
Sì. Il risultato può essere utilizzato come punto di partenza per valutare una collaborazione, ma il prezzo finale può dipendere da formato, audience, diritti di utilizzo, esclusiva, durata della campagna e richieste del brand.