Un ecosistema AI personale che governa processi reali: ogni agente ha un ruolo definito, ogni dato una sola fonte di verità, ogni decisione un controllo umano. Questa pagina spiega il metodo prima dei progetti.
v5.2 — 30 Giugno 2026 — metodo, governance a gate, runtime HERMES, ambiente APP-FORGEGEKO non è un software, né un chatbot, né un'automazione. È un modo di lavorare: un'organizzazione in cui ogni agente AI ha una responsabilità precisa, ogni dato una collocazione stabile, e ogni processo è tracciabile e riproducibile.
Nasce dall'esigenza concreta di gestire una complessità che nessuno strumento singolo poteva coprire. Dimostra che l'AI multi-agentica non è una promessa futura: è operativa oggi, a condizione di orchestrarla con metodo.
L'elemento distintivo non è la tecnologia, ma la disciplina: 35 anti-pattern derivati da errori reali, una governance su tre livelli, una pianificazione a gate, e un livello di monitoraggio che misura la salute del sistema in modo continuo.
Il valore dell'ecosistema non è l'elenco dei progetti, ma il modo in cui vengono prodotti. Cinque funzioni distinte lavorano in parallelo, ciascuna con un compito che le altre non svolgono. È questa divisione del lavoro, unita alla governance a gate, che consente a una struttura ridotta di operare con la capacità di un team tecnico.
I modelli generano, ragionano, scrivono ed eseguono codice. Sono la capacità produttiva di base, che il metodo organizza e indirizza.
Opera direttamente sul campo: gestisce i file, interroga il database, pubblica le pagine, esegue. Trasforma le decisioni in risultati concreti.
Definisce l'architettura prima dell'esecuzione e valida i risultati dopo. È il secondo parere che approva i passaggi sui lavori a rischio elevato.
Il front-end conversazionale. Un unico assistente con sette personalità per dominio, ciascuna con accesso ai soli dati di sua competenza.
Nessun lavoro strutturale si chiude senza approvazione umana. Il controllo finale resta sempre a una persona, che fa da arbitro tra gli attori.
Non tutti i lavori richiedono lo stesso livello di controllo. Ogni attività, in apertura, viene classificata con una matrice deterministica a sei criteri: più criteri risultano veri, maggiore è il controllo richiesto. Questo evita sia l'esecuzione affrettata sui lavori delicati, sia procedure inutili su quelli semplici.
| Modalità | Soglia | Processo |
|---|---|---|
| SOLO | 0 criteri | Esecuzione diretta con conferma umana e log standard. L'Orchestrator non interviene. |
| DUO-GATE | 1–2 criteri | Esecuzione seguita da un report strutturato, che l'Orchestrator esamina in revisione asincrona. Secondo parere senza blocco. |
| TRIO-GATE | ≥3 criteri | Pipeline sincrona completa a sei gate: design e validazione dell'Orchestrator, esecuzione, approvazione umana a ogni passaggio. |
I sei criteri di classificazione:
La pipeline TRIO-GATE — sei passaggi, dalla raccolta del contesto alla chiusura approvata:
Sopra il metodo opera GEKO OPS, il livello che governa e misura. Non costruisce: osserva. SENTINEL verifica il rispetto delle regole da parte degli agenti, PULSE esegue il controllo quotidiano dell'infrastruttura, COMPASS misura la salute evolutiva dei progetti, TELEMETRY intercetta gli errori a runtime. È ciò che distingue un sistema che funziona da un sistema che funziona, è verificato, e lo dimostra con dati.
A gennaio 2026 GEKO nasce con OpenClaw, un runtime multi-agente basato su Node.js, Docker e un workspace di file Markdown. Permette di costruire le fondamenta — bot Telegram, fallback tra modelli, routing dei topic — ma con la crescita del sistema i limiti diventano strutturali.
A marzo 2026 arriva la decisione più impegnativa del progetto: smantellare il componente centrale e ricostruirlo da zero. Non un cambio di tecnologia, ma di paradigma: da monolite che gestisce tutto a un insieme di servizi specializzati, ciascuno con la propria responsabilità.
Un unico processo Node.js in container Docker gestiva bot, routing dei modelli, workspace ed esecuzione degli strumenti.
PYBOT come engine TRANSIT, HERMES come runtime conversazionale, Supabase come fonte di verità unica: ogni componente con un confine chiaro.
La transizione ha richiesto la rimozione definitiva del container OpenClaw, la riscrittura completa del workflow TRANSIT e un nuovo layer di orchestrazione. Il risultato: un sistema in cui aggiungere un servizio significa aggiungere un componente, non riscrivere il nucleo.
Il front-end agentico dialoga con gli utenti, gli engine specializzati eseguono, il core mantiene la verità dei dati, il livello operativo monitora. Tutto sotto la stessa governance.
Runtime agentico primario sul nodo pubblico (Hermes Agent CLI, Nous Research). Un unico bot Telegram con sette personalità per topic (ADMIN, DUCATO, TRANSIT, DOMUS, ORION, HOME, GENERAL), provider xAI Grok. Dal maggio 2026 ha sostituito OpenClaw sul supergruppo operativo.
Il motore di TRANSIT: servizio FastAPI nativo su VIPER, gateway dati singleton con validazione di contratto, webhook modulare, classificazione dell'intento via modello, osservabilità integrata.
Assistente RAG agentico che interroga la wiki operativa e la memoria decisionale con sintesi cross-documento. Sotto, la Knowledge Membrane deriva un grafo (geko_graph) che collega i fatti: può proporre arricchimenti al corpus, mai scriverli direttamente, sempre con conferma umana.
I tre operatori del metodo. Claude Code: accesso diretto ai server, script, deploy. Cowork: operatività su desktop, gestione file, database, pubblicazione pagine. Orchestrator (ChatGPT): design, validazione, gate. Protocollo a tre parti: nessuna esecuzione senza validazione sui lavori a rischio.
Layer di orchestrazione bidirezionale tra ChatGPT (design e strategia) e Claude (esecuzione e verifica). Backend FastAPI sul nodo pubblico, Custom GPT Actions, endpoint di contesto, dashboard con workflow di approvazione.
Scheduler centralizzato: 16 attività programmate su due nodi (5 sul nodo pubblico, 11 su VIPER), inclusi i job DISPATCH, le verifiche di compliance e i report automatici.
Database PostgreSQL centralizzato: oltre 500 funzioni RPC, multi-schema, wiki operativa, tabelle di compliance, memoria semantica vettoriale, meta-governance COMPASS. La fonte di verità condivisa da tutti gli agenti.
Due nodi complementari: il nodo pubblico (pagine web, orchestrazione, HERMES, reverse proxy) e VIPER, nodo privato (PYBOT, CHRONOS, calcolo). Connessi via VPN, coordinati da Supabase. In arrivo il nodo MAMBA come hub AI dedicato.
Il livello che governa e misura. SENTINEL: 139 regole di compliance su due agenti. PULSE: oltre 26 verifiche quotidiane con correzione automatica su tre livelli. COMPASS: meta-governance sulla salute evolutiva dei progetti. TELEMETRY: intelligence degli errori a runtime.
Antigravity entra nell'ecosistema come ambiente per lo sviluppo rapido di applicazioni, affiancando Cowork e Orchestrator. Nasce APP-FORGE-Workspace, l'ambiente operativo dedicato alla produzione di app all'interno delle regole GEKO.
L'ecosistema non è un caso singolo, ma una famiglia di verticali che condividono metodo, infrastruttura e fonte di verità, pur affrontando problemi diversi. La finanza personale è uno dei domini, non l'intero perimetro.
Gestione trasporti per Alterini Bus. L'autista fotografa il foglio viaggio, il sistema lo interpreta (OCR e modello), poi dichiara partenza e chiusura in linguaggio naturale. Workflow stateless con fonte di verità unica, deduplicazione multi-tratta, multi-tenant.
Finanza personale a logica proattiva: cockpit con indice di salute, monitoraggio sostenibilità e abbonamenti, sincronizzazione PayPal, lettura scontrini via vision, divisione spese. In evoluzione verso una BI personale tramite il master container ARCH-DUCATO-002.
Market intelligence su titoli AI/tech: rilevazione di stati di opportunità su un universo di 16 titoli, tesi pre-registrate, trigger di invalidazione, paper-trading in modalità shadow. Nessun trading automatico, controllo umano su ogni decisione (conformità single-user).
Client strategy intelligence: tracciamento strategico dei clienti con modello cliente → progetto → fasi, mappa degli interlocutori, verbali, obiettivi con scadenze, offerte e strategia commerciale per ciascun cliente.
Domotica e casa intelligente su Home Assistant (nodo LIZARD). Controllo di luci, clima, sicurezza ed energia, scenari e automazioni, comandabili in linguaggio naturale tramite il topic DOMUS di HERMES e da dashboard Lovelace dedicate.
Container strategico per i progetti immobiliari e domestici: ristrutturazione, ricettività, efficientamento energetico. Non le spese — gestite da DUCATO — ma le decisioni: cosa pianificare, con quale motivazione e quale impatto economico-fiscale su un orizzonte di 5–15 anni, con tracciabilità delle alternative scartate.
Print farm 3D self-hosted (progetto 3D-001): quattro stampanti (Bambu P2S, A1, X1C e FLSun S1 Pro) gestite da un backend dedicato su VIPER, senza cloud. Coda di stampa, archivio dei modelli, gestione AMS, accesso esclusivamente via VPN.
Centrale operativa: dashboard partenze e rientri con stato in tempo reale, notifiche WhatsApp e Telegram, promemoria a T-30, alert ritardi, riconciliazione notturna.
Audit di compliance multi-agente: 139 regole monitorate (57 TRANSIT, 82 DUCATO), scheda di conformità per agente, governance esplicita.
Meta-governance dello sviluppo: scoring deterministico e advisory sulla salute evolutiva dei progetti. Schema dedicato (14 tabelle, 28 policy, 4 guardrail), pipeline a tre parti certificata.
Error intelligence per PYBOT e TRANSIT. Fase 1 in produzione con metriche di runtime. Fase 2: tracciamento strutturato delle eccezioni a cardinalità controllata, correlato alle finestre COMPASS.
Dashboard operativa multi-nodo con self-check: oltre 26 verifiche deterministiche su due nodi, monitoraggio dei backup, disaster recovery al 98%, correzione automatica su tre livelli.
Cabina di comando: stato progetti, log attività, telemetria, ledger, governance, agenti. Ogni indicatore con drill-down al dato sorgente.
Wiki operativa: tassonomia a 7 documenti per agente, ricerca full-text, sincronizzazione periodica. La base di conoscenza che alimenta ELYSIA.
Quattordici fasi, da un primo bot Telegram a un ecosistema che misura la propria salute e produce applicazioni con metodo.
Deploy di OpenClaw e infrastruttura: nodo pubblico, Docker, bot Telegram, primo workspace.
Anti-pattern, Golden Rules, protocollo di chiusura. La normativa interna del sistema: ogni errore diventa una regola.
TRANSIT e DUCATO, categorizzazione, fatturazione, payroll. Prima automazione end-to-end in produzione.
Passaggio a un database relazionale: da conoscenza informale a dati strutturati e centralizzati.
Più nodi di calcolo, cascade tra modelli, riduzione del contesto operativo.
Wiki operativa, tassonomia per agente, ricerca full-text, sincronizzazione periodica.
CORTEX, OPS, PULSE, SENTINEL: il sistema inizia a monitorarsi e correggersi.
OpenClaw dismesso. PYBOT diventa il nuovo core: FastAPI su VIPER, servizi Python modulari. Un passaggio irreversibile, senza rollback.
ORCHESTRATOR, CHRONOS, DUCATO-SMART, FLEET, DISPATCH. Il sistema passa da reattivo a proattivo.
Gateway dati a contratto, workflow stateless, framework GDPR, memoria semantica, disaster recovery al 98%. Da prototipo a piattaforma production-ready.
COMPASS osserva l'evoluzione dei progetti e misura la salute reale del sistema. Schema dedicato, pipeline a tre parti certificata.
Hermes Agent CLI diventa il runtime agentico primario: un bot, sette personalità per topic. OpenClaw viene rimosso dal supergruppo e resta come componente residuale.
ELYSIA interroga wiki e memoria decisionale; la Knowledge Membrane deriva un grafo che collega i fatti, con sola facoltà di proposta e conferma umana obbligatoria.
Nuovo ambiente operativo: Antigravity per lo sviluppo rapido di applicazioni, accanto a Cowork e Orchestrator. Con APP-FORGE-Workspace l'ecosistema aggiunge la capacità di produrre applicazioni complete dentro la stessa governance.
Tre punti d'ingresso con ruoli distinti: questa pagina è il riferimento sul metodo e l'architettura; HUB è il portale di navigazione rapida; VITRINA è la vetrina esterna orientata ai clienti.
Punto di lancio dell'ecosistema: indice dei servizi, stato live, glossario degli acronimi.
Vetrina pubblica orientata ai clienti: il metodo presentato come caso applicativo, senza dettagli infrastrutturali interni.
Runtime agentico primario: un bot Telegram con sette personalità per topic.
Assistente RAG agentico e Knowledge Membrane sopra la wiki operativa.
Dashboard principale: stato progetti, metriche in tempo reale, governance, drill-down.
Operativa multi-nodo: verifiche giornaliere, monitoraggio backup, correzione automatica.
Admin multi-tenant: autisti, flotta, contatti, location e centrale DISPATCH.
Ledger, cockpit finanziario e overview sulla sostenibilità.
Market intelligence su titoli AI/tech: viewer delle opportunità, paper-trading shadow, controllo umano.
Client strategy intelligence: interlocutori, verbali, obiettivi e offerte per cliente.
Print farm 3D self-hosted: quattro stampanti gestite senza cloud, accesso solo via VPN.
Dashboard di compliance: 139 regole monitorate su due agenti.
Dashboard ChatGPT ↔ Claude con workflow di approvazione a gate.
Wiki operativa: 243 documenti, ricerca full-text, tassonomia per agente.
Database PostgreSQL centralizzato: 500+ RPC, multi-schema, API in tempo reale. La fonte di verità.