Tutti gli articoli

    Nota di architettura

    29 marzo 2026di Gustavo Teixeira Cuco4 min di lettura

    Ingegneria del Contesto

    Contesto architetturale

    Metodo riutilizzabile

    Informazioni e contesto

    Applicato a

    Agents & SkillsTHE iCON
    Ingegneria del Contesto
    Vedi su LinkedIn

    Quello che chiamavo "documentazione" è, in realtà, il vero prodotto del mio lavoro con l'IA.

    Per mesi ho costruito file di contesto, strutturato repository con file CLAUDE.md, creato sistemi di memoria persistente per ogni progetto. Lo chiamavo "tenere le cose organizzate". Quello che in realtà stavo facendo era ingegneria del contesto — semplicemente non avevo un nome per questo.

    Tobi Lütke, CEO di Shopify, gli ha dato un nome a giugno 2025: "Mi piace molto di più il termine 'ingegneria del contesto' rispetto a ingegneria del prompt. Descrive meglio la competenza fondamentale: l'arte di fornire tutto il contesto necessario perché il compito sia plausibilmente risolvibile dall'LLM." Andrej Karpathy ha affinato la definizione: "l'ingegneria del contesto è l'arte e la scienza delicate di riempire la finestra di contesto con esattamente le informazioni giuste per il passo successivo."

    Non si tratta del prompt perfetto. Si tratta di cosa c'è nella finestra di contesto nel momento in cui il modello deve agire.

    Cosa è cambiato — e perché adesso

    L'ingegneria del prompt aveva senso nel 2022–2023. Era la competenza di formulare la domanda giusta. Funzionava per compiti isolati. Ma quando i team sono passati dalle demo ai sistemi in produzione — agenti, flussi di lavoro multi-step, memoria persistente — il prompt ha smesso di essere il collo di bottiglia.

    La maggior parte dei fallimenti negli agenti in produzione non sono fallimenti del modello. Sono fallimenti di contesto. Poco contesto e il modello allucina. Troppo, o mal strutturato, e perde il filo. Il punto ottimale non è banale — e non si risolve con una formulazione migliore.

    Se l'ingegneria del prompt era trovare la frase magica, l'ingegneria del contesto è scrivere l'intera sceneggiatura.

    Come si presenta, in pratica, una vera architettura di contesto

    Il cambiamento diventa concreto quando si osserva come sono realmente strutturati i sistemi di IA ben governati. Una configurazione pronta per la produzione non si basa su un unico file di istruzioni. Distribuisce il contesto su più livelli: un prompt di sistema che definisce comportamento e barriere di sicurezza; documentazione modulare che copre contesto di business, architettura, regole di design e stato di esecuzione; una matrice di trigger che associa ogni tipo di modifica al documento esatto che deve essere aggiornato; e un registro delle decisioni che preserva il ragionamento dietro scelte non ovvie.

    Ogni livello risponde a una domanda diversa che il modello potrebbe avere. Insieme, eliminano la necessità di rispiegare il sistema a ogni compito.

    Questo non è documentazione. È infrastruttura.

    La domanda che conta davvero

    Negli ambienti aziendali, questo non è solo un problema di design. È anche un problema di governance: chi possiede il contesto, chi lo aggiorna e chi è responsabile quando va fuori sincrono?

    Se stai costruendo con l'IA in produzione, la domanda non è più "quale modello dovremmo usare?". È "cosa entra nel contesto, in che ordine, e chi è responsabile di mantenerlo aggiornato?".

    L'ingegneria del contesto è la risposta a questa domanda. E, come ogni buona ingegneria, inizia con chiarezza sul problema — non con parole magiche.

    Come stai gestendo il contesto persistente nei tuoi sistemi? Lascia un commento.

    Fonti