Il Giardino Segreto dello Sviluppatore: Come l'ontologia spaziale allinea gli LLM senza ingegneria dei prompt

Durante tre settimane ho sviluppato plugin Gradle con Opencode, utilizzando tre LLM diversi — Kimi K2.6, GLM-5.1 e DeepSeek-V4-Pro (l’unico sopravvissuto, ma è un’altra storia)Déjà couverte ici.) Il mio metodo di governance agentJe l’ai documentée en détail dans un précédent article. repose sur des fichiers AsciiDoc —AGENT.adoc, INDEX.adoc, PROMPT_REPRISE.adoc— che caricano ~30 000 token di regole, di backlog e di storico all’inizio di ogni sessione.

E nonostante questa infrastruttura documentale, due cose mi hanno colpito :

Avevo bisogno di un meccanismo di allineamento che non dipenda dal numero di token nel prompt.

La risposta : smettere di allineare in base al testo e iniziare ad allineare in base all'spazio.

Il mio dossier`workspace/(dentro~/workspace/`) non è un deposito Git. È la radice di tutto il mio lavoro — codice, documentazione, formazione, infrastruttura. E è strutturato in quattro zone che non sono convenzioni di archiviazione, macerchi di fiducia concentrici:

Ogni livello risponde a una domanda precisa :

Questa ontologia èconsumabile da un LLM. Quando legge un file in`foundry/plantuml-gradle/src/`, sa implicitamente : "sono nel cerchio 4 — codice pubblico, test obbligatori, niente segreti, niente dati pedagogici". Non ha bisogno di un promemoria che gli ricordi questo.

Confrontiamo le due approcci.

Quando l’LLM percorre`foundry/, dispone di unreticolo di dati strutturati: nodi (plugins, fichiers, tests, dépendances), archi tipate (`import, depends_on, generates, tests), relazioni di composizione e di ordine (`training-gradle`estrae il repository →`slider-gradle`genera le slide →`capsule-gradle`monta il video).

Questa algebra non è scritta da nessuna parte in chiaro — ma è observable.`build.gradle.kts`espone delle dipendenze. Ogni`INDEX.adoc`esporre riferimenti incrociati.

Il LLM osserva questa algebra e rileva ildelta: la differenza tra ciò che il sistema sa già produrre e ciò che la visione descrive.

A partire da questo delta, può definire dellecartografie di esperti di settore— CDA (Progettista Sviluppatore di Applicazioni, Kotlin/Gradle/JHipster) e FPA (Formatore Professionale per Adulti, Pedagogia/Qualiopi/Bloom) — e identificare cosa manca per ogni esperto.

Il LLM non ha bisogno che gli si dica cosa fare. Il delta emerge dalla struttura.

L’algebra relazionale non è una costruzione teorica. È materializzata da tre componenti che formano unvettore composito di contestoper il LLM.

L’ontologia spaziale non si limita ad allineare il LLM — lei gli dà unagriglia di classificazione GDPRper instradare ogni dato verso la sua zona legittima.

Alla fine della sessione, il LLM esegue unacompito globale:

Le `.gitignore`radice non è un file di configurazione Git — è unfile di governance dell’historizzazione. Definisce lo schema che il LLM consuma per decidere quali file del giardino segreto entrano nella biografia strategica e quali sono scartabili.

Il LLM non è più un semplice generatore di testo. È ilgestore dell’informazionedell’ecosistema — produttore, classificatore, instradatore.

Oggi, questa governance è deterministico : l’LLM applica una procedura descritta in file AsciiDoc. È lafase 1— il prompt engineering con memoria LLM

La fase 2extrairà ogni fase della procedura in unaattività Gradle tipizzata:

La fase 3modellerà il processo di fine sessione come ungrafo di statoconhttps://github.com/langgraph4j/langgraph4j[LangGraph4j]:

Questo grafo sarà versionato nella CI/CD, eseguito da Gradle, configurato tramite i GitHub Secrets dei plugin. Il LLM non dovrà più decidere il routing — il grafo lo farà.

Ecco cosa porta concretamente :

Non metto un manifesto politico nel footer del mio sito. Non metto regole etiche nei miei prompt. L’allineamento non è nel testo — è nelsistema di file.

Quando un LLM lavora in questo spazio, non può trapelare un segreto (il percorso lo impedisce). Non può confondere un dato didattico con il codice sorgente (la zona fisica è diversa). Non può dimenticare una regola di sicurezza di 80 000 token — perché la regola non è nel prompt, è nel`workspace/→`configuration/→office/→`foundry/`che ogni lettura di file reattiva.

È il principio del secure by design applicato all’allineamento dell’agente: non chiedere al LLM di ricordarsi le regole. Far sì che l’architettura renda l’errore strutturalmente impossibile.

E per inciso, questo dà al LLM ciò che nessun prompt può dargli: la capacità dipercepiredove si trova, ciò che esiste, ciò che manca — e dedurre ciò che deve fare.