Aristidis Vasilopoulos presenta un'infrastruttura di contesto codificato sviluppata durante la costruzione di un sistema distribuito C# di 108.000 righe, affrontando un problema fondamentale: gli agenti LLM non dispongono di memoria persistente tra le sessioni, perdendo la coerenza del progetto e ripetendo gli stessi errori.
L'architettura è organizzata in tre livelli. Il Livello 1 (Constitution) è un singolo file Markdown di 660 righe, sempre caricato in memoria, che codifica convenzioni, pattern, modalità di fallimento e tabelle di instradamento verso agenti specializzati. Il Livello 2 comprende 19 agenti specializzati (9.300 righe) che fungono da meccanismi di priming di dominio — più della metà del loro contenuto consiste in fatti relativi al codebase piuttosto che in istruzioni comportamentali. Il Livello 3 è una base di conoscenza di 34 documenti (16.250 righe) recuperata su richiesta tramite un server MCP (Model Context Protocol).
La valutazione quantitativa copre 283 sessioni in 70 giorni, 2.801 prompt umani che generano 1.197 invocazioni di agenti e 16.522 turni autonomi. L'infrastruttura di contesto rappresenta il 24,2% della documentazione totale. L'87% delle sessioni è ad-hoc e il 13% strutturato (plan-execute-review). Oltre l'80% dei prompt è inferiore a 100 parole, a dimostrazione che un contesto precaricato riduce considerevolmente la necessità di spiegazioni.
Quattro casi di studio osservazionali illustrano il valore del sistema. Una specifica di backup di 283 righe, referenziata in 74 sessioni, non ha prodotto alcun bug di corruzione. La documentazione dei pattern di sincronizzazione dell'interfaccia utente ha permesso il successo al primo tentativo sulla funzionalità successiva. La creazione di una specifica prima di un refactoring del sistema di drop ha accelerato decine di interazioni successive. Un agente di rete di 915 righe ha identificato tre bug di sincronizzazione sottili che avevano resistito a cinque tentativi precedenti.
L'autore propone sei linee guida: una constitution di base fornisce benefici immediati; gli agenti di pianificazione dovrebbero far emergere automaticamente le specifiche necessarie; le tabelle di instradamento sostituiscono la memoria umana; le spiegazioni ripetute segnalano la necessità di creare una specifica; gli agenti specializzati sbloccano le sessioni in stallo; e le specifiche obsolete costituiscono la principale modalità di fallimento.
Il costo di manutenzione è stimato in 1-2 ore a settimana. L'articolo dimostra che la conoscenza documentata si compone: ogni sottosistema documentato accelera sia le proprie future modifiche sia ogni funzionalità adiacente che ne dipende. L'autore riconosce i limiti (singolo sviluppatore, osservazionale) ma fornisce una delle valutazioni quantitative più dettagliate sullo sviluppo assistito da agenti IA su un progetto reale e complesso.