Itaca

Il problema

Ogni volta che cambiavo progetto, l'agente passava i primi dieci minuti a ricostruire il contesto: che repo è, su cosa gira, dove eravamo rimasti. Le informazioni c'erano già, sparse tra file di pacchetto, configurazioni e la mia testa. Le dashboard dei progetti non funzionano mai, perché nessuno le aggiorna.

Come funziona

Una scansione trova tutti i progetti nelle tue cartelle e riconosce i servizi con piccole regole scritte in YAML, un file per servizio, una decina di righe ciascuno. Tutto quello che si può ricavare dal codice viene ricalcolato a ogni scansione, quindi non può invecchiare. A mano si scrive solo la parte narrativa: cosa sta succedendo e cosa viene dopo, in un file dentro il repo.

Un solo comando lo installa in Claude Code: un hook che mette un breve briefing nel contesto quando parte una sessione, e un altro che chiede all'agente di aggiornare lo stato quando ci sono commit nuovi dall'ultimo aggiornamento.

Piccolo apposta

I file di contesto generati in automatico tendono a peggiorare gli agenti, non a migliorarli, quindi il server MCP espone tre tool e ogni output ha un limite di token. Il briefing resta sotto le 40 righe e la CI fallisce se cresce.

I valori nei file .env servono solo a riconoscere i servizi e non vengono mai stampati. Un test con valori sentinella lo garantisce.