From 9b0a2700db36d65e8d4fc4e26012483bd477e34c Mon Sep 17 00:00:00 2001
From: zeeoale <zeooale@gmail.com>
Date: Mon, 16 Feb 2026 22:19:11 +0100
Subject: [PATCH] Add PCN Studio manifesto and context specification

---
 docs/ARCHITECTURE_OVERVIEW.md | 94 +++++++++++++++++++++++++++++++++++
 docs/PCN_CONTEXT_SPEC.md      | 23 +++++++++
 docs/PCN_STUDIO_MANIFESTO.md  | 84 +++++++++++++++++++++++++++++++
 3 files changed, 201 insertions(+)
 create mode 100644 docs/ARCHITECTURE_OVERVIEW.md
 create mode 100644 docs/PCN_CONTEXT_SPEC.md
 create mode 100644 docs/PCN_STUDIO_MANIFESTO.md

diff --git a/docs/ARCHITECTURE_OVERVIEW.md b/docs/ARCHITECTURE_OVERVIEW.md
new file mode 100644
index 0000000..170d8d5
--- /dev/null
+++ b/docs/ARCHITECTURE_OVERVIEW.md
@@ -0,0 +1,94 @@
+
+---
+
+# 📄 3️⃣ `docs/ARCHITECTURE_OVERVIEW.md`
+
+```markdown
+# PCN Studio — Architecture Overview
+
+## Livelli
+
+### 1. Data Layer
+
+- World JSON
+- Pack JSON
+- Global JSON (lighting, camera, ecc.)
+
+Output: PCN_CONTEXT.pool
+
+---
+
+### 2. Selection Layer
+
+Nodi modulari:
+
+- World Loader
+- Outfit Picker
+- Pose Picker
+- Background Picker
+- Lighting Picker
+- Object Picker
+- Accessories Picker
+
+Ogni nodo:
+- legge PCN_CONTEXT
+- modifica selected.*
+- passa avanti il contesto
+
+---
+
+### 3. Composition Layer
+
+Prompt Composer:
+
+- Legge world + selected
+- Applica regole
+- Costruisce prompt_base
+- Scrive output.*
+
+---
+
+### 4. LLM Layer
+
+Enhancer separato:
+
+- Temperature
+- Top_p
+- Repetition penalty
+- Model selection
+
+Non modifica world.
+Non modifica pool.
+
+Lavora solo su prompt_base.
+
+---
+
+### 5. Render Layer
+
+ComfyUI pipeline esistente:
+
+- KSampler
+- LoRA
+- Upscale
+- Post-processing
+
+PCN Studio non modifica questo livello.
+
+---
+
+## Flusso Dati
+
+World/Pack → PCN_CONTEXT → Picker → Composer → LLM → Render
+
+---
+
+## Design Goals
+
+- Modularità
+- Riproducibilità
+- Estendibilità futura
+- Compatibilità con Classic
+- Leggibilità del workflow
+
+PCN Studio deve crescere senza diventare ingestibile.
diff --git a/docs/PCN_CONTEXT_SPEC.md b/docs/PCN_CONTEXT_SPEC.md
new file mode 100644
index 0000000..e317efb
--- /dev/null
+++ b/docs/PCN_CONTEXT_SPEC.md
@@ -0,0 +1,23 @@
+# PCN_CONTEXT Specification (v0.1-dev)
+
+## Scopo
+
+PCN_CONTEXT è l’oggetto di stato condiviso tra tutti i nodi della PCN Suite.
+
+Rappresenta l’intero processo creativo in forma serializzabile e riproducibile.
+
+---
+
+## Struttura Base
+
+```json
+{
+  "version": "PCN_CONTEXT_0.1",
+  "world": {},
+  "pool": {},
+  "selected": {},
+  "rules": {},
+  "output": {},
+  "llm": {},
+  "debug": {}
+}
diff --git a/docs/PCN_STUDIO_MANIFESTO.md b/docs/PCN_STUDIO_MANIFESTO.md
new file mode 100644
index 0000000..45941d9
--- /dev/null
+++ b/docs/PCN_STUDIO_MANIFESTO.md
@@ -0,0 +1,84 @@
+# PCN Studio — Manifesto
+
+## Visione
+
+PCN Studio nasce per trasformare il PromptCreatorNode da generatore di prompt
+a sistema di direzione creativa strutturato.
+
+L'obiettivo non è aumentare la casualità.
+L'obiettivo è disciplinarla.
+
+PCN Studio introduce stratificazione, modularità e controllo,
+senza rompere la stabilità della versione Classic.
+
+---
+
+## Principi Fondanti
+
+### 1. Separazione dei Livelli
+
+PCN Studio è diviso in layer indipendenti:
+
+- Data Layer (World + Pack)
+- Selection Layer (Picker)
+- Composition Layer (Composer)
+- LLM Layer (Enhancer)
+- Render Layer (Comfy pipeline)
+
+Ogni layer ha responsabilità precise.
+Nessun layer deve fare il lavoro di un altro.
+
+---
+
+### 2. Backward Compatibility
+
+PromptCreatorNode Classic resta stabile.
+PCN Studio non rompe i world esistenti.
+Ogni evoluzione deve essere opzionale.
+
+---
+
+### 3. PCN_CONTEXT come Contratto Universale
+
+Tutti i nodi della Suite comunicano tramite un unico oggetto:
+PCN_CONTEXT.
+
+Nessun nodo deve:
+- ricaricare file
+- generare stato nascosto
+- dipendere da logiche interne non visibili
+
+---
+
+### 4. Modularità > Monolite
+
+Funzioni complesse devono vivere in nodi separati.
+UI pesanti devono essere evitate.
+Il canvas può crescere, ma l’architettura deve restare leggibile.
+
+---
+
+### 5. Direzione > RNG
+
+La casualità è uno strumento.
+La coerenza è un obiettivo.
+
+PCN Studio permette:
+- Lock per categoria
+- Weighted selection
+- Stickiness (coerenza tra run)
+- Reproducibilità completa
+
+---
+
+## Obiettivo 2.0
+
+Creare un ecosistema:
+
+- PCN Classic (Stable)
+- PCN Studio (Advanced)
+- Pack Format (estensibile)
+- World Manifest modulare
+
+PCN Studio non è un refactor.
+È una maturazione architetturale.