BIM Skills Italia — Agent Guidelines

Libreria open-source di skill e agenti AI per workflow BIM conformi al quadro normativo italiano. Questo file definisce le convenzioni e i vincoli operativi per tutti gli agenti AI (Claude Code, Google Antigravity, Cursor).

1. Quadro Normativo di Riferimento

Gli agenti devono sempre attenersi al testo vigente della normativa italiana ed europea:

1. D.Lgs. 36/2023 (Codice dei contratti pubblici):
   • Art. 43 (Metodi e strumenti di gestione informativa digitale delle costruzioni)
   • Allegato I.9 (Metodi e strumenti digitali, requisiti stazione appaltante, CI, oGI, pGI, ACDat)
   • D.Lgs. 209/2024 (Decreto correttivo): dal 01/01/2025 la soglia di obbligatorietà è 2.000.000 € (innalzata da 1.000.000 €); per i beni culturali l'obbligo scatta alla soglia europea per i lavori, aggiornata ogni due anni (5.404.000 € per il biennio 2026-2027, Reg. UE 2025/2150-2151-2152; era 5.538.000 € nel 2024-2025)
2. UNI 11337 (Gestione digitale dei processi informativi delle costruzioni):
   • Parte 1: Concetti, principi e requisiti generali
   • Parte 4: Evoluzione e sviluppo informativo (LOIN / LoG / LoI)
   • Parte 5: Flussi informativi (CI, oGI, pGI, ACDat)
   • Parte 6 (UNI/TR 11337-6:2017): Linea guida per la redazione del capitolato informativo
   • Parte 7: Profili professionali (BIM Manager, BIM Coordinator, BIM Specialist, CDE Manager)
   • Parte 8:2026: Sistema di gestione dei processi digitalizzati (SGPD) in una organizzazione delle costruzioni e dell'immobiliare — in vigore dal 09/04/2026, sostituisce la UNI/PdR 74:2019 (certificazione aziendale)
   • Parte 11:2026: e-Permit, procedure e flusso informativo per i procedimenti autorizzativi di opere pubbliche e private — pubblicata l'08/09/2026
   • Parte 12 (giugno 2025): flussi informativi, ruoli e requisiti per le opere infrastrutturali
   • La serie è in ampliamento: verificare su UNI lo stato delle parti non elencate (9, 10, 13) prima di citarle come vigenti
3. UNI/PdR 78:2020: Requisiti di certificazione per le figure professionali BIM (applicativa della UNI 11337-7; in evoluzione insieme alla revisione della Parte 7)
4. UNI EN ISO 19650:
   • Parte 1: Concetti e principi
   • Parte 2: Fase di consegna dei cespiti immobili (delivery team)
   • Parte 3: Fase gestionale dei cespiti immobili (AIM, operation & maintenance)
   • Parte 4:2022: Information exchange — processo e criteri decisionali dello scambio informativo per garantire la qualità del PIM/AIM risultante
   • Parte 5: Approccio alla gestione della sicurezza delle informazioni
   • Parte 6:2025: Health and safety information — condivisione strutturata delle informazioni di salute e sicurezza lungo il ciclo di vita (pubblicata gennaio 2025)
5. UNI EN 17412-1: Level of Information Need (LOIN)
6. ISO 16739-1:2024: Industry Foundation Classes — corrisponde a IFC 4.3 (IFC4 e IFC2x3 restano formati di scambio ancora diffusi nella pratica)
7. buildingSMART IDS 1.0 (giugno 2024): Information Delivery Specification, formato aperto per esprimere requisiti informativi verificabili automaticamente

Revisione ISO 19650 in corso. Le parti 1, 2 e 3 sono in revisione: bozze in consultazione pubblica da marzo 2026 (parti 1-2) e da giugno 2026 (parte 3), con pubblicazione delle nuove edizioni attesa fine 2026. Fino ad allora gli agenti lavorano esclusivamente sull'edizione vigente e non anticipano contenuti delle bozze: un capitolato non può citare una norma non pubblicata. Segnalare al committente che una revisione è attesa, quando il documento avrà vita contrattuale lunga.

2. Regole di Rigore Operativo (Anti-Allucinazione)

• Nessuna norma inventata: Non inventare mai commi, articoli o schemi IFC inesistenti. Citare solo riferimenti normativi verificabili.
• Lingua: I contenuti normativi, procedurali e le spiegazioni sono in italiano. Il codice sorgente (C#, Python, C++), i nomi di classi/metodi e i termini tecnici software restano in inglese.
• Nessuna dipendenza esterna: Le skill sono solo istruzioni testuali, non richiedono pacchetti da installare.
• Limiti espliciti: Indicare sempre dove si ferma il supporto dell'AI e dove interviene la responsabilità legale e contrattuale del professionista abilitato (timbro, firma, perizia).

3. Struttura delle Skill e Progressive Disclosure

Struttura del repository: skills/ (skill per famiglia), agents/ (agenti multi-skill), scripts/ (installer e uninstaller), docs/ (template e documentazione).

Tutte le skill in skills/ seguono lo standard aperto SKILL.md:

• Frontmatter YAML: Deve includere obbligatoriamente name (kebab-case) e description (3a persona con trigger espliciti).
• Sezioni standard:
  • Scope (cosa fa)
  • NON fa (limiti e confini espliciti)
  • Normativa di riferimento (articoli e norme pertinenti)
  • Workflow (fasi operative deterministiche)
  • Anti-pattern (tabella con errore tipico e relativa correzione)
  • Output (struttura attesa)
  • Limiti (avvertenze deontologiche e tecniche)

4. Agenti Multi-Skill Disponibili

5. Compatibilità Ecosistemi

Gli script in scripts/install.ps1 e scripts/install.sh consentono di installare la libreria per:

• Claude Code: in ~/.claude/skills/ e ~/.claude/agents/
• Google Antigravity: in ~/.gemini/config/skills/ (o .agents/skills/)
• Cursor: in ~/.cursor/skills/ (o .cursor/skills/)