Harness engineering,
da una finestra, non da un dotfile
Quello che un agente può fare lo decide il suo harness: la persona, gli strumenti e la memoria. AgentsRoom li trasforma in tre controlli separati da combinare per agente e per attività.
Un toolkit raggruppa skill, server MCP, connessioni salvate e variabili d'ambiente sotto un unico nome. Associalo a un agente, a un singolo ticket, a un passaggio del team, a un progetto o alla cartella di un cliente. Lo modifichi una volta e ogni agente che lo usa riceve la modifica al prossimo avvio, su Claude Code, Codex e ogni altra CLI di agente.
- scan-documents
- summarize
- notes (MCP)
- staging-db
- Claude Code
- Codex
- Antigravity
- Cursor
Un toolkit di ricerca associato a un ticket: l'agente riceve le sue skill, il suo server MCP e la sua connessione all'avvio, e legge la memoria del progetto senza scriverci.
L'harness engineering (progettare tutto ciò che circonda un agente di coding) consiste nel decidere quali istruzioni legge, quali strumenti può chiamare e quale conoscenza conserva. Oggi quasi tutto vive in file. Un CLAUDE.md qui, un mcp.json là, una cartella di skill per ogni CLI, variabili d'ambiente nel profilo della shell, e niente di tutto questo arriva all'agente o all'attività successiva senza essere copiato a mano.
In AgentsRoom un agente è fatto di tre cose che imposti separatamente. La persona dice chi è. I suoi toolkit dicono cosa può usare: skill, server MCP, connessioni SSH, di database e di comandi di dev salvate, variabili d'ambiente. L'impostazione della memoria dice se legge e scrive la memoria condivisa del progetto. Ne cambi una senza toccare le altre due.
Un toolkit viene associato per riferimento, mai copiato. Un toolkit di ricerca con una skill che analizza i documenti, una che riassume e una connessione alla tua app di note può equipaggiare insieme un agente revisore, un singolo ticket e l'intera cartella di un cliente, e ogni miglioramento arriva a tutti.
Tre controlli invece di un'unica definizione di agente
Dai capacità a un'attività senza persona, tieni una persona senza memoria o riusa gli stessi strumenti con ruoli diversi.
Skill, server MCP e connessioni in un solo toolkit
Scegli le skill dalla tua libreria e le connessioni SSH, di database e di comandi di dev salvate, incolla il JSON dei server MCP che usi già e aggiungi variabili d'ambiente. Le credenziali restano nel Gestore di segreti come riferimenti {{secret:NAME}}, risolti sul tuo computer all'avvio.
Associato per riferimento
Agenti, ticket e impostazioni salvano il toolkit, non una copia del suo contenuto. Modifica il toolkit una volta e ogni agente che lo usa riceve le nuove skill e i nuovi server al prossimo avvio.
A ogni livello che usi già
Associa un toolkit a un agente, a un agente salvato, a un singolo ticket del backlog, a un passaggio di un team di agenti, a un intero progetto o alla cartella di un cliente, le cui sottocartelle aggiungono i propri toolkit.
Capacità per una sola attività
Un ticket può portare i propri toolkit senza cambiare il suo agente. Si aggiungono a quelli dell'agente, oppure sostituiscono tutto (agente, progetto e cartella) quando la modalità Skills del ticket è Sostituisci.
Memoria, separata dalla persona
Imposta la memoria del progetto su Disattivata, Sola lettura o Lettura e scrittura per agente, e cambiala per un singolo ticket. Sola lettura lascia disponibile la base di conoscenza senza permettere a un agente di revisione di riscriverla.
Ogni CLI di agente, su desktop e su telefono
Le skill arrivano a ogni CLI come testo e, su Claude Code e Antigravity, come skill native. I server MCP vengono scritti nel formato proprio di ogni CLI. Crea e associa i toolkit dal desktop o dall'app mobile, oppure lascia che lo faccia un agente con gli strumenti di AgentsRoom.
Crea un toolkit in meno di un minuto
Nessun file da modificare e niente da riavviare a mano.
- 1
Apri la libreria
Clicca sulla valigetta accanto ad Agenti nella barra del titolo, oppure su Gestisci accanto a qualsiasi campo Toolkit, poi su Nuovo toolkit.
- 2
Riempilo
Dagli un nome, scegli le sue skill e connessioni, incolla i suoi server MCP e aggiungi le sue variabili d'ambiente. Usa {{secret:NAME}} per un token.
- 3
Associalo
In Modifica agente > Opzioni avanzate > Toolkit, su un ticket, su un passaggio del team, in Impostazioni del progetto > Capacità e autorizzazioni o in Impostazioni della cartella > Conoscenza.
- 4
Scegli la memoria
Subito sotto i toolkit, imposta Memoria del progetto su Disattivata, Sola lettura o Lettura e scrittura, oppure lasciala ereditata.
- 5
Avvia
Il prossimo avvio dell'agente espande il toolkit nella sua CLI: skill, server, connessioni e variabili, senza scrivere nulla nel tuo repository.
Perché separare persona, strumenti e memoria
Finora una definizione di agente portava tutto insieme. Riusare un insieme di skill e server con un ruolo diverso significava ricostruirlo, e l'unico modo per tenere un agente lontano dalla memoria del progetto era togliergli la persona con il prompt di sistema minimo.
Separati, i tre controlli rispondono a situazioni reali: un revisore che legge la memoria ma non la scrive mai, un ticket di ricerca occasionale che ha bisogno di un server di note che il suo agente non ha, la cartella di un cliente in cui ogni agente deve raggiungere lo stesso database di staging, un passaggio del team che usa un toolkit per il browser solo durante il proprio turno.
È anche la porta d'ingresso all'harness engineering per chi non vuole mantenere dei dotfile: ogni scelta è visibile nella finestra dell'agente, ti segue con il tuo account sugli altri computer e si controlla con un colpo d'occhio.
Buono a sapersi
- Una modifica si applica al prossimo avvio dell'agente. Una sessione già in esecuzione mantiene ciò con cui è partita.
- Una skill o una connessione di progetto dentro un toolkit vale solo nel proprio progetto. Le skill dell'account valgono ovunque.
- I toolkit appartengono al tuo account. In un team condiviso con i colleghi, l'avvio di ciascuno risolve solo i propri toolkit.
- Un passaggio del team ha i toolkit ma non l'impostazione della memoria: usa l'opzione Passo di sola lettura per un passaggio che non deve scrivere nulla.
- Fino a 20 toolkit per agente, ticket, passaggio, progetto o cartella, e 200 per account.
- Un agente in esecuzione su una macchina remota via SSH riceve le skill del toolkit, ma non i suoi server MCP.
Domande frequenti
Che cos'è l'harness engineering?
È la pratica di modellare l'ambiente di un agente di coding, non solo il suo prompt: le istruzioni che carica, gli strumenti e i server MCP che può chiamare, la conoscenza che legge e scrive. AgentsRoom espone questi elementi come tre controlli (persona, toolkit, memoria) che imposti per agente e per attività.
Posso riusare le stesse skill e gli stessi server MCP su più agenti?
Sì. Mettili in un toolkit e associalo a ogni agente, oppure al progetto o alla cartella perché ogni agente lì dentro lo riceva. Modificare il toolkit li aggiorna tutti al prossimo avvio.
Un singolo ticket può ricevere un server MCP che il suo agente non ha?
Sì. Associa un toolkit al ticket. L'esecuzione lo riceve in aggiunta ai toolkit propri dell'agente, e la configurazione salvata dell'agente non cambia.
Come impedisco a un agente di scrivere nella memoria del progetto senza perdere la sua persona?
Imposta la sua Memoria del progetto su Sola lettura, oppure su Disattivata per nascondere del tutto la memoria. La persona e gli strumenti restano come sono. Puoi anche impostarla per un solo ticket.
Funziona con Codex e le altre CLI di agente, o solo con Claude Code?
Con ogni CLI di agente che AgentsRoom avvia. Le skill arrivano come testo ovunque e come skill native su Claude Code e Antigravity, i server MCP vengono scritti nel formato di configurazione proprio di ogni CLI, e connessioni e variabili seguono l'agente qualunque sia la sua CLI.
Dove vengono conservati i miei token?
Mai nel toolkit stesso. Un toolkit contiene riferimenti {{secret:NAME}} al Gestore di segreti, e il valore viene risolto sul tuo computer quando l'agente parte.
I miei agenti possono creare toolkit per me?
Sì, quando glielo chiedi. Gli strumenti di AgentsRoom includono toolkits_list, toolkits_get, toolkits_save e toolkits_delete, e agents_save, i ticket del backlog, i passaggi del team e le impostazioni di progetto o di cartella accettano una lista di toolkit. Agli agenti viene detto di non crearne mai uno per darsi un accesso.
Potrebbe interessarti anche
Workflow Multi-Agente : Handoff : Feedback Loop
AgentsRoom Agent Teams concatena agenti di codice IA come un vero team di ingegneria. Editor visuale di workflow (canvas in stile n8n) per collegare i ruoli Dev, QA, PM, Security e DevOps. Handoff automatico con riepilogo, diff git, rischi e suggerimenti di test. Quality gate verificati dalla macchina (decide la tua suite di test, non l'agente), rami di revisione QA e Security in parallelo, collegamenti condizionali, cicli di feedback, tetto max-cycles. Scegli per ogni team come girano i ruoli: un agente che fa morph da un ruolo all'altro e tiene tutto il contesto, oppure un agente vivo per ruolo, che si scrivono in tempo reale. L'orchestratore multi-agente che mancava ai tuoi agenti, su Claude, Codex, GitHub Copilot CLI, Cursor e altre 13 CLI di agenti.
Server MCP
Dichiara un server MCP una sola volta e dallo a Claude Code, Codex e ogni CLI di agente. Sceglilo dal registro MCP ufficiale, tieni le chiavi nel Gestore di segreti e accedi ai server OAuth come Notion o Linear con un solo pulsante Collega.
Project Memory
Dai ai tuoi agenti di codifica AI una memoria a lungo termine. Decisioni, architettura e insidie persistono attraverso le sessioni e sono condivise con tutti nel progetto. Gratuito, illimitato.
Personalizza gli Agenti
Scegli tra 14 ruoli di agente predefiniti, aggiungi agenti specialisti da The Agency, o costruisci il tuo agente AI di codifica personalizzato con il proprio prompt di sistema. Poi condividi i tuoi agenti con il tuo team attraverso la chat e pubblicali nella comunità affinché tutti possano crescere insieme.
Gestore di segreti
Conserva chiavi API, token e password nel portachiavi del tuo sistema operativo, richiamali come {ref} nei comandi di sviluppo e negli ambienti degli agenti, e lascia che AgentsRoom li risolva all'avvio. Gli agenti vedono i nomi, mai i valori, e nulla viene mai sincronizzato su un server.
Equipaggia i tuoi agenti una volta sola
Gratis su macOS, Windows e Linux, con l'app mobile per gestire i toolkit dal telefono.
App companion: monitora i tuoi agenti in movimento
Usa Claude, Codex, Antigravity CLI o un altro provider IA.
Invia bug e richieste direttamente nel tuo backlog pubblico.