Come si usa

1. Scarica il pacchetto ambiente.
2. Scompatta lo zip nella cartella locale della pratica, cioè nella cartella che contiene già i documenti da lavorare.
3. Apri con l'agente IA la cartella della pratica, non la sola sottocartella AGENTE/.
4. Scrivi Inizia e lascia che l'agente faccia le prime domande operative.
5. L'agente chiederà autorizzazione prima di scandire la cartella e consenso esplicito prima di spostare, rinominare o riorganizzare file fuori da AGENTE/.

Cosa sono gli agenti IA

Un agente IA non è una semplice chat: è uno strumento capace di lavorare su una cartella di progetto, leggere file, creare appunti, aggiornare documenti e lasciare traccia del lavoro svolto. Esempi di ambienti utilizzabili sono Google Antigravity, OpenAI Codex, Claude Code, Gemini CLI o altri strumenti analoghi, purché siano in grado di operare sui file locali o su una cartella controllata dall'utente.

Il pacchetto non contiene un modello IA e non sceglie al posto tuo il fornitore: prepara la struttura, le istruzioni e le regole di lavoro per l'agente che deciderai di usare.

LLM Wiki e lavoro a più mani

Il metodo è basato sulla LLM Wiki: la memoria della pratica non rimane sepolta nella chat, ma viene scritta in una wiki locale dentro AGENTE/WIKI/. La wiki contiene log, stato del lavoro, indice file, fonti, questioni, contraddizioni, ricerche e collegamenti agli elaborati prodotti.

Questo permette anche l'avvicendamento tra agenti diversi. Un agente che arriva dopo legge la wiki, prende in consegna il lavoro precedente, firma il log, verifica ciò che eredita e prosegue. In pratica, la cartella conserva la memoria operativa della pratica anche quando cambia lo strumento IA utilizzato.

Struttura del progetto

• AGENTE/: area tecnica dell'agente; contiene regole, wiki, cache, ricerche, log e stato del lavoro.
• AGENTE/WIKI/indice_file.md: registro obbligatorio dei file della pratica, con SHA256, percorso, stato, descrizione e quadratura.
• BOZZE/: elaborati destinati all'utente, come lettere, memo, relazioni, cronologie, scalette e bozze di atti.
• NUOVI_DOCUMENTI/: inbox facoltativa per nuovi documenti da far ingerire dopo la prima organizzazione.
• DA_CLASSIFICARE/: parcheggio temporaneo e motivato per documenti non ancora collocabili.
• MODELLI_ESEMPI/: modelli, facsimili, esempi o materiali di supporto che non appartengono al fascicolo.
• 00 - .../, 01 - .../, 02 - .../: cartelle numerate della pratica, create o confermate secondo una logica procedurale-cronologica.

Cosa può fare l'agente

• Ricostruire di che pratica si tratta, quale ruolo hai e quali sono gli obiettivi immediati.
• Scandire la cartella pratica solo dopo autorizzazione e creare l'indice generale dei file con impronte SHA256.
• Proporre un riordino in cartelle numerate logico-cronologiche, spiegando per ogni file percorso attuale, nuovo percorso, motivo e grado di confidenza.
• Prima di modificare, spostare o rinominare file, proporre un backup ZIP visibile all'utente e ottenere consenso esplicito.
• Rinominare e ricollocare i file approvati, rifare la scansione e verificare che la quadratura dell'indice torni.
• Leggere i documenti centrali, creare pagine fonte, aggiornare la wiki e segnalare lacune, contraddizioni e documenti non ancora verificati.
• Preparare cronologie, memo, bozze, liste di criticità, distillati anonimizzati e query di ricerca giurisprudenziale.
• Chiudere ogni analisi con un rendiconto di verifica: cosa è stato letto, cosa resta da controllare e quali limiti ha il lavoro svolto.

Regole aggiornabili e modificabili

Le regole pubbliche dell'ambiente sono servite da regole-agente-generico/. Ad ogni nuovo avvio, se ha accesso alla rete, l'agente può controllare se Diritto Pratico ha pubblicato regole più recenti e proporti l'aggiornamento.

Gli aggiornamenti non devono sovrascrivere materiali dell'utente, wiki compilata, cache, ricerche, bozze o regole personalizzate del caso. Le preferenze locali concordate con l'utente vivono in AGENTE/REGOLE_PERSONALIZZATE/ e prevalgono sulle regole generali.

Novità e storia delle modifiche

1. Versione 0.7 - 2026-06-21
   • Aggiunta guida operativa autonoma LLM_WIKI.md, ispirata al pattern LLM Wiki di Karpathy e adattata alla pratica legale.
   • L'agente deve leggere LLM_WIKI.md all'avvio insieme alle istruzioni core.
   • Rafforzate le regole su ingest, query, lint, index/log, pagine fonte, pagine trasversali, contraddizioni, archiviazione delle buone risposte e rendiconto.

   Migrazione: Nessuna migrazione di cartelle. Nei nuovi pacchetti viene aggiunto AGENTE/REGOLE/LLM_WIKI.md; nei progetti esistenti l'agente puo' aggiungerlo con un aggiornamento regole.

2. Versione 0.6 - 2026-06-21
   • Documentata in modo esplicito la sintassi dell'API Diritto Pratico sentenza_api.php.
   • Aggiunti metodo GET, parametri ammessi, alias, formati data/numero, esempi di URL e gestione degli errori JSON.
   • Chiarito che l'API non e' una ricerca full-text e non vanno provati parametri casuali come q, query o sentenza.
   • Rafforzato il workflow di salvataggio testo, permalink, snippet verbatim, pagina wiki e stato di verifica.

   Migrazione: Nessuna migrazione di cartelle.

3. Versione 0.5 - 2026-06-19
   • Nuovo modello di progetto: la root è la cartella pratica dell'utente, mentre AGENTE è solo area tecnica.
   • Rimosse come cartelle iniziali obbligatorie INGRESSO e FASCICOLO; aggiunte cartelle operative BOZZE, NUOVI_DOCUMENTI, DA_CLASSIFICARE e MODELLI_ESEMPI.
   • Introdotto indice file obbligatorio in AGENTE/WIKI/indice_file.md con SHA256, percorso, stato, descrizione e quadratura.
   • Aggiunte regole robuste per scansione autorizzata, esclusione di AGENTE, backup ZIP prima di modifiche e riordino logico-cronologico con cartelle numerate.
   • Chiarita la compatibilità con i pacchetti precedenti: gli aggiornamenti sono fruibili, ma le migrazioni strutturali richiedono consenso esplicito.

   Migrazione: Per i nuovi pacchetti la root coincide con la cartella pratica e AGENTE è area tecnica. Nei progetti esistenti con INGRESSO/FASCICOLO/BOZZE l'agente non deve spostare nulla automaticamente: deve indicizzare lo stato attuale, spiegare il nuovo modello e proporre eventuale migrazione solo previa autorizzazione e backup.

4. Versione 0.4 - 2026-06-14
   • Trasferito dal pacchetto civile il protocollo completo di ricerca giurisprudenziale con DPChat/NotebookLM di Diritto Pratico.
   • Aggiunta validazione tramite sentenza_api.php: recupero testo, permalink, stati di verifica, snippet verbatim e confronto massima/testo.
   • Rafforzata la regola dura: negli atti destinati al deposito si cita solo giurisprudenza verificata dall'avvocato.
   • Aggiunti template generici per query banca dati, Deep Research, memorandum giurisprudenziale e pagina pronuncia completa.

   Migrazione: Nessuna migrazione obbligatoria. Nei progetti esistenti l'agente può aggiungere i nuovi template di ricerca sotto AGENTE/RICERCHE e AGENTE/TEMPLATES quando servono.

5. Versione 0.3 - 2026-06-13
   • Allineamento forte con le regole del pacchetto civile, importando i principi riusabili nel contesto generico.
   • Aggiunti principi non negoziabili: prudenza critica, distinzione tra fatti/allegazioni/ipotesi, divieto di giurisprudenza a memoria e rendiconto di verifica.
   • Rafforzata la disciplina LLM Wiki: risposte da archiviare, ingest atomico, riallineamento obbligatorio, fonti tracciate e lint.
   • Aggiunte aree tecniche in AGENTE per cache testi, ricerche, riservato, template, fonti e giurisprudenza.
   • Aggiunti protocolli per studio generico, ricerca giurisprudenziale/fonti esterne, redazione supervisionata, distillati e anonimizzazione.

   Migrazione: Nessuna migrazione obbligatoria. Nei nuovi pacchetti vengono aggiunte cartelle tecniche sotto AGENTE; nei progetti esistenti l'agente può crearle quando servono, senza toccare i materiali dell'utente.

6. Versione 0.2 - 2026-06-13
   • Rafforzata la logica multi-agente ereditata dal pacchetto civile.
   • Ogni agente deve identificarsi con piattaforma/modello, firmare il log e indicare le modifiche sostanziali alla wiki.
   • Introdotta la voce di presa in consegna quando un agente eredita lavoro precedente.
   • Aggiunto protocollo di secondo parere e revisione critica del lavoro di altri agenti.

   Migrazione: Nessuna migrazione di cartelle.

7. Versione 0.1 - 2026-06-13
   • Prima versione dell'ambiente agente legale generico basato su LLM Wiki.
   • Struttura utente minimale: INGRESSO, FASCICOLO, BOZZE, AGENTE.
   • La wiki del caso vive dentro AGENTE/WIKI e non richiede interventi manuali dell'utente.
   • L'agente apre il lavoro chiedendo all'utente le informazioni necessarie, senza questionario nella pagina PHP.
   • Le regole personalizzate del caso in AGENTE/REGOLE_PERSONALIZZATE prevalgono sulle regole generali e non vengono sovrascritte dagli aggiornamenti.

   Migrazione: Prima versione: nessuna migrazione.