---
name: siae-release-docs-mono
description: >
Use when devi generare in un colpo solo TUTTI i documenti di un rilascio EDW
SIAE (NDR DL, NDR RS, GDC, slide architettura, DDE) partendo da un singolo
YAML manifesto. Versione "mono/monolitica": tutta la logica di
orchestrazione e generazione vive in questa skill, senza dipendenze da
altre skill. Trigger: genera tutti i documenti, suite rilascio EDW,
EDW_XX.XX docs completi, full release docs, DMND000XXXX documenti,
/forge-release-docs-mono.
---
# Release Docs Mono (Monolithic) - DevForge
```
╔══════════════════════════════════════════════════════════════════╗
║ ███████╗██╗ █████╗ ███████╗ ██████╗ ███████╗██╗ ██╗ ║
║ ██╔════╝██║██╔══██╗██╔════╝ ██╔══██╗██╔════╝██║ ██║ ║
║ ███████╗██║███████║█████╗ ██║ ██║█████╗ ██║ ██║ ║
║ ╚════██║██║██╔══██║██╔══╝ ██║ ██║██╔══╝ ╚██╗ ██╔╝ ║
║ ███████║██║██║ ██║███████╗ ██████╔╝███████╗ ╚████╔╝ ║
║ ╚══════╝╚═╝╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚══════╝ ╚═══╝ ║
║ 🔨 DevForge · RELEASE DOCS MONO (MONOLITHIC) ║
║ "Il codice si forgia. Il developer cresce." ║
╚══════════════════════════════════════════════════════════════════╝
```
> **Tipo:** Monolithic generator | **Fase SDLC:** Rilascio EDW completo
---
## Obiettivo
Generare in **una singola invocazione self-contained** l'intera suite
documentale di un rilascio EDW SIAE — NDR DL, NDR RS, GDC, slide
architettura DL/RS + PNG, DDE cumulativo — leggendo **un solo YAML
manifesto** e producendo tutti gli output con un workflow integrato.
A differenza di `siae-release-docs-pack` (che delega a 5 sub-skill via
Skill tool), questa skill **incorpora tutta la logica direttamente**:
- Tutti i workflow step sono documentati qui
- Tutti gli LL/vincoli specifici sono richiamati qui
- Le reference dettagliate (snippet python-docx/pptx) restano nei file
delle 5 skill esistenti come "deep dive technical reference", ma il
workflow operativo e tutti i punti di decisione sono in questa skill
Output prodotti (max 5 file + 2 PNG):
1. NDR DL `.docx`
2. NDR RS `.docx`
3. GDC `.pptx`
4. Architettura `.pptx` (file master aggiornato)
5. DDE `.docx` (file master cumulativo aggiornato)
6. `architettura_DL.png` + `architettura_RS.png`
---
## Quando si Applica
**Sempre:**
- Hai un rilascio EDW pronto (DMND, EDW release, CHG assegnati)
- YAML manifesto compilato e validato
- I template/master precedenti sono disponibili:
- `/NDR DL/.docx`
- `/NDR/.docx`
- `/GDC/.pptx`
- `/DDE/DDE-DataPlatform-Ingestion-.docx`
- `/Architettura DDE/DdE - Architettura - New.pptx`
dove `` = `C:\Users\frmonaco\Downloads\Claude documentazione\`
**Eccezioni (chiedi al partner):**
- Solo un sottoinsieme di documenti richiesto → usa la skill specifica
esistente (es. `gdc-generator` standalone)
- YAML incompleto / valori `null` / `TBD` → fermati e chiedi
- Generazione gia' iniziata manualmente → conferma sovrascrittura
- Multi-Wave dello stesso rilascio in un colpo → due invocazioni separate,
una per Wave (i CHG e i path NAS sono diversi)
---
## Legge di Ferro
> **Una sola fonte di verita' YAML, una sola invocazione, 5 output coerenti.**
>
> Tutti i parametri condivisi (`dmnd_id`, `edw_release`, `titolo_progetto`,
> `chg_id_*`, `oggetti_redshift`) devono essere identici nei 5 documenti.
> Coerenza cross-doc e' obbligatoria — se anche una sola riga del DDE
> cita un conteggio diverso da quello della GDC, il rilascio si blocca
> in call con SIAE.
>
> **Conteggi, lista oggetti, lista tabelle, host sorgenti**: SEMPRE
> dal partner via YAML. Mai dedurre, mai inferire, mai lasciare `TBD`.
---
## Istruzioni
### Step 0 - Carica YAML e validazione
🟡 MEDIO - Mostra pre-flight card prima di eseguire
| 🟡 MEDIO (reversibile) - 🔨 DevForge · siae-release-docs-mono |
|:---|
| 🛠️ Operazione: `Carica YAML + validazione semantica` · 📁 Scope: `YAML manifesto` |
| **▼ Azione** |
| 1. ✏️ Verifica path YAML esistente e parsabile. |
| 2. ✏️ Valida sezioni obbligatorie: `release.*`, `layer_impattati.*`, `chg_numbers.*`, `sorgente.*`, `narrativa.*`. |
| 3. ✏️ Valida campi cross-sezione condivisi (vedi LL "no count inference", LL ARCH-10 host). |
| 4. ✏️ Stampa la matrice "quali documenti verranno generati". |
| 💡 Perche': YAML invalido = fallimento a meta' flusso. Investa 2 minuti ora per non perdere 30 minuti dopo. |
| 🚫 Se NO: Output parziali, debugging confuso, rollback manuale. |
**Validazioni semantiche obbligatorie** (vedi
[reference/yaml-schema-validation.md](reference/yaml-schema-validation.md)
per la lista completa):
| Campo | Regola | LL riferimento |
|---|---|---|
| `release.dmnd_id` | formato `DMND\d{7}` | - |
| `release.edw_release` | formato `\d{2}\.\d{2}` | - |
| `layer_impattati.*` | almeno uno true tra DL/RS | - |
| `sorgente.new_sources[*].host` | NON null, NON `TBD` (esplicito `N.A.` ok per on-prem) | LL ARCH-10, LL DL-N |
| `dde.lista_tabelle_rilascio` | non vuota se DDE da generare | LL DDE-22 |
| `chg_numbers.` | popolato per ogni layer impattato | - |
| `pacchetto_software.etl_glue` | conteggio coerente con `oggetti_redshift` length | - |
Se una validazione fallisce, **fermati** e chiedi al partner di sistemare
il YAML.
**Matrice generazione**:
```
Layer DL: NDR DL GDC sez DL DDE cap DL Arch slide DL Arch PNG DL
Layer RS: NDR RS GDC sez RS DDE cap RS Arch slide RS Arch PNG RS
Sempre: GDC base DDE revisioni
```
### Step 1 - Localizza master files + crea cartelle output
🟢 SICURO
Path standard (override possibili nello YAML):
```python
BASE = Path(r"C:\Users\frmonaco\Downloads\Claude documentazione")
NDR_DL_REF = pick_latest(BASE / "NDR DL", "*.docx")
NDR_RS_REF = pick_latest(BASE / "NDR", "*.docx")
GDC_REF = BASE / "GDC" / "DMND000XXXXX - GDC - AWS Data Platform - EDW_XX_XX_TEST.pptx"
GDC_PREV = pick_latest(BASE / "GDC", "DMND0*.pptx") # GDC precedente per cumulativa
DDE_MASTER = pick_latest(BASE / "DDE", "DDE-DataPlatform-Ingestion-*.docx")
ARCH_PPTX = BASE / "Architettura DDE" / "DdE - Architettura - New.pptx"
OUTPUT_DIR = Path(yaml["release"]["output_dir"])
OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
(OUTPUT_DIR / "architettura").mkdir(exist_ok=True)
```
**Backup automatico** del DDE master e dell'architettura pptx (entrambi
modificati in-place): copia in `/file storici/_backup_.`.
### Step 2 - Genera NDR DL (se DL impattato)
🟢 SICURO - Workflow inline, riusa pattern documentati in `ndr-generator-dl`
**Flow**:
1. Copia `NDR_DL_REF` in `