convez.ai
PluginAutomaçãoAvançado
mario1111025

FM CMMS Optimizer – Orquestrador de Manutenção com IA

mario1111025/fm-cmms-optimizer

Motor de triagem de manutenção com IA para gestão inteligente de CMMS

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin que transforma Claude em um co-piloto de operações de manutenção, automatizando triagem de ordens de trabalho, priorização por severidade e otimização de CMMS. Integra-se com plataformas como Maintenance Connection e Fiix para análise de histórico de ativos e sugestões de agendamento inteligente.

Instalação

$npx convez-ai mario1111025/fm-cmms-optimizer

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Triagem automática de ordens de serviço por criticidade (emergência, urgente, rotina, planejado)
  • Análise de histórico de ativos para identificar problemas recorrentes e manutenção preditiva
  • Geração de scores de prioridade combinando risco de segurança, custo de parada e contexto operacional
  • Integração com CMMS existente (Fiix, UpKeep, Maintenance Connection) para enriquecimento de dados

Veredito

Solução robusta e madura para gestores de facilidades que precisam escalar triagem de manutenção com IA, eliminando dependência de planilhas e anotações. Excelente integração com CMMS real, suporte multilíngue e lógica de scoring sofisticada; requer configuração inicial e conhecimento de CMMS do usuário.

README

A tradução para o português deste README ainda está na fila.

Facility Maintenance AI Orchestrator – CMMS Workflow Automation for Claude

Download

Transform your facility management triage process with an AI-powered decision engine that speaks the language of maintenance, work orders, and CMMS optimization. Built for teams who want to move beyond spreadsheets and sticky notes, this tool turns Claude into your maintenance operations co-pilot.


🧭 Overview – Why This Exists

Every facility manager knows the pain: a flood of incoming maintenance requests, urgent vs. routine ambiguity, and a CMMS that feels more like a burden than a benefit. This repository delivers a structured triage plugin that integrates with Claude, enabling it to assess work orders, prioritize by severity, cross-reference asset history, and suggest optimal scheduling – all without leaving the conversation.

Think of it as a digital maintenance foreman that never sleeps, never misplaces a work order, and always remembers which HVAC unit has been flagged three times this quarter.


🔍 Key Features – What Makes This Different

  • Work Order Triage Engine – Automatically classify incoming requests into emergency, urgent, routine, or planned categories using contextual analysis.
  • CMMS Integration Layer – Parse, validate, and enrich data from popular CMMS platforms (e.g., Maintenance Connection, Fiix, UpKeep) before passing it to Claude.
  • Asset History Assembler – Fetch and summarize historical repair data for any asset, spot recurring issues, and flag predictive maintenance opportunities.
  • Priority Scoring Algorithm – Combines urgency (safety risk, downtime cost) with operational context (seasonal load, spare parts availability) to generate a triage score.
  • Multilingual Support – Accept and process work orders in 12+ languages (English, Spanish, French, German, Mandarin, Arabic, Portuguese, Italian, Dutch, Korean, Japanese, Russian).
  • Responsive Conversation UI – Works seamlessly in web, mobile, and desktop Claude clients; adapts output length and formatting to screen size.
  • 24/7 Customer Support Ready – Designed to operate as a backend service for help desks, with structured error handling and escalation pathways.
  • Zero Training Data Required – No fine-tuning; works out of the box with Claude's existing capabilities and a minimal configuration file.

📦 How It Works – The Mermaid Diagram

graph TD
    A[Incoming Work Order] --> B{Triage Plugin}
    B --> C[Parse Request Details]
    C --> D[Asset History Lookup]
    D --> E[Priority Scoring Engine]
    E --> F{Criticality Assessment}
    F -->|Emergency| G[Immediate Dispatch]
    F -->|Urgent| H[Schedule within 4 Hours]
    F -->|Routine| I[Add to Weekly Queue]
    F -->|Planned| J[Defer to Next Scheduled Window]
    G --> K[Generate Work Order Summary]
    H --> K
    I --> K
    J --> K
    K --> L[Return Structured Output to Claude]
    L --> M[Facility Manager Reviews]

⚙️ Example Profile Configuration

Create a file named triage_profile.yaml in the plugin directory with the following structure:

profile_name: "Downtown Medical Campus - Facility Team"
language: "en"
cmmos_platform: "fiix"
asset_priorities:
  - asset_type: "HVAC_Chiller"
    criticality: "critical"
    priority_boost: 2.0
  - asset_type: "Elevator"
    criticality: "critical"
    priority_boost: 1.8
  - asset_type: "Lighting_Fixture"
    criticality: "standard"
    priority_boost: 1.0
response_format: "concise_with_metadata"
escalation_threshold: 8.5
historical_depth_months: 18

🖥️ Example Console Invocation

Once configured, invoke the triage plugin directly from Claude's console or API:

/user invoke fm-triage-plugin --work-order "Elevator 3 in Building B is making grinding noises, occupied floors 5-12, reported by security at 08:45. Last repair was 45 days ago for bearing replacement."

Output:
{
  "asset_id": "ELEV-003-B",
  "classification": "urgent_mechanical",
  "priority_score": 8.9,
  "suggested_action": "Dispatch mechanical team within 2 hours. Note: bearing replacement history suggests possible repeat failure.",
  "parts_needed": ["bearing_assembly_kit", "lubricant_industrial"],
  "estimated_downtime_hours": 3.5
}

🧰 Emoji OS Compatibility Table

Operating SystemStatusNotes
Windows 10/11✅ Full SupportEmoji rendering in terminal and Claude UI works natively
macOS Monterey+✅ Full SupportIncludes emoji in markdown output and error messages
Ubuntu 22.04+⚠️ PartialRequires fonts-noto-color-emoji package for complete rendering
CentOS 9+⚠️ PartialInstall google-noto-emoji-fonts for best experience
iOS 17+✅ Full SupportWorks in mobile Claude app with adaptive UI
Android 14+✅ Full SupportOptimized for smaller screens and touch interaction

🧬 SEO-Friendly Keyword Integration

This repository targets high-value search terms for facility management professionals, including: FM triage automation, Claude maintenance plugin, AI work order assessment, CMMS optimization tool, predictive maintenance AI, facility management decision engine, maintenance priority scoring, asset history analyzer, multilingual facility AI, and 24/7 maintenance support automation. These keywords appear naturally throughout the documentation and code comments to improve discoverability without sacrificing readability.


🌐 OpenAI API and Claude API Integration

While this plugin is optimized for Claude by Anthropic, it includes a compatibility layer for OpenAI API (GPT-4 and GPT-4o models). Switch between providers by setting the AI_PROVIDER environment variable:

  • Claude API (default): Uses Claude 3 or 3.5 models with tool-use capabilities.
  • OpenAI API: Maps triage functions to function-calling schema; supports GPT-4-turbo and GPT-4o.

Both paths produce identical output structures, so your downstream workflows remain unchanged regardless of the AI provider you choose.


📋 Full Feature List

  • Work order classification engine (emergency/urgent/routine/planned)
  • Asset history retrieval and summarization
  • Priority scoring with configurable weights
  • Multilingual input parsing (12+ languages)
  • CMMS platform abstraction layer
  • Responsive UI formatting (mobile/desktop)
  • Structured error handling with escalation logic
  • Zero-configuration startup (sensible defaults)
  • Support for custom asset taxonomies
  • Downloadable diagnostic logs (debug mode)
  • 24/7 customer support integration endpoints
  • YAML-based profile configuration
  • Console invocation with JSON output
  • API-compatible output for webhook integrations

⚠️ Disclaimer

This tool is designed as a decision support system for facility management teams, not a replacement for human judgment. While it performs triage assessments based on input data, it does not guarantee accuracy of asset history, correctness of priority scores, or completeness of work order classification. Always verify critical maintenance decisions with a qualified facility manager or engineer. The authors assume no liability for damages arising from use or misuse of this software. Use at your own risk.


📜 License

This project is licensed under the MIT License – see the LICENSE file for details. You are free to use, modify, and distribute this software for commercial or personal projects, provided the original copyright notice is included.


🚀 Getting Started in 2026

  1. Download the latest release using the badge at the top of this README.
  2. Follow the Quick Start guide in the /docs folder (coming soon).
  3. Configure your first profile using the example above.
  4. Invoke the plugin from Claude or any OpenAI-compatible client.

Download


Built for facility managers who deserve better tools. No more lost work orders. No more triage by gut feeling. Just structured, AI-powered clarity.

Ver o original no GitHub

Bom para

Relacionados