Da un esperimento con un bot Telegram a un'architettura multi-agentica matura con meta-governance integrata: la storia di un ecosistema AI personale che ha avuto il coraggio di ripensarsi — e ora sa misurare la propria salute evolutiva.
v4.4 — 16 Aprile 2026 — COMPASS Meta-Governance + Schema DeployedGEKO non è un software. Non è un chatbot. Non è un'automazione.
È un modo di lavorare — dove ogni agente AI ha un ruolo specifico, ogni dato ha una casa, e ogni processo è tracciabile e riproducibile.
Nato dall'esigenza reale di un CTO con 25 anni di esperienza nel gestire complessità che nessun singolo strumento poteva affrontare, GEKO è la dimostrazione che l'AI multi-agentica non è il futuro: è il presente, se sai come orchestrarla.
Quello che distingue GEKO non è la tecnologia — è la disciplina. 35 anti-pattern nati da errori reali, un protocollo di governance a 3 livelli, un sistema che sa curarsi da solo e sa quando chiedere aiuto.
A Gennaio 2026, GEKO è nato con OpenClaw — un runtime multi-agente basato su Node.js, Docker, e un workspace di file Markdown. Ha funzionato. Ha permesso di costruire le fondamenta: Telegram bot, fallback LLM, topic routing. Ma con la crescita del sistema, i limiti sono diventati evidenti.
A Marzo 2026, dopo aver toccato con mano i limiti strutturali di OpenClaw — workspace monolitico che degradava le performance, conflitti di polling tra container, dipendenza da un framework opaco senza tag semantici per il versioning — abbiamo preso la decisione più coraggiosa del progetto: smantellare il cuore pulsante e ricostruirlo da zero.
Il risultato non è solo un cambio di tecnologia. È un cambio di paradigma: da un monolite containerizzato che cercava di fare tutto, a un ecosistema di servizi specializzati — ciascuno con il proprio linguaggio, le proprie regole, e la propria responsabilità.
OpenClaw 3.12 in container Docker: un unico processo Node.js che gestiva tutto — bot Telegram, LLM routing, workspace, tool execution.
exec (BUG-019)PYBOT v1.2: FastAPI service nativo su VIPER, SupabaseGateway singleton, webhook split modulare, intent classification via Gemini, deploy via systemd.
Il passaggio non è stato indolore. Ha richiesto lo smantellamento del container OpenClaw su VIPER (rimosso definitivamente il 18 Marzo 2026, docker rm, nessun rollback possibile), la riscrittura completa del workflow TRANSIT da zero in Python, e la creazione di un layer di orchestrazione completamente nuovo.
Ma i risultati parlano da soli: da un monolite con 32 file di workspace (386KB) che degradava ogni risposta del bot, a un servizio snello con architettura modulare, SupabaseGateway con contract validation, e webhook split (-42.9% codice). Da un sistema dove aggiungere un nuovo servizio significava modificare il cuore del container, a uno dove basta aggiungere un nuovo handler e registrare gli intent.
Il cuore del sistema. FastAPI service nativo su VIPER v1.2, con SupabaseGateway singleton (contract validation, 7 RPC schemas), webhook split modulare (handlers/), intent classification LLM-first, e GatewayMetrics observability. Tri-Bot polling: @GEKOViperBot + @GEKOsLinuxBOT + @GEKOTransitBot.
Layer di orchestrazione bidirezionale: ChatGPT per design e strategy, Claude per execution e verification. FastAPI backend su VPS con Custom GPT Actions, 6 context endpoints, dashboard Kanban.
Scheduler centralizzato: 16 task attivi (5 VPS + 11 VIPER), inclusi DISPATCH jobs (send_pending, reminders, overdue, reconcile), DUCATO compliance, e report automatici. Il metronomo dell'ecosistema.
Sistema di audit comportamentale multi-agente: 139 regole monitorate (57 TRANSIT + 82 DUCATO), compliance map v3.3, dashboard dedicata. L'agente che controlla gli altri agenti.
Sistema di meta-governance dello sviluppo: osserva come i progetti evolvono nel tempo e restituisce una lettura affidabile della loro salute reale. Motore deterministico di scoring, ingestion engine da fonti GEKO, anomaly detection, e advisory AI layer separato. Schema Postgres dedicato (14 tabelle, 28 RLS policies, 4 guardrail). La bussola dell'ecosistema.
Sistema di notifiche e monitoraggio operativo per Alterini Bus: invio programmi via WhatsApp/Telegram, conferma autisti, promemoria partenze T-30, alert rientri in ritardo, semafori live su dashboard dedicata. 4 CHRONOS job, 11 RPC Supabase, bridge automatico da alt_activities.
Memoria contestuale per agenti: embedding pgvector su VIPER, context injection hook per TRANSIT (live) e DUCATO (planned), ricerca semantica cross-sessione. La memoria a lungo termine dell'ecosistema.
Framework di conformità privacy per l'ecosistema: Data Processing Agreement, registro trattamenti, informative utenti, policy cancellazione. Il garante della privacy nel sistema.
Tre operatori AI con capacità distinte e contesto condiviso. Claude Code: accesso SSH diretto a VPS e VIPER, esecuzione script, code review, deploy, Supabase query — l'ingegnere con le chiavi di tutti i server. Cowork: Desktop Commander per SSH remoto, Supabase MCP diretto, gestione file Mac, creazione HTML, deploy pagine, task automation — l'operatore che vede il desktop e agisce. Orchestrator (ChatGPT): design architetturale, validazione strategica, governance GATE — l'architetto che disegna prima che si costruisca. Protocollo Tri-Party: design_first o context_first, mai esecuzione senza validazione.
Database PostgreSQL centralizzato con 500+ RPC functions, multi-schema (public + geko_orchestrator + compass + extensions), wiki operativa (243 docs), compliance tables (139 regole), pgvector per Semantic Memory, COMPASS meta-governance (14 tabelle). La fonte di verità assoluta.
Due nodi complementari: VPS pubblico (HTML, ORCHESTRATOR, Nginx) e VIPER privato (PYBOT, CHRONOS, GPU NVIDIA). Connessi via WireGuard VPN, coordinati via Supabase.
26+ check deterministici su 2 nodi (VPS + VIPER), governance auto-fix L1/L2/L3, backup monitoring (rsync + Borg + QNAP offsite), health score calibrato su incidenti reali. Il sistema che si cura da solo.
Gestione trasporti Alterini Bus: workflow stateless Supabase SSOT (ORCH-T041), dedup multi-tratta, multi-tenancy con 2 aziende, SupabaseGateway + webhook split, intent classification con Gemini.
Finanza personale AI-proattiva: cockpit finanziario con health score, overview sostenibilità, subscription monitor, PayPal API pipeline, receipt OCR via Gemini Vision, split condiviso.
Layer di orchestrazione ChatGPT ↔ Claude: Custom GPT con Actions HTTP verso FastAPI su VPS, 6 context endpoints, dashboard Kanban con approval workflow, 21 RPC su schema dedicato.
Sistema gestione flotta: precheck pre-partenza, registro incidenti (9 categorie, 4 gravità), manutenzione con link a incidenti, componenti soggetti a usura, 8 KPI aggregati. Phase 2 Admin UI + Phase 3 PYBOT integrati.
Centrale Operativa Alterini Bus: dashboard partenze/rientri con semafori live, notifiche WhatsApp (Whapi) + Telegram fallback, promemoria T-30, alert ritardi, reconciliazione notturna. Il ponte tra ufficio e autisti.
Dashboard principale: controllo centralizzato di tutti i progetti, metriche realtime da Supabase, versioning automatico, tab operative con drill-down.
Agent compliance audit multi-agente: 57 regole TRANSIT (56 ON, 1 partial) + 82 regole DUCATO (82 ON), dashboard v3.3 dedicata, ACC per ogni agente, governance L2 esplicita.
Meta-governance dello sviluppo: osservazione, scoring deterministico e advisory AI sulla salute evolutiva dei progetti. Schema Supabase dedicato con motore ibrido (determinismo + AI separata). Foundation + Naming + DDL Deploy completati.
compass su SupabaseDashboard operativa multi-nodo + PULSE self-check: 26+ check deterministici su 2 nodi, backup monitoring (rsync + Borg + QNAP offsite), DR-001 al 98%, governance L1/L2/L3.
Wiki operativa: tassonomia 7-doc per agente, full-text search italiano via wiki_search(), HYDRA 2.0 hydration su PYBOT/VIPER ogni 6h. La base di conoscenza strutturata dell'ecosistema.
Framework conformità privacy GDPR per l'ecosistema: DPA, registro trattamenti, informative utenti, policy cancellazione dati. Priorità critica per operatività con dati autisti e finanziari.
Pipeline intelligente classificazione transazioni: scraping email, classification engine L0-L5 con merchant rules, batch processing, correlazione ordini con conferma umana.
Memoria semantica pgvector su VIPER: embedding contestuali, context injection hook per agenti, ricerca semantica cross-sessione. TRANSIT hook live, DUCATO hook planned.
Deploy OpenClaw & Infrastruttura. VPS pubblico, Docker, Telegram bot, primo workspace. Il seme di tutto.
Anti-pattern (21 regole iniziali), Golden Rules, Closure Protocol, SOUL.md. Definizione della "legge" del sistema — ogni errore diventa una regola.
TRANSIT, DUCATO, 414 categorie, fatture automatiche, payroll. Prima automazione end-to-end in produzione.
48 ore di migrazione verso Supabase. Apple Notes → Supabase, workspace ristrutturato, RPC centralizzate. Da conoscenza informale a dati strutturati.
VPS + VIPER + TAIPAN. OpenClaw 3.12, cascade LLM tri-provider, cross-topic fix, ARCH-001 lean context (-96% workspace).
243 documenti wiki, tassonomia 7-doc per agente, wiki_search() RPC, HYDRA 2.0 hydration ogni 6h. Conoscenza centralizzata e accessibile a tutti gli agenti.
CORTEX v2.18, OPS v2.0, PULSE 26 check, SENTINEL v2.0 con Compliance Map. Il sistema impara a monitorare e curare se stesso.
OpenClaw archiviato. PYBOT diventa il nuovo cuore: FastAPI su VIPER, servizi Python modulari, intent classification LLM-first. Il container Docker lascia il posto a un systemd service nativo. Un cambiamento coraggioso e irreversibile: docker rm, nessun rollback. Oggi PYBOT v1.2 con SupabaseGateway e webhook split.
ORCHESTRATOR layer (ChatGPT ↔ Claude), CHRONOS con 16 task automatici (5 VPS + 11 VIPER), DUCATO-SMART con PayPal API + Receipt OCR + Split, FLEET Intelligence, DISPATCH Centrale Operativa con WhatsApp e semafori live. Multi-tenancy TRANSIT con 2 aziende. L'ecosistema non è più solo reattivo: è proattivo.
SupabaseGateway con contract validation, webhook split (-42.9% codice), workflow stateless SSOT, dedup multi-tratta, GDPR Compliance framework, Semantic Memory pgvector, HYDRA 2.0 wiki hydration su PYBOT, SENTINEL multi-agente (139 regole), Disaster Recovery a 98% con 8 backup job. L'ecosistema si consolida: da prototipo funzionante a piattaforma production-ready.
COMPASS nasce come modulo di meta-governance: non controlla il runtime, ma osserva come i progetti evolvono e restituisce una lettura della salute reale dell'ecosistema. Schema Postgres dedicato su Supabase (14 tabelle, 28 RLS policies, 4 guardrail G1-G4), architettura a 5 componenti (Ingestion, Metrics, Anomaly, Dashboard, Advisory AI), 12 principi non negoziabili, pipeline Tri-Party certificata GATE-06 PASS. Supabase Federation (ORCH-T065) porta 15 tabelle da geko_openclaw a public. L'ecosistema ora non solo funziona: sa misurare se stesso.
Dashboard principale v2.18. Controllo centralizzato di tutti i progetti, metriche realtime.
Operativa multi-nodo con PULSE 26 check e version banner integrato.
Admin multi-tenant: autisti, flotta, contatti, locations, aziende. 5 tab.
Centrale Operativa: semafori partenze/rientri, notifiche WhatsApp, alert ritardi.
Ledger + Cockpit finanziario + Overview sostenibilità. 3 pagine.
Agent compliance dashboard v3.3. 139 regole (57 TRANSIT + 82 DUCATO) monitorate.
Dashboard Kanban orchestrazione ChatGPT ↔ Claude. Approval workflow.
Wiki operativa: 243 documenti, full-text search, tassonomia agenti.
Showcase architettura. Stack, decisioni di design, infrastruttura.
HUB portale ecosistema. Navigazione rapida a tutti i servizi.
Document intelligence. OCR multi-formato, classificazione AI.
Knowledge Wiki browser e PRAXIS taxonomy dashboard. Navigazione documentale strutturata.
Ecosystem Control Panel. Dashboard monitoraggio centralizzato GEKO.
Analisi architetturale periodica. Scorecard, raccomandazioni, trade-off.
Database PostgreSQL centralizzato. 500+ RPC, multi-schema (public + orchestrator + compass), pgvector, API realtime.