Agent Teams.
Una vera squadra tech, scriptata.
AgentsRoom Teams concatena i tuoi agenti IA di coding come una vera squadra di sviluppo. Un Fullstack Dev rilascia la feature, un QA Engineer la valida, un PM la approva. Ogni ruolo e scriptato, il workflow e visuale e ogni handoff trasporta il riassunto della feature, il diff, i rischi e gli hint di test. Niente piu un singolo agente che fa tutto male.
Costruisci la tua squadra IA di sviluppo dei sogni su un canvas visuale, esattamente come un workflow n8n. Edge condizionali, feedback loops, retry, max-cycles guard. Salvalo una volta, eseguilo su ogni ticket e guarda i tuoi agenti passarsi il testimone come dei senior.
AgentsRoom Teams: editor visuale di workflow multi-agente, handoff automatico tra agenti Claude Code, feedback loop Dev verso QA, comunicazione inter-agente basata su MCP.
Agent Teams e la risposta di AgentsRoom a una verita brutale sugli agenti IA di coding: un singolo agente che cerca di fare tutto finisce per fare tutto male. L'agente Fullstack che codifica, testa, fa la review, deploya e scrive la spec contemporaneamente dimentica meta delle istruzioni a meta strada. La risposta giusta, quella usata da ogni squadra software seria al mondo, e dividere il lavoro per ruoli. Uno sviluppatore codifica. Un QA engineer valida. Un product manager approva. Un security reviewer fa l'audit. Ogni ruolo ha il suo contesto, il suo focus, i suoi tool.
E esattamente cio che Agent Teams porta in AgentsRoom. Trascini nodi su un canvas infinito (costruito su React Flow, lo stesso engine di n8n, Make, Retool e Pipedream), ogni nodo e un agente Claude Code, Codex, OpenCode, Gemini CLI o Aider assegnato a un ruolo specifico, e li colleghi tra loro. Esegui il team su un ticket dal tuo backlog, oppure collegalo a qualsiasi nuovo agente. AgentsRoom orchestra la catena: avvia il primo agente, attende l'handoff, riassume il lavoro, avvia l'agente successivo con quel riassunto come contesto in entrata, ripete fino a quando il team raggiunge il nodo finale.
Altri tool cercano di farlo con un singolo super-agente e prompt astuti. Lo abbiamo provato, non funziona oltre tre step. I ruoli vanno alla deriva, il contesto si perde, l'agente dimentica cosa doveva verificare. Agent Teams tratta gli agenti come veri compagni di squadra: ognuno ottiene una sessione pulita, un system prompt focalizzato, un payload di handoff strutturato e uno scratchpad condiviso per parlare con gli altri. Questo e il workflow di squadra IA di sviluppo che vuoi davvero.
Editor AgentsRoom Teams: trascina nodi per ogni ruolo, collegali, aggiungi condizioni, salva il team, eseguilo su qualsiasi ticket.
Orchestrazione multi-agente che scala davvero
Ogni nodo sul canvas e un agente. Scegli il suo ruolo (Fullstack, Frontend, Backend, QA, Security, DevOps, PM, Architect, Mobile, Marketing, Git, SEO, Localization o qualsiasi ruolo custom che hai creato), il suo modello (Opus, Sonnet, Haiku, GPT-5, o3, Gemini Pro, ecc.), la sua modalita di handoff (auto via Stop hook, o manuale via pulsante) e qualche riga di istruzioni specifiche per lo step. Tutto qui. Niente cerimonia di prompt engineering, niente file YAML da scrivere.
Gli edge collegano i nodi. Un edge semplice significa: quando il primo agente finisce il suo step, passa al successivo. Un edge condizionale porta un check di flag, ad esempio qaPassed equals true. L'agente QA imposta quel flag nel suo payload di handoff, il runner sceglie l'edge corrispondente. Cosi costruisci feedback loops: il QA finisce, qaPassed equals false, l'edge rimanda al Dev con gli hint di test e i rischi. Il Dev corregge, fa di nuovo l'handoff. Loop fino a quando il QA passa o finche scatta il max-cycles guard.
La comunicazione inter-agente e robusta by design. AgentsRoom include un MCP server dedicato (agentsroom-team) che fornisce a ogni agente del run un set di tool: leggere il contesto del team, leggere lo scratchpad NOTES.md condiviso, postare una nota per i compagni, mandare una domanda a un altro ruolo, leggere l'inbox, leggere la timeline, leggere il git diff rispetto alla baseline del run, e completare lo step con un payload strutturato. Questi tool vengono re-iniettati nella sessione Claude a ogni turno, quindi sopravvivono alla compaction del contesto. Anche dopo un /compact o un /clear, l'agente vede ancora i suoi tool del team.
In piu, un hook UserPromptSubmit ricorda all'agente eventuali nuove note dei compagni prima di ogni messaggio dell'utente. Un file NOTES.md nel workspace e append-only e sopravvive a crash, restart e reboot del Mac. Uno schema di payload di handoff validato lato server impedisce agli agenti di fare handoff con payload vuoti o spazzatura. Questa e la parte che la maggior parte delle demo multi-agente salta in silenzio, ed e il motivo per cui la maggior parte di esse cade a pezzi al ciclo 3.
Tutto quello che ti serve per gestire una squadra IA di sviluppo
Workflow visuale, handoff vero, feedback loops veri, comunicazione inter-agente vera. Costruito per spedire una feature in un ping Slack invece di cinquanta.
Canvas visuale di workflow
Canvas infinito zoomabile basato su React Flow, lo stesso engine dietro n8n, Retool, Pipedream e Make. Trascina nodi, collegali, salva il team. Niente codice, niente YAML.
14 ruoli di agente integrati
Fullstack, Frontend, Backend, DevOps, QA, Security, PM, Architect, Mobile, Marketing, Git Expert, SEO, i18n. Piu qualsiasi ruolo custom che hai gia salvato sul tuo progetto.
Modello e prompt per nodo
Ogni nodo sceglie il suo provider, il suo modello e le sue istruzioni di step. Usa Opus per l'Architect, Haiku per il QA, Codex per il backend pesante, Gemini per il frontend economico. Mix and match.
Handoff automatico
Quando un agente chiama team_complete_step, AgentsRoom costruisce il payload di handoff (riassunto della feature, file modificati, rischi, hint di test, flag) e avvia il nodo successivo con quel payload come contesto iniziale.
Opzione handoff manuale
Preferisci validare ogni step? Imposta il nodo in modalita manuale. L'agente attende, tu clicchi 'Hand off' quando sei soddisfatto del risultato. Il meglio dei due mondi.
Edge condizionali
Ogni edge puo portare un check di flag (es. qaPassed equals true). Costruisci diramazioni: se il QA passa vai al PM, altrimenti torna al Dev. Vera logica di workflow, niente scripting.
Feedback loops
Dev verso QA verso Dev verso QA. Quando il QA rimanda indietro il ticket, l'agente Dev originale viene riutilizzato con la memoria completa del ciclo precedente, cosi corregge davvero la regressione invece di ricominciare da capo.
Max-cycles guard
Cap configurabile (default 3). Evita loop infiniti QA-rejects-Dev. Quando si raggiunge il cap, il run si mette in pausa su awaiting-finalization e decidi cosa fare.
Scratchpad NOTES.md condiviso
Ogni agente nel run legge e scrive un file markdown nel workspace. Sopravvive a compaction, crash, restart. Unica fonte di verita per il ragionamento del team.
Inbox da ruolo a ruolo
Hai bisogno che il QA chieda qualcosa all'Architect a meta run? team_ask posta un messaggio nell'inbox del ruolo. Il prossimo agente di quel ruolo lo legge e risponde. Vera chat tra agenti.
Comunicazione inter-agente via MCP
Tutti i tool del team sono esposti tramite un MCP server. I tool sopravvivono alla compaction del contesto Claude (Anthropic li reinvia a ogni turno). Resilienti a /clear, /compact e loop lunghi.
Riassunto di handoff con Haiku
Se un agente non scrive il proprio riassunto della feature, una piccola chiamata Haiku ne genera uno dal git diff. Economico, veloce, e l'agente successivo arriva sempre con contesto.
Propagazione del Browser MCP
Un nodo del team con verifyInBrowser passa automaticamente il suo agente in modalita browser-access. Il nodo QA arriva con tutti i tool browser (navigate, click, type, screenshot, get logs).
Agenti effimeri per run
Ogni run del team avvia agenti freschi e li distrugge al dismiss. La lista agenti del tuo progetto resta pulita. Il team e il workflow, gli agenti sono il runtime.
Team globali e di progetto
Salva team riutilizzabili nella tua libreria globale (~/.agentsroom/teams) o agganciali a un progetto specifico (committati con la room). Stesso editor, scope diverso.
Template di team inclusi
Tre template di partenza inclusi nell'app: Dev verso QA, Dev verso QA con feedback loop, e Dev verso Security verso QA. Duplica, modifica, esegui. Parti in 30 secondi.
UI della timeline del run
Ogni handoff appare come una card nella timeline del run: quale ruolo ha appena finito, cosa dice il riassunto, quali file sono cambiati, quali flag sono stati impostati. Auditabile, replayabile.
Esegui su qualsiasi ticket del backlog
Trascina un ticket su un team e la catena parte su quel ticket. Il primo agente legge titolo e corpo del ticket, il resto del team prende da li.
14 ruoli specializzati, pronti per essere collegati
Ogni ruolo ha il suo system prompt, le sue aree di focus e task di esempio. Mixali sul canvas. Aggiungi i tuoi ruoli custom in qualsiasi momento.
Perche una vera squadra batte un super-agente
Orchestrazione multi-agente sembra una buzzword. Ecco la differenza pratica, su una feature che spediresti davvero.
Scenario: aggiungere un flusso di checkout Stripe a un sito e-commerce
Super-agente solitario
- • Legge il ticket. Scrive 600 righe tra API, form React, webhook, migration e test.
- • Dimentica la idempotency key sul webhook. Dimentica di testare il path di errore. Dimentica la env var di staging.
- • Dice 'Done'. Passi due ore a cacciare bug in produzione.
Agent Team (Dev verso Security verso QA)
- • L'agente Fullstack rilascia l'implementazione, committa, fa l'handoff con un riassunto e una lista di rischi che segnala il cambio di auth.
- • L'agente Security legge il diff, fa l'audit del check di firma del webhook, scrive hint di test per il QA nel payload di handoff.
- • L'agente QA esegue gli hint di test nel browser integrato, becca un bug di idempotency, imposta qaPassed equals false, rimanda il ticket al Dev con la riproduzione esatta.
- • Il Dev corregge, fa di nuovo l'handoff. Il QA passa. Il PM finalizza. Il run va a done.
Stesso ticket, stessi modelli, stesso progetto. Forma del lavoro diversa. L'approccio team prende cio che il super-agente solitario manca, perche ogni ruolo ha un brief focalizzato e un handoff strutturato.
Come funziona un run di team
Apri la tab Teams
Nella vista del progetto, la tab Teams elenca tre template di partenza (Dev verso QA, Dev verso QA con feedback loop, Dev verso Security verso QA) piu qualsiasi team che hai gia salvato. Duplica un template o clicca 'New team'.
Costruisci il workflow sul canvas
Trascina nodi di agente sul canvas React Flow. Per ogni nodo, scegli il ruolo (Fullstack, QA, Security, PM, ecc.), il provider, il modello e qualche riga di istruzioni di step. Collegali con edge. Aggiungi condizioni sugli edge se ti serve diramare.
Dev → QA → PMImposta la modalita di handoff per nodo
Auto handoff: l'agente chiama team_complete_step quando il suo lavoro e finito, il runner subentra. Manual handoff: l'agente aspetta che tu clicchi 'Hand off'. Mixali secondo necessita.
Esegui il team
Da un ticket del backlog, clicca 'Run with team'. Da uno slot agente vuoto, clicca 'Create as team'. Il primo nodo si avvia come agente effimero nel workspace di progetto.
Guarda l'handoff in azione
Quando l'agente N finisce, AgentsRoom costruisce il payload di handoff (riassunto della feature via l'agente o via Haiku, git diff, rischi, hint di test, flag), accoda una nota a NOTES.md, sceglie l'edge uscente giusto in base ai flag e avvia l'agente N+1 con quel payload come contesto in entrata.
Loop, end, finalize
I feedback loops rientrano nell'agente originale (memoria completa preservata). Il nodo finale attiva awaiting-finalization. Clicchi 'Finish run'. Dismiss del banner per distruggere gli agenti e liberare le PTY.
Comunicazione inter-agente che sopravvive a tutto
Il dettaglio che la maggior parte delle demo multi-agente salta. Ecco cio che fa reggere Agent Teams su run lunghi e molti cicli.
Gli agenti Claude Code hanno una context window e la compattano. L'errore classico dei sistemi multi-agente e mettere il coordinamento del team solo nel system prompt. Dopo due cicli di /compact, l'agente non ha piu idea di essere in un team. AgentsRoom non fa cosi.
Tutto il coordinamento del team vive in tre posti che sopravvivono alla compaction. Primo, un MCP server (agentsroom-team) espone tool (team_get_context, team_read_notes, team_post_note, team_read_inbox, team_ask, team_read_timeline, team_read_diff, team_complete_step). I tool MCP vengono rimandati a Claude a ogni turno dalla CLI, quindi sono immuni alla compressione del contesto.
Secondo, un hook UserPromptSubmit gira prima di ogni messaggio dell'utente e antepone un piccolo promemoria se ci sono nuove note o nuovi messaggi inbox per quel ruolo. Economico quando non succede nulla, decisivo quando succede.
Terzo, NOTES.md e state.json vivono su disco nel workspace. L'agente puo rileggerli in qualsiasi momento con un semplice Read o con team_read_notes. Sopravvivono a crash, restart, /clear, /compact e reboot del Mac. Il system prompt non e mai la fonte di verita: il disco e i tool MCP lo sono.
Cosa costruisce la gente con Agent Teams
Pipeline Dev verso QA
Il classico. Il Fullstack rilascia la feature. Il QA la valida nel browser integrato, esegue gli hint di test, approva. Team a due nodi, gira su ogni ticket del backlog.
Dev verso QA con feedback loop
Come sopra, ma con un edge condizionale: qaPassed equals false rimanda il ticket al Dev con gli hint di test. Max 3 cicli. Becca le regressioni prima che arrivino a un reviewer umano.
Dev verso Security verso QA
Per feature che toccano auth, pagamenti o PII. L'agente Security rivede il diff, segnala rischi, scrive hint di test per il QA. Usato da team che spediscono fintech, healthtech e B2B SaaS.
PM verso Architect verso Dev
Workflow spec-first. L'agente PM trasforma il ticket in una spec strutturata. L'Architect sceglie l'approccio. Il Dev implementa. Tre ruoli, separazione pulita, decisioni tracciabili.
Fan-out Frontend, Backend, DevOps
Split sequenziale per feature full-stack. Il Frontend rilascia la UI. Il Backend rilascia l'API. Il DevOps aggiunge la config infra. Ogni ruolo lavora nella sua area, fa l'handoff con un diff pulito.
Marketing verso SEO verso i18n
Si, AgentsRoom Teams non e solo per il codice. Il Marketing scrive la copy della landing. Il SEO inietta le keyword. La Localization traduce in 14 lingue. Un team, un ticket, una spedizione.
Come si confronta con altri approcci multi-agente
L'orchestrazione multi-agente e una buzzword affollata. Ecco cosa sta davvero spedendo, e dove si colloca AgentsRoom Teams.
I Subagents di Anthropic (Task tool, .claude/agents) permettono a una singola sessione Claude di delegare ad agenti helper specializzati. Ottimo per la delega inline, ma la sessione genitore resta il coordinatore e un singolo contesto. AgentsRoom Teams e un livello sopra: ogni nodo del team e una sessione Claude top-level separata, con la sua finestra, il suo stato, il suo scrollback. CrewAI, AutoGen e LangGraph sono ottimi framework Python per flussi multi-agente, ma vivono fuori dal tuo IDE e non eseguono CLI Claude Code, Codex o Gemini end-to-end sul tuo repo locale. n8n, Make, Pipedream e Retool offrono lo stesso tipo di canvas editor che usiamo, ma sono piattaforme di automazione generaliste, non costruite per agenti IA di coding. AgentsRoom Teams e l'editor di workflow multi-agente in stile canvas, ma cablato specificamente sui tuoi agenti CLI, sul tuo progetto, sul tuo git, sui tuoi terminali e sul tuo browser.
Se costruisci sistemi agentici in Python, continua a usare CrewAI o LangGraph per pipeline di produzione. Se spedisci codice con Claude Code, Codex CLI, OpenCode, Gemini CLI o Aider, Agent Teams e il workflow di squadra che gira dove davvero scrivi codice.
FAQ
In cosa differisce dai subagents di Claude Code (Task tool, .claude/agents)?
I subagents di Claude sono delegazioni inline da una singola sessione Claude genitore. Il genitore decide quando chiamare un subagent, il subagent gira in una context window isolata, restituisce un risultato e il genitore prosegue. AgentsRoom Teams e un livello sopra: ogni nodo e una sessione Claude Code top-level con il suo terminale, il suo stato e il suo scrollback. Vedi ogni agente girare live nella sua tab, puoi parlarci in qualsiasi momento, puoi mettere in pausa il team, cambiare il workflow e riprendere. Non e un rimpiazzo dei subagents Claude, puoi assolutamente usare entrambi. Un nodo del team puo usare subagents internamente.
Funziona solo con Claude Code?
Funziona con tutti i provider supportati da AgentsRoom (Claude Code, Codex CLI, OpenCode, Gemini CLI, Aider). Ogni nodo del team sceglie il proprio provider e modello. I tool di coordinamento del team basati su MCP funzionano in modo identico tra provider perche sono esposti tramite il Model Context Protocol standard. Puoi eseguire un team con Codex sul nodo backend pesante e Haiku sul nodo QA se questo e cio che si adatta al tuo budget e alla tua latenza.
Cos'e un payload di handoff?
Un oggetto strutturato che viaggia da un agente al successivo. Campi: featureSummary (una breve descrizione di cio che e appena stato rilasciato), changedFiles (git diff name-status), touchedAreas (UI, API, DB, config), risks (qualsiasi cosa di cui il prossimo agente debba preoccuparsi), testHints (priorita per il QA), flags (boolean come qaPassed, usati dagli edge condizionali). L'agente chiama team_complete_step con questo payload, il runner lo valida server-side, l'agente successivo lo riceve come contesto iniziale.
Gli agenti possono davvero andare avanti e indietro (Dev verso QA verso Dev)?
Si. Quando un nodo viene rientrato (ciclo maggiore di 1), AgentsRoom non avvia un nuovo agente. Riutilizza l'agente originale del ciclo 1, scrive il nuovo payload di handoff direttamente nel suo terminale esistente, e l'agente mantiene la sua memoria completa della sessione Claude dei cicli precedenti. Questo e critico: un agente Dev che sa gia cosa il QA ha segnalato l'ultima volta corregge il bug. Un agente Dev fresco senza memoria ripeterebbe lo stesso errore.
Cosa succede se il QA continua a rifiutare il Dev all'infinito?
La config del team ha un max-cycles guard, default 3. Quando si raggiunge il cap, il run si mette in pausa con stato 'blocked' e ti aspetta. Puoi finalizzare il run, fare manualmente un altro handoff, o cancellare tutto. Niente loop infiniti, niente fatture a sorpresa nottetempo.
Tutti gli agenti del team condividono lo stesso workspace git?
Si. Il team gira in un singolo workspace e su un singolo branch (o worktree se usi la feature AgentsRoom Worktrees). Ogni agente vede il lavoro del precedente attraverso git. Il payload di handoff include un git diff rispetto alla baseline del run cosi il prossimo agente sa esattamente cosa e nuovo.
Serve un abbonamento extra?
No. I Teams fanno parte di AgentsRoom. Porti le tue chiavi provider (Claude, Codex, OpenCode, Gemini, Aider) e paghi solo i token che usi, come con un singolo agente. Eseguire un team Dev verso QA su un piccolo ticket costa tipicamente come eseguire un singolo agente Fullstack, perche Haiku/Sonnet sullo step QA e economico.
Dove sono memorizzati i team? Sono committati su git?
I team con scope di progetto vivono con la room, sincronizzati nel cloud e cachati in {project}/.agentsroom/teams-cache.json (gitignored). I team globali vivono in ~/.agentsroom/teams/{teamId}.json sulla tua macchina, un file per team. Decidi quale scope si adatta a ogni workflow.
E se un agente crasha o l'app si riavvia a meta run?
Lo stato del run e persistito su disco in {workspace}/.agentsroom/team-runs/{runId}/ (state.json, NOTES.md, inbox/, timeline.jsonl). NOTES.md e append-only, ogni scrittura di stato e atomica. Gli agenti possono rileggere tutto in qualsiasi momento con team_read_notes o team_get_context. Lo strato di orchestrazione e in fase di hardening per replayare completamente un run interrotto al restart dell'app, ma la storia su disco e gia crash-safe.
Posso eseguire piu team in parallelo su ticket diversi?
Si. Ogni run di team e indipendente e identificato dal suo runId. Puoi avere un team Dev verso QA che gira sul ticket A, un team Dev verso Security verso QA sul ticket B e un team PM verso Architect verso Dev sul ticket C, tutti vivi nello stesso progetto. All'interno di un singolo run, l'esecuzione e sequenziale (un nodo attivo alla volta) per prevedibilita.
Costruisci la tua squadra IA di sviluppo dei sogni
Tre template inclusi nell'app. Apri AgentsRoom, trascina nodi, disegna edge, esegui su qualsiasi ticket. La tua squadra IA di sviluppo e a un clic di distanza.
App companion: monitora i tuoi agenti in movimento
Funziona con Claude, Codex, OpenCode, Gemini CLI e Aider
Invia bug e richieste direttamente nel tuo backlog pubblico.