maintenance-cmms
Skill1 starsChanged 2 months agoMITView on GitHub
Integrazione dei dati AIM BIM con sistemi di gestione manutenzione (CMMS/CAFM), redazione del Piano di Manutenzione dell'Opera (D.Lgs. 36/2023 All. I.7 Art. 33), programmazione preventiva e matrici di criticita secondo UNI EN ISO 19650-3, UNI 11257, UNI 10604 e UNI EN 13306. Usare per automatizzare ordini di lavoro (OdL) e retro-alimentare l'as-maintained.
In this repository34 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- construction-sequencingSkill
- materials-traceabilitySkill
- quantities-cost-linkingSkill
- aim-constructionSkill
- digital-twin-analyticsSkill
- grasshopperSkill
- pyrevitSkill
- revit-apiSkill
- revit-cpp-pluginSkill
- revit-dynamoSkill
- rhino-inside-revitSkill
- rhinoSkill
- cde-configurationSkill
- cde-cybersecuritySkill
- cde-workflowSkill
- bim-executionSkill
- construction-supervision-handoverSkill
- information-delivery-planningSkill
- information-protocolSkill
- safety-coordination-bimSkill
- sgpd-management-systemSkill
- clash-detectionSkill
- e-permit-complianceSkill
- gis-bim-georeferencingSkill
- ifc-loin-validatorSkill
- infrastructure-ifc-linearSkill
- naming-spatial-structureSkill
- normative-code-checkingSkill
- ci-draftingSkill
- ogi-evaluationSkill
- pgi-consolidationSkill
- project-validation-auditSkill
The file
Files
BIM Maintenance Strategy & CMMS/CAFM Integration
Assistente specialistico per il Maintenance Manager, il Facility Director, l'Ingegnere di Manutenzione e il BIM Coordinator O&M nella progettazione e digitalizzazione del Piano di Manutenzione dell'Opera (obbligatorio a norma del D.Lgs. 36/2023 - Allegato I.7 Art. 33), nella definizione delle strategie manutentive (preventiva, correttiva, su condizione ex UNI EN 13306 e UNI 11257) e nell'integrazione bidirezionale tra l'Asset Information Model (AIM) e le piattaforme gestionali CMMS/CAFM/IWMS (IBM Maximo, SAP PM, Infor EAM, Planon, Archibus) tramite lo standard aperto COBie.
Scope
Questa skill guida l'ingegneria e la digitalizzazione dei servizi manutentivi del patrimonio immobiliare:
- Redazione Digitale del Piano di Manutenzione dell'Opera (D.Lgs. 36/2023 All. I.7 Art. 33 & UNI 11257):
- Manuale d'Uso: istruzioni d'impiego corretto e prescrizioni d'esercizio per gli utenti;
- Manuale di Manutenzione: protocolli di intervento, schede di sicurezza, diagnosi anomalie e verifiche per i manutentori;
- Programma di Manutenzione: scadenziario temporale dei controlli e interventi preventivi, risorse necessarie e budget stimato.
- Integrazione Dati AIM ↔ CMMS (Asset Register Onboarding): mappatura ed estrazione dei record COBie (
Component,Type,Job,Spare,Resource) per il caricamento automatizzato dell'anagrafica cespiti nei sistemi gestionali. - Analisi di Criticità e Prioritizzazione degli Asset (Metodologia RCM / FMECA): classificazione del rischio di guasto basata su Probabilità di accadimento (P) e Gravità dell'impatto sulla sicurezza, continuità operativa o conformità normativa (G).
- Gestione del Ciclo di Vita degli Ordini di Lavoro (Work Orders - OdL): definizione dei flussi di lavoro dalla segnalazione guasto, all'assegnazione alla squadra, alla consuntivazione delle ore e dei ricambi, fino alla chiusura contabile.
- Retro-alimentazione Bidirezionale (As-Maintained Model): aggiornamento continuo dell'AIM con i dati operativi di cantiere/esercizio (data ultimo intervento, sostituzione componenti, ore moto, indice di degrado).
- Controllo dei Livelli di Servizio (SLA & KPI Manutentivi ex UNI 10604): calcolo dei tempi medi di riparazione (MTTR), tempo medio tra i guasti (MTBF) e disponibilità operativa degli impianti critici.
NON fa
- Non sostituisce la manodopera tecnica o gli operai specializzati nell'esecuzione fisica delle riparazioni in campo.
- Non acquista direttamente materiali di ricambio o servizi di manutenzione (attività amministrativo-commerciale del committente).
- Non certifica la conformità degli impianti a gas o elettrici ex D.M. 37/08 (riservata a ditte abilitate con rilascio di Dichiarazione di Conformità Di.Co.).
Normativa di Riferimento
- D.Lgs. 36/2023 & D.Lgs. 209/2024:
- Allegato I.7, Art. 33: Piano di manutenzione dell'opera come documento progettuale obbligatorio a corredo del Progetto Esecutivo (strutturato in Manuale d'Uso, Manuale di Manutenzione e Programma di Manutenzione);
- Allegato I.9, Art. 11: Transizione digitale dei collaudi e presa in carico per la gestione O&M.
- UNI 11257:2007:
- Manutenzione dei patrimoni immobiliari - Criteri per la stesura del piano e del programma di manutenzione dei beni edilizi. Linee guida nazionali per l'articolazione per subsistemi e componenti.
- UNI 10604:1997:
- Criteri di progettazione, gestione e controllo dei servizi di manutenzione di immobili. Requisiti dei sistemi informativi manutentivi (CMMS).
- UNI EN 13306:2018 & UNI 10147:
- Terminologia della manutenzione (manutenzione preventiva, correttiva, su condizione, predittiva, migliorativa).
- UNI EN ISO 19650-3:2021:
- Gestione informativa dell'esercizio del cespite e consumo dei dati AIM nei processi di Facility Management.
- COBie Standard (BS 1192-4:2014):
- Fogli
Job(operazioni di manutenzione),Resource(competenze) eSpare(parti di ricambio).
- Fogli
Matrice di Integrazione AIM (IFC/COBie) ↔ CMMS
La tabella illustra il flusso di popolamento automatico dal modello al sistema gestionale:
| Entità IFC / Campo COBie | Campo di Destinazione CMMS | Significato Operativo | Frequenza di Aggiornamento |
IfcPump.Tag / COBie.Component.Name | Asset ID / Matricola Cespite | Identificativo univoco scansionabile tramite barcode/QR-code | Creazione iniziale (Handover) |
COBie.Component.Space | Location / Stanza | Ubicazione fisica per la navigazione del manutentore | Ad ogni cambio layout |
COBie.Type.Manufacturer + Model | Equipment Specification | Scheda costruttore per ordini di acquisto ricambi | Al cambio fornitore |
Pset_Warranty.WarrantyEndDate | Warranty Expiry Alert | Genera alert automatico per interventi in garanzia gratuita | Monitoraggio continuo |
COBie.Job.Task + Frequency | Preventive Maintenance Schedule | Attività periodica automatica (es. pulizia filtri trimestrale) | Schedulazione programmata |
COBie.Spare.PartNumber | Spare Parts Inventory | Codice articolo di magazzino per il riordino | Ad ogni consuntivazione |
CMMS.WorkOrder.CompletionDate | Pset_Asset.LastMaintenanceDate | Retro-alimentazione AIM: data dell'ultimo controllo eseguito | Post chiusura OdL |
CMMS.AssetCondition.Score | Pset_Condition.Assessment | Stato d'uso reale: indice di degrado (da 1 = Ottimo a 5 = Critico) | Annuale |
Workflow Operativo di Gestione della Manutenzione
graph TD
A[AIM As-Built IFC + Dataset COBie] --> B[Fase 1: Classificazione Criticità Asset FMECA<br>P x G = Indice Rischio & Strategia Manutentiva]
B --> C[Fase 2: Redazione Piano di Manutenzione<br>Manuale Uso, Manuale Manutenzione, Programma UNI 11257]
C --> D[Fase 3: Popolamento CMMS<br>Caricamento Asset, Schede Job, Garanzie, Ricambi]
D --> E[Fase 4: Esecuzione & Gestione OdL<br>Assegnazione Ticket, Consuntivazione Ore e Materiali]
E --> F[Fase 5: Retro-alimentazione AIM<br>Aggiornamento Storico Manutenzioni nel Modello]
F --> G[Fase 6: Dashboard KPI Manutentivi<br>Monitoraggio MTTR, MTBF, Costi O&M]Fase 1: Matrice di Rischio e Strategie Manutentive (FMECA)
Gli asset estratti dall'AIM vengono suddivisi in 3 classi di criticità per calibrare le risorse:
| Classe di Rischio | Tipologia di Asset Esemplari | Strategia Manutentiva Primaria | Frequenza Controlli | SLA Intervento su Guasto |
| Classe A (Criticità Alta) | Gruppi elettrogeni ospedalieri, pompe antincendio, quadri MT/BT, UTA sale operatorie. | Manutenzione Preventiva Ciclica + Su Condizione (IoT) con monitoraggio continuo vibrazioni e temperature. | Settimanale / Mensile | ≤ 2 ore (H24/365) con penali contrattuali |
| Classe B (Criticità Media) | Pompe di circolazione riscaldamento, caldaie secondarie, condizionatori uffici, ascensori. | Manutenzione Preventiva Programmata secondo manuale costruttore (UNI 11257). | Trimestrale / Semestrale | ≤ 8 ore lavorative |
| Classe C (Criticità Bassa) | Lampade ordinarie, porte interne di servizio, sanitari, tinteggiature, arredi. | Manutenzione Correttiva a Guasto (Run-to-Failure) programmata su chiamata. | Su segnalazione ticket | ≤ 48 ore lavorative |
Fase 2: Script Python per Generazione Piano di Manutenzione (generate_maintenance_plan.py)
import csv
import ifcopenshell
import ifcopenshell.util.element
def generate_maintenance_schedule(ifc_file_path, output_csv_path):
print(f"\n--- GENERAZIONE PIANO DI MANUTENZIONE DIGITALE (UNI 11257): {ifc_file_path} ---")
model = ifcopenshell.open(ifc_file_path)
# Template standard delle operazioni manutentive per categoria di apparecchio
standard_jobs = {
"IfcEnergyConversionDevice": [
{"operazione": "Controllo termografico connessioni elettriche", "frequenza": "Semestrale", "qualifica": "Tecnico Elettrico PES/PAV"},
{"operazione": "Verifica taratura sensori e sonde temperatura", "frequenza": "Annuale", "qualifica": "Specialista Strumentazione"}
],
"IfcFlowMovingDevice": [
{"operazione": "Controllo vibrazioni cuscinetti e allineamento giunti", "frequenza": "Trimestrale", "qualifica": "Manutentore Meccanico"},
{"operazione": "Ingrassaggio e verifica tenute meccaniche", "frequenza": "Semestrale", "qualifica": "Manutentore Meccanico"}
],
"IfcFlowTreatmentDevice": [
{"operazione": "Ispezione visiva e sostituzione pacco filtri aria", "frequenza": "Bimestrale", "qualifica": "Operatore Manutentore"},
{"operazione": "Sanificazione canalizzazioni e vasca raccolta condensa", "frequenza": "Semestrale", "qualifica": "Ditta Specializzata Sanificazione"}
]
}
maintenance_rows = []
for ifc_class, jobs in standard_jobs.items():
elements = model.by_type(ifc_class)
for elem in elements:
psets = ifcopenshell.util.element.get_psets(elem, psets_only=True)
asset_id = psets.get("Pset_Asset", {}).get("AssetIdentifier") or elem.Tag or elem.Name
space = ifcopenshell.util.element.get_container(elem)
space_name = space.Name if space else "N/D"
for job in jobs:
maintenance_rows.append({
"Asset_ID": asset_id,
"Asset_Name": elem.Name,
"IFC_Class": ifc_class,
"Location_Space": space_name,
"Task_Description": job["operazione"],
"Frequency": job["frequenza"],
"Required_Skill": job["qualifica"],
"CMMS_Job_Code": f"JOB_{ifc_class[:3].upper()}_{job['frequenza'][:3].upper()}"
})
# Scrittura su CSV strutturato
with open(output_csv_path, mode="w", encoding="utf-8", newline="") as f:
writer = csv.DictWriter(f, fieldnames=[
"Asset_ID", "Asset_Name", "IFC_Class", "Location_Space",
"Task_Description", "Frequency", "Required_Skill", "CMMS_Job_Code"
])
writer.writeheader()
writer.writerows(maintenance_rows)
print(f"Piano di manutenzione programmata generato con successo: {output_csv_path}")
print(f"Totale task periodici pianificati: {len(maintenance_rows)}")
return maintenance_rowsModello di Scheda Intervento e Ordine di Lavoro (OdL)
# ORDINE DI LAVORO DIGITALE (CMMS WORK ORDER) — OdL #2026-0892
**Cespite**: Centrale Termica Principale — Edificio A, Piano Interrato (`INT`)
**Asset Master**: Pompa di Ricircolo Primaria `PUMP-MEC-002` (GUID: `3vX_01$8rB4...`)
**Tipo Intervento**: Manutenzione Preventiva Programmata Semestrale (UNI 11257)
**Stato**: `Assegnato ad Operatore` — **Data Emissione**: 03/09/2026
## 1. Dati Tecnici dell'Apparecchiatura (da AIM/COBie)
- **Modello / Produttore**: Pompa In-Line Mod. Ets-65 / Grundfos
- **Matricola / Serial Number**: `SN-887412-2025`
- **Scadenza Garanzia Costruttore**: 31/12/2027 (Pset_Warranty ATTIVA)
- **Manuale Tecnico Allegato**: `DOC-O&M-GRUNDFOS-ETS65.pdf`
## 2. Protocollo di Manutenzione Obbligatorio
1. Eseguire procedura di Lockout/Tagout (LOTO) sezionando l'alimentazione elettrica dal quadro generale `QE-CT-01`.
2. Ispezione visiva di tenuta idraulica: assenza perdite sulle flange e guarnizioni.
3. Rilievo vibrazionale e temperatura corpo motore con termocamera portatile.
4. Ingrassaggio cuscinetti con lubrificante sintetico conforme a scheda tecnica.
## 3. Consuntivazione e Retro-alimentazione AIM (a cura del tecnico)
- **Ore Lavorate Effettive**: 2.5 ore
- **Ricambi Impiegati**: 1x Guarnizione EPDM DN65 (Codice Magazzino `SP-EPDM-65`)
- **Stato di Conservazione Rilevato**: Indice 1 (Ottimo stato d'uso)
- **Data Chiusura Intervento**: 04/09/2026
- **Firma Esecutore**: [Firma Digitale Manutentore]
*(La chiusura dell'OdL aggiorna automaticamente il parametro Pset_Asset.LastMaintenanceDate nel CDE di commessa).*Anti-pattern nell'Integrazione BIM ↔ CMMS
| Errore Tipico | Conseguenza Operativa | Regola Corretta |
| Generare un piano di manutenzione identico per tutti gli asset | Spreco di budget su asset non critici e trascuratezza di apparecchi vitali | Differenziare frequenze e strategie in funzione della matrice FMECA (Classi A, B, C). |
| Disallineare gli ID tra BIM e CMMS | Rottura definitiva del collegamento digitale: il CMMS non trova più l'oggetto nel modello | Mantenere l'AssetIdentifier come chiave primaria immutabile in entrambi i sistemi. |
| Importare nel CMMS solo i componenti senza i tipi | Perdita dei dati su ricambi, garanzie e produttori, costringendo a data entry manuale | Importare sempre congiuntamente i fogli COBie Component e Type. |
| Flusso dati unidirezionale (solo dal BIM al CMMS) | L'AIM invecchia e muore dopo la consegna, non registrando gli interventi reali | Implementare la sincronizzazione di ritorno (as-maintained) per aggiornare lo storico. |
| Omettere i requisiti minimi del Piano di Manutenzione ex All. I.7 Art. 33 | Rifiuto del progetto in sede di verifica/validazione della SA | Strutturare obbligatoriamente il piano nei 3 fascicoli: Manuale d'Uso, Manutenzione e Programma. |
Output Strutturato
Quando invocata, la skill genera:
- Piano di Manutenzione dell'Opera Completo conforme a D.Lgs. 36/2023 (Manuale d'Uso, Manutenzione e Programma).
- Matrice di Mapping Dati AIM ↔ CMMS/CAFM con corrispondenze campo per campo.
- Programma degli Interventi Preventivi Strutturato in CSV/Excel pronto per l'importazione in CMMS.
- Matrice di Criticità FMECA / RCM con classificazione dei rischi e degli SLA di ripristino.
- Template di Ordine di Lavoro Digitale (Work Order) integrato con il modello IFC.
Limiti
- La skill struttura la strategia, i dati tabellari e i template di interscambio; l'attivazione effettiva dei flussi di lavoro, delle notifiche push su smartphone e della contabilità manutentiva compete alla piattaforma CMMS installata.
- Le prescrizioni di sicurezza per interventi ad alto rischio (lavori in quota, spazi confinati, cabine elettriche MT) devono essere validate dal Responsabile del Servizio di Prevenzione e Protezione (RSPP).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

