Classificazione rischio sismico DM 58/2017 - PAM + IS-V (sismabonus)

Quando usare questa skill

Usare quando un ingegnere strutturista italiano deve:

Calcolare la classe di rischio sismico (A+, A, B, C, D, E, F, G) di un edificio esistente con il METODO CONVENZIONALE del DM 58/2017 Allegato A, dato l'output dell'analisi di vulnerabilita' (PGA_C e TR_C per i 4 SL NTC: SLO, SLD, SLV, SLC) e i parametri sismici al sito (PGA_D dalle NTC 2018 par. 3.2)
Calcolare il PAM (Perdita Annua Media) come area sottesa alla Curva di Individuazione (formula trapezoidale a 5 punti SLID->SLO->SLD->SLV->SLC + termine di coda SLR=100% al λ di SLC)
Calcolare l'IS-V (Indice di Sicurezza per la Vita) = PGA_C(SLV) / PGA_D(SLV)
Determinare la classe finale come la peggiore tra classe PAM e classe IS-V (Allegato A punto 2.3)
Confrontare uno stato di fatto e uno stato di progetto e calcolare il salto classi (numero di classi guadagnate dall'intervento), come indicatore tecnico per l'asseverazione sismabonus
Verificare valori di PAM, IS-V o classe prodotti da altri software (ClaSS, CDM Win, EdiSis, MasterSap-SismiClass)

Non usare quando l'utente chiede:

Il METODO SEMPLIFICATO per edifici in muratura (DM 58/2017 Allegato A punto 3, tabelle tipologie x numero piani): fuori scope di questa versione 0.1.0-alpha
L'esecuzione dell'analisi di vulnerabilita' sismica (NTC 2018 cap. 8): la skill prende PGA_C e TR_C in input, non li calcola. La skill non sostituisce il modello strutturale ne' l'analisi (lineare, pushover, time-history)
La generazione del modello di asseverazione tecnica Allegato B / B-bis pronto al deposito (firma del professionista, marca da bollo, allegati grafici): la skill produce i numeri e la classe, l'asseverazione formale e' a carico del professionista
Il calcolo delle aliquote di detrazione fiscale sismabonus (50%, 70%, 75%, 80%, 85%): variano nel tempo per legge finanziaria, fuori scope. La skill produce il salto classi; l'aliquota applicabile va verificata dal commercialista o da norme fiscali vigenti
Edifici nuovi: la classificazione DM 58/2017 si applica a edifici esistenti per la valutazione del miglioramento conseguente a intervento. Per edifici nuovi vale per definizione la classe associata al nuovo livello di sicurezza progettuale (NTC 2018)
Edifici a destinazione monumentale o tutelati ex Codice dei Beni Culturali: l'applicabilita' del sismabonus e del DM 58/2017 e' specifica e va verificata caso per caso (DPCM Beni Culturali 9/2/2011)

Avvertenza

Questa skill e' uno strumento di supporto al calcolo di PAM, IS-V e classe di rischio sismico DM 58/2017. Non sostituisce il giudizio del progettista strutturale firmatario. L'output e' deterministico (formule chiuse trapezoidali) e quindi confrontabile dal progettista contro software certificati (ClaSS, CDM Win, EdiSis, MasterSap-SismiClass): il confronto resta in capo al professionista. Nello stato v0.1.0-alpha la skill non e' ancora stata validata con confronto numerico vs software certificati su casi reali; i test interni coprono solo la consistenza delle formule, i bordi delle tabelle classi e l'anti-drift fixture-based. La skill non produce l'asseverazione tecnica Allegato B / B-bis pronta al deposito e non firma elaborati. L'analisi di vulnerabilita' (NTC 2018 cap. 8) che produce PGA_C e TR_C per i 4 SL NTC e' prerequisito non automatizzato dalla skill: e' responsabilita' esclusiva del progettista strutturale.

Sotto-attivita' disponibili

In base alla richiesta dell'utente, carica il task file appropriato:

Calcolo classificazione: l'utente chiede "qual e' la classe di rischio?", "calcola PAM e IS-V per questo edificio", "che classe esce con questi TR_C?", "confronta fatto e progetto e dimmi il salto" -> leggi tasks/calcola-classificazione.md
Validazione input edificio: l'utente chiede "i miei TR_C e PGA_C sono coerenti?", "la curva e' monotona?", "l'analisi e' affidabile per la classificazione?" -> leggi tasks/valida-input.md
Esecuzione test suite: utente o validatore vuole verificare la consistenza interna del modulo (formule, bordi tabelle, validazione input, fixture esempio) o pianificare la validazione di campo vs software certificati -> leggi tasks/run-test-suite.md

Se la richiesta e' generica ("aiutami con il sismabonus"), chiedi se l'utente vuole solo classificare lo stato di fatto, confrontare fatto+progetto per il salto classi, o validare gli input. La sequenza naturale e': prima valida-input (sanity check su monotonia e coerenza fisica), poi calcola-classificazione.

Modulo di calcolo (code-driven - regola di invocazione)

Le formule chiuse del DM 58/2017 Allegato A (PAM trapezoidale, capping passo 2.1.3, IS-V, classificazione, salto classi) sono implementate nel modulo Python tasks/lib/sismabonus.py. La test suite tasks/lib/test_sismabonus.py copre consistenza interna + verifica numerica vs valore di riferimento del decreto: formula PAM (4 trapezoidi + coda SLR) verificata vs il valore PAM = 1,13% dichiarato dal decreto stesso per V_R=50 ai minimi NTC, capping prescritto al passo 2.1.3 con default attivo + flag --no-capping, bordi delle tabelle classi PAM (8 classi A+..G) e IS-V (7 classi A+..F) coerenti con il testo letterale dell'Allegato A, regola "classe finale = peggiore", regola salto classi, rilevamento curva non monotona residua (warning), validazione input (NaN/inf, negativi, stringhe, bool, JSON RFC 8259), CLI con --input-json + error handling friendly su chiavi mancanti e fallback strict su PGA_D parziali, anti-drift fixture-based su examples/caso-conforme-fittizio/{input,expected}.json. Non confronta vs software certificati su edifici reali: la validazione di campo e' prerequisito del release stabile e va eseguita seguendo tasks/run-test-suite.md.

REGOLA OPERATIVA INVIOLABILE. Per ogni calcolo numerico (lambda da TR, PAM, IS-V, classi PAM/IS-V, classe finale, salto classi) devi invocare il modulo Python via Bash. NON riprodurre i numeri "a mano" leggendo le formule dagli estratti in references/estratti/: gli estratti sono materiale di citazione normativa, non sostituiscono l'esecuzione del modulo. Calcolare a mano vanifica l'intera ragion d'essere della skill (output deterministico e riproducibile, confrontabile dal progettista) e introduce errore stocastico.

Path del modulo

In Claude Code la variabile ${CLAUDE_SKILL_DIR} punta a questa skill. Usala in tutti i comandi Bash:

python3 ${CLAUDE_SKILL_DIR}/tasks/lib/sismabonus.py --help
python3 ${CLAUDE_SKILL_DIR}/tasks/lib/sismabonus.py --input-json caso.json

In Codex e altri agent compatibili AGENTS.md la variabile potrebbe non essere risolta: in tal caso sostituiscila con il path assoluto della directory che contiene questo SKILL.md (l'agent conosce sempre il path da cui ha caricato la skill). Non usare path relativi tipo tasks/lib/sismabonus.py: la CWD dell'utente quasi mai coincide con la skill dir.

Il modulo non ha dipendenze esterne (solo libreria standard Python 3.9+).

Processo generale

Identifica la sotto-attivita' richiesta dall'utente.
Carica il task file specifico in tasks/.
Acquisisci dall'utente i dati necessari per ciascuno stato (di fatto, eventualmente di progetto):
- Per ciascuno dei 4 SL NTC (SLO, SLD, SLV, SLC):
  - TR_C [anni]: periodo di ritorno di capacita' dell'evento che porta l'edificio a quel SL (output dell'analisi di vulnerabilita', NTC 2018 cap. 8)
  - PGA_C [g]: accelerazione di picco al suolo di capacita' associata
  - PGA_D [g]: accelerazione di picco al suolo di domanda al sito (NTC 2018 par. 3.2 + Allegato A)
- SLID e' convenzionale: TR=10 anni, CR=0% (Allegato A punto 2.1).
- SLR e' convenzionale: stesso lambda di SLC, CR=100% (termine di coda della formula PAM).
Costruisci il file JSON di input (formato in tasks/calcola-classificazione.md) e invoca il modulo Python con --input-json.
Riporta in chat l'output JSON del modulo accompagnato dalla parafrasi in linguaggio naturale, con citazione esplicita degli articoli del DM 58/2017 Allegato A.
Concludi con rinvio al progettista strutturale firmatario per la verifica dei numeri e per la redazione dell'asseverazione tecnica (Allegato B / B-bis), che la skill non produce.

Fonti normative

Riferimenti completi in references/sources.yaml. Fonti primarie:

DM Min. Infrastrutture e Trasporti 28/2/2017 n. 58 - Linee guida per la classificazione del rischio sismico delle costruzioni (decreto istitutivo)
DM MIT 7/3/2017 n. 65 - sostituisce l'Allegato A originale del DM 58/2017 con la versione vigente delle Linee Guida (testo letterale di riferimento di questa skill)
DM MIT 9/1/2020 n. 24 - aggiornamento successivo (verifiche di campo: vedi tasks/run-test-suite.md)
DM MIT 6/8/2020 n. 329 - modifica art. 3 del DM 58/2017 (commi 4-bis, 4-ter, 4-quater su super-sismabonus 110%) e SOSTITUISCE l'Allegato B (asseverazione del professionista). Non modifica l'Allegato A.
NTC 2018 (DM 17/1/2018) - cap. 3.2 (azione sismica al sito), cap. 8 (costruzioni esistenti)
Circ. MIT 21/1/2019 n. 7 - cap. C8 (commento a NTC cap. 8)

Estratti testuali in references/estratti/.

Limiti

Questa skill NON fa:

Non esegue l'analisi di vulnerabilita' (NTC 2018 cap. 8): l'utente deve fornire TR_C, PGA_C per i 4 SL NTC, prodotti dal progettista strutturale tramite analisi conformi
Non incorpora il reticolo INGV per PGA_D: l'utente deve fornire PGA_D per i 4 SL NTC, prodotti seguendo NTC par. 3.2 + Allegato A (vedi anche skill spettro-risposta-ntc per supporto al calcolo dello spettro/PGA al sito)
Non implementa il METODO SEMPLIFICATO per edifici in muratura (Allegato A punto 3): fuori scope di questa versione
Non genera l'Allegato B / B-bis (asseverazione tecnica del professionista): produce solo i numeri e la classe; il modulo formale e' a cura del professionista firmatario
Non determina le aliquote di detrazione fiscale sismabonus: variano per legge finanziaria, fuori scope della skill (rinvio al commercialista o al professionista delegato)
Non gestisce edifici a destinazione monumentale o tutelati ex Codice dei Beni Culturali (DPCM 9/2/2011): l'applicabilita' va verificata caso per caso
Non sostituisce la firma del progettista strutturale sull'asseverazione

Ogni output va verificato dal progettista strutturale prima di essere usato per asseverazione, deposito al SUE o richiesta di detrazione fiscale.