lore-ita-modulare

WORKFLOW ITALIA POST-APOCALITTICA CON CLAUDE

File: 00.1.1-workflow-claude.md

Obiettivo

Questo documento definisce il workflow ottimizzato per lo sviluppo e la manutenzione dell’ambientazione “Italia Post-Apocalittica” utilizzando un approccio modulare con assistenza di Claude.

Workflow in Due Fasi

Fase 1: Pianificazione e Analisi (Prima Chat)

1. Selezione del Focus
   • Identificare il modulo o l’elemento specifico da sviluppare/modificare
   • Determinare l’obiettivo dell’intervento (espansione, correzione, collegamento)
2. Caricamento File Principale
   • Caricare il file principale su cui si intende lavorare
   • Specificare chiaramente il tipo di intervento desiderato
3. Analisi dei Collegamenti
   • Claude analizza il documento e identifica i file correlati necessari
   • Consultazione del documento “Mappa dei Collegamenti” per il modulo in questione
   • Verifica dei collegamenti esistenti e mancanti utilizzando la mappa
4. Definizione Piano di Lavoro
   • Creazione di una nota strutturata con tutte le modifiche da implementare
   • Elenco dettagliato dei file da modificare e delle relazioni da aggiornare
   • Identificazione di eventuali nuovi file da creare
5. Definizione Aggiornamenti Meta-Documentazione
   • Specificare gli aggiornamenti necessari per:
     • Changelog (nuova versione e dettagli delle modifiche)
     • Indice principale (se necessario)
     • File ponte tra vault (se pertinente)
     • Documenti “Mappa dei Collegamenti”

Fase 2: Implementazione (Seconda Chat)

1. Caricamento File da Modificare
   • Caricare tutti i file identificati nella Fase 1
   • Verificare che non manchino documenti essenziali
2. Creazione Artefatti
   • Claude crea artefatti contenenti le versioni aggiornate di tutti i file
   • Ogni artefatto corrisponde a un file completo pronto per essere scaricato e sostituito
   • Gli artefatti seguono la nomenclatura originale dei file per facilitare la sostituzione
3. Creazione Artefatti Meta-Documentazione
   • Artefatto per aggiornamenti al changelog
   • Artefatto per aggiornamenti all’indice (se necessario)
   • Artefatto per aggiornamenti ai file ponte (se applicabile)
   • Artefatto per la versione aggiornata del documento “Mappa dei Collegamenti”
4. Verifica Generale
   • Controllo finale della coerenza tra tutti gli artefatti
   • Verifica che tutti i collegamenti siano bidirezionali e funzionanti
   • Conferma che tutte le modifiche pianificate siano state implementate

Ciclo di Aggiornamento Completo

Per ogni sessione di lavoro, assicurarsi di aggiornare sistematicamente:

1. File di Contenuto

• File primario oggetto della modifica
• File secondari correlati
• Eventuali nuovi file creati

2. File Meta (Obbligatori)

• Changelog: Aggiungere una nuova voce seguendo il formato standard: ```

  v[X.Y.Z] [YYYY-MM-DD]

  • [ADD/MOD/FIX/DEL] Descrizione della modifica
  • [ADD/MOD/FIX/DEL] Descrizione della modifica ```
• Mappa dei Collegamenti: Aggiornare la mappa del modulo modificato con:
  • Nuovi collegamenti aggiunti
  • Collegamenti in entrata aggiornati
  • Elementi chiave menzionati aggiornati
  • Collegamenti mancanti prioritari rivisti

3. File Indice e Navigazione (Se Necessario)

• Indice Principale: Se sono stati aggiunti nuovi file o sezioni
• Dashboard: Se la struttura dei moduli è cambiata significativamente
• File Ponte: Se sono state modificate informazioni rilevanti per altri vault

Utilizzo delle Mappe di Collegamenti

Le mappe di collegamenti sono uno strumento fondamentale per mantenere la coerenza dell’ambientazione:

Creazione di Nuove Mappe

1. Utilizzare il file template 00.5.0-mappa-template.md come base
2. Analizzare tutti i file del modulo, identificando:
   • Collegamenti in uscita (link ad altri file)
   • Collegamenti in entrata (file che fanno riferimento a questo)
   • Elementi chiave menzionati senza collegamenti
   • Elementi trasversali che compaiono in più file
3. Organizzare la mappa seguendo le sezioni del template:
   • Analisi file per file
   • Elementi chiave trasversali
   • Collegamenti mancanti prioritari
   • Note di manutenzione
   • Lezioni apprese dall’armonizzazione (se applicabile)

Aggiornamento delle Mappe Esistenti

1. Verificare che tutti i nuovi collegamenti aggiunti siano documentati
2. Aggiornare la sezione “Collegamenti mancanti prioritari” rimuovendo quelli implementati
3. Aggiornare la data dell’ultimo aggiornamento e la versione dell’ambientazione
4. Aggiungere eventuali nuovi elementi chiave identificati

Best Practices per le Mappe

• Mantenere le mappe aggiornate ad ogni modifica sostanziale
• Utilizzare le mappe per pianificare future sessioni di lavoro
• Dare priorità ai collegamenti bidirezionali mancanti
• Documentare nella mappa le lezioni apprese e le decisioni prese durante l’armonizzazione

Convenzioni Importanti

1. Versionamento

• Major (X.0.0): Cambiamenti strutturali o concettuali significativi
• Minor (0.X.0): Aggiunte di nuovi contenuti o espansioni significative
• Patch (0.0.X): Correzioni, chiarimenti o aggiornamenti minori

2. Nomenclatura File

• Seguire sempre il formato XX.Y-nome-descrittivo.md
• Utilizzare solo caratteri ASCII nei nomi file (no accenti o caratteri speciali)
• Mantenere coerenza con la struttura modulare esistente

3. Formattazione Contenuti

• Utilizzare titoli H1 per il titolo principale del documento
• Utilizzare titoli H2 e H3 per le sezioni e sottosezioni
• Mantenere lo stile narrativo coerente con il resto dell’ambientazione

4. Collegamenti

• Utilizzare sempre percorsi relativi per i collegamenti interni
• Verificare che ogni nuovo elemento menzionato abbia i collegamenti appropriati
• Aggiornare i collegamenti bidirezionali (A → B implica anche B → A)
• Documentare nelle mappe collegamenti i link mancanti o incompleti

Checklist di Completamento

Al termine di ogni sessione di lavoro, verificare:

• Tutti i file di contenuto sono stati aggiornati
• Il changelog è stato aggiornato con la nuova versione
• La mappa dei collegamenti è stata aggiornata
• L’indice principale è stato aggiornato (se necessario)
• I file ponte sono stati aggiornati (se necessario)
• Tutti i nuovi elementi hanno collegamenti appropriati
• La coerenza narrativa è stata mantenuta
• Il formato e lo stile sono coerenti con il resto dell’ambientazione
• I collegamenti bidirezionali sono stati verificati e aggiornati

Utilizzo di Claude per l’Analisi di Collegamenti

Claude è particolarmente efficace nell’identificare e gestire i collegamenti tra documenti:

1. Analisi di Coerenza
   • Chiedi a Claude di identificare incongruenze tra diversi file
   • Utilizza Claude per verificare la consistenza di elementi menzionati in più luoghi
2. Identificazione di Collegamenti Mancanti
   • Claude può analizzare il testo per trovare elementi menzionati senza collegamenti
   • Chiedi a Claude di elencare potenziali collegamenti bidirezionali mancanti
3. Generazione di Mappe
   • Claude può creare mappe di collegamenti complete per moduli esistenti
   • Utilizza Claude per aggiornare le mappe esistenti dopo modifiche significative
4. Verifica di Percorsi
   • Chiedi a Claude di controllare la validità dei percorsi relativi
   • Utilizza Claude per identificare e correggere percorsi obsoleti o errati

---

Questo workflow è stato aggiornato il 2025-03-20 e rappresenta la versione 1.1 del processo di collaborazione con Claude per la gestione dell’ambientazione “Italia Post-Apocalittica”. Questo documento è complementare al workflow generale esistente (00.4-workflow-modulare.md).