Agent skill · product strategy · jeremylongshore
maintainx-reference-architecture
Production-grade architecture patterns for MaintainX integrations.
Why this skill is useful
Provides specific architecture patterns and code examples for integrating MaintainX with enterprise systems that the AI wouldn't generate on its own.
What it needs
About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
MaintainX Reference Architecture Overview Production-grade architecture patterns for building scalable, maintainable integrations between MaintainX and enterprise systems (ERP, SCADA, data warehouses). Prerequisites Understanding of distributed systems Cloud platform experience (GCP, AWS, or Azure) MaintainX API familiarity Instructions Step 1: Event-Driven Sync Architecture The recommended architecture for most MaintainX integrations. Uses webhooks for real-time updates and scheduled jobs for reconciliation. Step 2: Bi-Directional Sync Gateway For integrating MaintainX with ERP systems (SAP, Oracle) where changes flow both ways. Step 3: Analytics Data Pipeline Step 4: Multi-Site Architecture Output Event-driven architecture with Pub/Sub for decoupled processing Bi-directional sync gateway with conflict resolution and audit trail Analytics pipeline calculating maintenance KPIs (MTTR, PM compliance) Multi-site architecture with per-site API key isolation Error Handling Pattern Failure Mode Mitigation --------- ------------- ------------ Event-driven Pub/Sub delivery failure Dead letter queue, retry policy Bi-directional sync Conflict on same record Last-write-wins or manual resolution Analytics pipeline Incomplete data fetch Retry with backfill, validate counts Multi-site One site API key expired Independent health checks per site Resources MaintainX API Reference Google Cloud Pub/Sub Event-Driven Architecture Next Steps For multi-environment setup, see maintainx-multi-env-setup. Examples SCADA integration (pulling sensor data into MaintainX work orders):
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-reference-architecture--8a8f20