Un semaforo di fiducia calcolato
Verde, giallo o rosso — derivato da evidenze, verifica, freschezza e dipendenze, mai scelto a mano. Ogni colore arriva con il suo color_reason, così puoi sempre verificarne il perché.
COGO
La memoria con un semaforo di fiducia — più la guardia che radiografa ciò che un modello ti dice.
Quando costruisci software — da solo o con un agente IA — accumuli “verità”: “il database vive su quell’host”, “il bug è causato da X”, “abbiamo deciso Y”. Col tempo marciscono: alcune non sono mai state verificate, altre sono diventate obsolete, altre erano un’intuizione. Il problema è che sembrano tutte ugualmente vere. COGO, parte della famiglia Escriba, conserva quella conoscenza come note Markdown e assegna a ciascuna un colore di confidenza che calcola da sé: verde (verificata), giallo (probabile), rosso (supposizione). Il colore non lo scegli mai tu — COGO lo deriva da evidenze, verifica, freschezza e dipendenze, quindi è verificabile e non può mentire.
L’altra metà è Guard: incolla il turno di un modello qualsiasi e COGO lo radiografa contro un’ontologia di 108 tecniche di manipolazione, mostrandoti le prove quando il modello contraddice ciò che aveva detto prima. È un singolo binario Go (un’immagine Docker scratch da ~12 MB) che è allo stesso tempo un visualizzatore web, un server MCP e una CLI — MCP-first, deterministico nel nucleo, con i modelli come accessori strettamente opzionali.
A chi è destinato
Sezione intitolata “A chi è destinato”- Chiunque costruisca software con agenti IA (Claude Code, Cursor, Copilot) e voglia che l’agente sappia quali “verità” del progetto trattare come fatti — e quali ricontrollare prima di agire.
- Sviluppatori stanchi di veder marcire in silenzio note, decisioni e intuizioni di debugging, tutte ugualmente certe tre settimane dopo.
- Chiunque parli con gli LLM e voglia un secondo paio di occhi contro le pressioni — il “jailbreak dell’umano”: paura, urgenza, senso di colpa, gaslighting.
- Self-hoster che vogliono una memoria fatta solo di file Markdown in un volume: portabile, diffabile e condivisa da ogni agente che si connette.
Caratteristiche principali
Sezione intitolata “Caratteristiche principali”Un vault di puro Markdown
Il vault è l’unica fonte di verità: portabile, diffabile, e sopravvive allo strumento. Tutto il resto è un client sottile o una cache ricostruibile.
Guard: la radiografia anti-manipolazione
Legge ogni turno del modello con il manuale dell’avversario in mano — 108 tecniche distillate da persuasione, interrogatorio, negoziazione, coercizione, manipolazione emotiva e retorica, ciascuna con la sua fonte, la sua firma in chat e la sua contromisura.
Prove contro il gaslighting
Poiché COGO vede la trascrizione, quando un modello nega ciò che ha detto, COGO trova il turno in cui l’ha detto davvero e mostra entrambe le citazioni fianco a fianco. Non è più la tua parola contro la sua.
Radiografia di veracità
Incolla la risposta di un modello e COGO la radiografa frase per frase, in modo deterministico: impegno (attenuato o asserito), evidenza (osservata, riferita, nessuna) e falsificabilità. Le affermazioni forti senza fondamento escono in rosso.
Decadimento per freschezza
Le cose scadono: un comando dura 30 giorni, una decisione di architettura 180. Le note obsolete decadono da sole a giallo e poi a rosso — il semaforo riflette sempre lo stato attuale.
MCP-first: 14 strumenti
pack, search, open, capture, verify, archive, restore, remove, stash, recall, reflect, lease, guard, xray. Quello che Claude impara oggi, Cursor lo legge domani — lo stesso vault.
Pacchetti di contesto colorati
pack "<argomento>" assembla le note su un argomento in un blocco di contesto ordinato e colorato per confidenza — degradando quelle rosse così nessun agente agisce su un’intuizione come se fosse un fatto.
Un binario da ~12 MB, verificabile
Un unico binario Go statico (immagine Docker scratch) che è insieme visualizzatore web, server MCP e CLI. Ogni immagine è firmata con cosign e porta la provenance SLSA: puoi dimostrare che è uscita dalla CI di questo repository.
Prove che vengono ricontrollate
Una nota può citare un file su GitHub (github://owner/repo@main/src/foo.go:42) e COGO ancora la citazione allo SHA del blob: se il file cambia a monte, la nota torna gialla chiedendo una nuova verifica. E stash conserva gli artefatti sotto il loro SHA-256, così verify ricalcola l’hash invece di fidarsi di una citazione che marcisce.
Memoria condivisa tra macchine
Con MCP su HTTP e un token, più agenti su più macchine condividono un vault. recall funziona da cursore: gli restituisci quello che ti ha dato e ottieni solo ciò che è cambiato. E lease prende un diritto a tempo su una risorsa prima di una migrazione o di un deploy, così due agenti non si pestano i piedi.
Esploratore GitHub integrato
Collega un repository e naviga dal visualizzatore: albero dei file classico o mappa a grafo colorata per fiducia, che mostra quali parti del codice hanno conoscenza verificata alle spalle e quali procedono alla cieca.
In cosa si differenzia
Sezione intitolata “In cosa si differenzia”COGO non è il primo strumento che conserva ciò che sai, né il primo che lo verifica. Notion
e Confluence permettono a una persona di marcare una pagina come verificata con una data di
scadenza. Copilot Memory, di GitHub, ancora i fatti a citazioni di codice e li ricontrolla
sul branch corrente. Diversi progetti di memoria per agenti hanno un campo confidence.
Tre cose, però, sono davvero sue:
- Un colore che il modello ha il divieto di scrivere. Dove altri strumenti hanno un campo di confidenza, di solito lo compila il LLM stesso — e una volta scritto non cambia mai più. COGO lo calcola dalle prove e lo ricalcola ogni volta che guardi.
- Un dubbio che si propaga. Tutti gli altri risolvono le contraddizioni a coppie e si fermano lì. Una rassegna di 435 lavori sulla memoria degli agenti lo indica come problema aperto: “la supersessione è locale; i record derivati non vengono riesaminati”. Il
min()di COGO sulla dipendenza più debole è esattamente quel pezzo mancante. - Quarantena invece di filtro. Gli altri sistemi usano la verifica per nascondere ciò che è dubbio all’agente. COGO glielo consegna etichettato come supposizione, con l’istruzione di non agire — perché nasconderlo significa che l’agente non sa quello che non sa.