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
Strumenti: pack, search, open, capture, verify, archive, restore, remove, guard, xray. Ciò 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 solo binario da ~12 MB
Un singolo binario Go statico (immagine Docker scratch) che è allo stesso tempo visualizzatore web, server MCP e CLI. Il nucleo è deterministico al 100%; collegare un modello è opzionale e non lo tocca mai.