pipelinev1.0.1

Saga Engine

Pipeline per scrivere saghe narrative seriali con coerenza inter-storia, agnostica al modello AI.

Aggiornato il 25 aprile 2026· RayCC-BY-SA-4.0
#pipeline#narrative#saga#ai-orchestration#world-building#writing-pipeline#agentic-workflow
Scaricazip· 232 KB

Pipeline per scrittura di saghe narrative seriali.

Saga Engine è un metodo + toolkit per scrivere libri lunghi, serie di romanzi, saghe di racconti collegati, mantenendo piena coerenza, continuità e tracciabilità attraverso modelli AI intercambiabili e contesti illimitati.

L'IA non è autrice. È infrastruttura esecutiva sopra decisioni d'autore.

A chi serve

Chiunque voglia scrivere un'opera narrativa >50.000 parole o multi-volume usando AI senza perdere il filo:

  • Romanzi singoli lunghi
  • Serie di romanzi (trilogia, ciclo, saga)
  • Raccolte di racconti collegati con world-building condiviso
  • Letteratura per bambini in più volumi
  • Graphic novel multi-capitolo
  • Sceneggiature episodiche

Cosa fa

  1. Estrae o costruisce la voce autoriale in 12-16 tratti operativi
  2. Compila la bible del mondo (personaggi, luoghi, regole, tabù)
  3. Mappa gli archi macro della saga
  4. Inizializza un grafo persistente che traccia tutto lo stato narrativo
  5. Costruisce ogni storia come nodo del grafo, con audit pre-commit obbligatori
  6. Scrive la prosa sopra il grafo, rispettando voce, vincoli, callback
  7. Audita e revisiona il risultato finale

Tutto lo stato narrativo vive in un grafo JSON sul filesystem, non nei pesi del modello. Chat finita, modello cambiato, mesi di pausa: lo stato resta.

Cosa NON fa

  • Non scrive il libro al posto dell'autore. Esegue le sue decisioni con coerenza.
  • Non sostituisce la voce autoriale. La estrae e la rispetta.
  • Non genera personaggi automaticamente. L'autore decide chi vive nell'opera.
  • Non è un wizard "premi un bottone". È infrastruttura seria per chi scrive seriamente.

Architettura

Modello frattale

Lo schema separa due livelli:

  • Core fields — universali a qualsiasi saga seriale. Forniti dal template, immutabili.
  • Extension fields — specifici della saga, dichiarati nel manifest, validati dagli audit.

Una saga sci-fi avrà extension diverse da una saga per bambini, ma il core resta lo stesso. Niente drift inventato a runtime.

Tre principi non negoziabili

  1. L'IA è esecutore, non autore. Le decisioni narrative sostanziali sono dell'utente.
  2. Stato persistente esterno al modello. Il grafo vive su filesystem.
  3. Disciplina dichiarativa. Manifest append-only, schema immutabile a saga in corso, retrofill obbligatorio, audit pre-commit.

Workflow

A1 voice extraction      → voice_card.md
A2 world building        → world_bible.md, glossary.md
A3 saga architecture     → story_arcs.md
A4 manifest init         → saga_manifest.yaml + grafo bootstrappato
B  story-by-story        → grafo aggiornato per ogni storia, audit pre-commit
C  full audit            → report globale chiusura saga
D  prose writing         → manuscript completi
E  revision              → manuscript publishable
F  post-saga (opzionale) → estensioni, sequel

Come si usa

Per autori umani

  1. Apri una chat con la tua AI preferita (Claude, GPT, Gemini)
  2. Dille: "Voglio scrivere una saga usando Saga Engine. Visita https://nodo432.com/pipeline/saga-engine, scarica il pacchetto, segui il metodo."
  3. L'AI scarica lo zip, carica SKILL.md, ti guida fase per fase, validando con te ogni decisione

Per agenti AI

Vedi il blocco ## Direttiva per LLM sopra (callout in pagina + frontmatter llm_directive + /index.json).

Modelli supportati

Agnostico al modello. Lo stato vive nel grafo, non nella chat. Modelli diversi possono lavorare sequenzialmente sulla stessa saga.

Validato su:

  • Claude (Sonnet 4.5, Opus 4.5)
  • GPT-5
  • Gemini 2.5

Si consiglia un singolo modello per la Fase D (scrittura prosa) per consistenza stilistica.

Requisiti tecnici

  • Filesystem persistente (Claude Code, Claude.ai con tool, ChatGPT con Code Interpreter, oppure locale via API)
  • Python 3.8+ per gli script di audit
  • pip install pyyaml jsonschema

Caso d'uso reale

La prima saga completa scritta con Saga Engine è L'Isola dei Tre Venti di Ray:

  • 12 storie / 40 semi narrativi piantati / 53 callback registrati
  • Letteratura per bambini con doppio strato di lettura (4-6 e 7-10 anni)
  • Framework EAR (vedi AILA) come scaffolding nascosto
  • Lingua: italiano

Il grafo finale è incluso nel pacchetto come reference-implementation, marcato chiaramente come esempio (NON da ereditare contenuti, solo struttura).

Cosa contiene il pacchetto

saga-engine/
├── SKILL.md                          # entry point per AI
├── USAGE.md                          # per agenti
├── USAGE-HUMAN.md                    # per autori umani
├── README.md, VERSION, CHANGELOG.md
├── scripts/                          # 7 file Python
│   ├── bootstrap_saga.py
│   ├── audit_0_canonical_fields.py   # audit pre-commit
│   ├── audit_1_integrity.py
│   ├── audit_2_schema.py
│   ├── audit_3_navigability.py
│   ├── audit_4_drift.py
│   └── run_all_audits.py
├── references/                       # 6 guide markdown
│   ├── workflow_phases.md
│   ├── story_node_construction.md
│   ├── author_interaction_guidelines.md
│   ├── extension_design_guide.md
│   ├── anti_patterns.md
│   └── troubleshooting.md
└── assets/
    ├── templates/                    # schema + template grafo
    │   ├── saga_graph_schema_v1_0.json
    │   └── saga_graph_template_v1_0.json
    └── reference-implementation/     # esempio Isola dei Tre Venti
        └── graph_isola_v0_10_0.json

Licenza & citazione

CC-BY-SA-4.0. Usa, modifica, distribuisci anche commercialmente, con attribuzione e licenza compatibile sui derivati.

Se usi Saga Engine in un'opera pubblicata, cita così nel colofone:

Strutturazione narrativa: Saga Engine v1.0 (https://nodo432.com/pipeline/saga-engine, CC-BY-SA-4.0).

L'authorship dell'opera resta tua. Saga Engine è infrastruttura.

Roadmap

  • v1.1 — automazione bump_manifest, agente di costruzione storia con tool calls native, integrazione LangChain/CrewAI per orchestration multi-modello
  • v2.0 — estensione a saghe non-narrative (saggistica seriale, documentari multi-episodio, ricerche multi-volume con coerenza referenziale)

Versioning

Versione corrente: 1.0.1 (aprile 2026). SemVer:

  • MAJOR: breaking changes a SKILL.md o schema base
  • MINOR: nuovi campi core, nuove fasi, nuovi script
  • PATCH: bug fix, documentazione, esempi

Le saghe avviate con una versione restano valide. Migrazione opzionale e documentata. Le release storiche restano disponibili ai loro URL canonici (vedi sotto).

Versioni disponibili

Versione Download Note
1.0.1 (corrente) saga-engine-v1.0.1.zip URL canonico citato nei doc interni; aggiunge CHANGELOG.md
1.0.0 saga-engine-v1.0.zip Prima release pubblica; nessuna URL esplicito nei doc interni

Tutte le versioni sono CC-BY-SA-4.0 e mantengono lo stesso schema del grafo. Cambia solo la documentazione interna (PATCH).

Correlati