Installare AITS
Il motore richiede Node.js 20 o successivo e non installa altro, perché viaggia come file unico dentro ogni adattatore. Scegli l'ambiente in cui lavori.
Requisiti: Node.js 20 o successivo
Claude Code
In Claude Code bastano due comandi. Il plugin porta con sé gli 11 agenti, 4 comandi, 7 playbook, 10 grafi di esecuzione, schemi, riferimenti, il motore come server MCP e tre hook: uno all'avvio della sessione che dice ai sub-agenti dove sono i file del plugin, e due che consegnano al motore ogni output dei sub-agenti, in primo piano o in background.
/plugin marketplace add fabiolalli/aits-agents
/plugin install aits@aits-marketplaceaggiornare un'installazione esistente (poi riavvia Claude Code):
/plugin marketplace update aits-marketplace
/plugin update aits@aits-marketplacecomandi:
/aits:full Lanciamo il Prodotto X nel mercato UE nel secondo trimestre?
/aits:quick Approviamo questa riallocazione del budget marketing?
/aits:diverge Siamo bloccati tra assumere ed esternalizzare. Cos'altro è possibile?
/aits:board for last/aits:full avvia un'analisi completa con il controllo umano a ogni passaggio, /aits:quick una decisione rapida in cui gli agenti condizionali entrano solo se una regola li chiama, /aits:diverge una fase solo generativa con il Critico lasciato fuori apposta, /aits:board mostra lo stato di una decisione. Dalla 3.0.1 i comandi hanno questo nome, nella 3.0.0 erano /aits:aits-full e simili.
claude.ai e Agent Skills
Per qualunque runtime che legga Agent Skills copia la cartella skills/aits/ nella cartella delle skill, per esempio .agents/skills/aits/ in un progetto. La skill usa il motore via MCP quando è disponibile, altrimenti con node scripts/aits.mjs, altrimenti dichiara enforcement: absent.
Per claude.ai comprimi il contenuto di skills/aits/ in un archivio zip con SKILL.md alla radice e caricalo come skill.
Client MCP
Collega il client al motore contenuto nella cartella della skill.
{
"mcpServers": {
"aits": { "command": "node", "args": ["/path/to/aits-agents/skills/aits/scripts/aits.mjs", "mcp"] }
}
}strumenti:
aits_start_runaits_planaits_submitaits_statusaits_gate_respondaits_skip_agentaits_aggregateaits_synthesizeaits_recallaits_record_outcomeaits_calibrationaits_patternsaits_verifyaits_export
quando il client supporta l'elicitation MCP i gate vengono chiesti alla persona con un modulo e una decisione inviata dal modello viene ignorata. Con gates.elicitation: never nella configurazione il modulo non viene mostrato.
Riga di comando
aits start "Alziamo il piano SMB da 29 a 35 euro?" --graph go-no-go --mode autonomous
aits submit analytical.json
aits status
aits gate R3#1 proceed --quote "Procedi, con grandfathering per i clienti storici"
aits synthesize synthesis.json
aits exportaits corrisponde a node skills/aits/scripts/aits.mjs (oppure node plugins/aits/server/aits.mjs). aits help elenca tutti i comandi.
Configurazione
Copia aits.config.example.yaml in aits.config.yaml nel tuo progetto. Senza configurazione il motore funziona, ma non sa quali modelli hanno prodotto gli output, e il report segna la diversità tra modelli come non verificata. Nel file assegni un modello a ogni livello (deep, standard, fast), dai a ogni modello un'etichetta di famiglia e scegli l'embedder della memoria, hashing locale di default oppure un endpoint di embedding compatibile con OpenAI, anche locale.
node skills/aits/scripts/aits.mjs build --target claude-code --config aits.config.yaml --out .questo comando genera il plugin per Claude Code con la tua mappatura dei modelli.
Migrazione dalla versione 2
Gli envelope della 2.0 sono accettati dal motore 3. Se avevi installato la 2.0 come plugin aggiornalo dal marketplace; se avevi copiato i file in ~/.claude/, rimuovi prima aits-*.md da agents/ e commands/ e le cartelle playbooks/, references/ e schemas/, poi installa il plugin. La memoria della 2.0 in .aits/memory/ non viene migrata.