pf-maintenance-logs

professionally structured CMMS Plugin for Manufacturing — OSHA/EPA/NFPA Compliant

Manage equipment maintenance with regulatory compliance checking, ISO 14224 failure classification, SEMI E10 reliability metrics, and ANSI/NETA PM interval standards for small manufacturing shops.

Installation

1. Download the pf-maintenance-logs.plugin file
2. Open Claude Desktop and navigate to Settings > Plugins
3. Click Install Plugin and select the downloaded .plugin file
4. The plugin will be installed and available immediately

Note: All data stays local on your machine. No external API calls or cloud storage required.

Overview

The pf-maintenance-logs plugin is a cost-effective alternative to commercial maintenance software (UpKeep $540-900/yr, Fiix $540-900/yr, eMaint $400-1,200/yr per user) with an professionally structured, document-driven solution backed by 22 industry standards and regulations. It provides:

• Preventive Maintenance Scheduling: AI-ranked PM schedules with SMRP 5.5.6 compliance metrics and ANSI/NETA MTS interval validation
• Maintenance Event Logging: ISO 14224:2016 failure mode classification with OSHA LOTO verification tracking
• Work Order Management: AI priority recommendations with OSHA LOTO (29 CFR 1910.147), confined space (29 CFR 1910.146), and hot work (NFPA 51B) safety checklists
• Downtime Analysis: OEE per SEMI E10-0814, SMRP planned-vs-reactive benchmarking, and 5-Why/Ishikawa root cause prompts
• Regulatory Compliance Checking: Gap analysis against OSHA, EPA, NFPA, and SMRP standards with risk-rated findings
• Reliability Engineering: MTBF/MTTR/OEE calculations with bathtub curve analysis and SAE JA1011 RCM task recommendations
• Domain Knowledge Base: 22 regulatory and industry standard references with specific section/article citations
• Equipment Registry: ISO 55001-aligned fleet database with API 580 criticality classifications

Quick Start

1. Initialize workspace:

   /maintenance:maintenance-setup
   

2. Generate PM schedule (once equipment is registered):

   /maintenance:maintenance-pm-schedule
   

3. Log maintenance events:

   /maintenance:maintenance-log
   

4. Create work orders:

   /maintenance:maintenance-work-order
   

5. Analyze downtime patterns:

   /maintenance:maintenance-downtime
   

6. View dashboard:

   /maintenance:maintenance-logs-dashboard
   

7. Run compliance check:

   /maintenance:maintenance-compliance-check
   

8. Calculate reliability metrics:

   /maintenance:maintenance-mtbf
   

9. Look up domain knowledge:

   /maintenance:maintenance-kb
   

10. View current status:

    /maintenance:maintenance-status
    

Features

AI-Powered Features (11)

• PM Priority Ranking: Ranks equipment by urgency score using API 580 criticality weights × days overdue
• SMRP PM Compliance Tracking: Calculates PM Compliance Rate per SMRP Metric 5.5.6 (target ≥90%)
• ANSI/NETA Interval Validation: Flags PM intervals that deviate from ANSI/NETA MTS recommended frequencies
• Work Order Priority Recommendation: API 580 risk-based priority with OSHA LOTO/confined space/hot work safety checks
• ISO 14224 Failure Classification: AI-assisted failure mode coding from ISO 14224:2016 taxonomy for 5 equipment categories
• Downtime Root Cause Analysis: OEE per SEMI E10-0814 with 5-Why/Ishikawa framework prompts
• SMRP Planned-vs-Reactive Benchmarking: Compares maintenance mix against SMRP 5.5.2 target (≥80% planned)
• OSHA/EPA/NFPA Compliance Gap Analysis: Audits maintenance program against 29 CFR 1910.147, 40 CFR 82, NFPA 70B
• MTBF/MTTR/OEE Reliability Metrics: Per SEMI E10-0814 definitions with world-class benchmarks
• Bathtub Curve Positioning: Identifies equipment in infant mortality, useful life, or wear-out phases
• RCM Task Recommendations: SAE JA1011 §8.1-8.4 task selection based on failure patterns

Flexible Equipment Management

• Equipment criticality levels: Critical, High, Medium, Low
• Configurable PM intervals
• Location and technician tracking
• Historical maintenance records

Document Generation

• Professional DOCX templates for all reports
• Automated placeholder population
• Printable work orders and schedules
• Historical archive of all documents

Data-Driven Insights

• Total downtime tracking
• Maintenance event categorization (Preventive, Corrective, Emergency)
• Chronic failure detection
• Equipment reliability metrics

File Structure

pf-maintenance-logs/
├── .claude-plugin/
│   └── plugin.json              # Plugin metadata
├── skills/
│   ├── maintenance-setup/
│   │   └── SKILL.md             # Initialize workspace with regulatory reference data
│   ├── maintenance-pm-schedule/
│   │   └── SKILL.md             # Generate PM schedule with SMRP/NETA metrics
│   ├── maintenance-log/
│   │   └── SKILL.md             # Record events with ISO 14224 failure codes
│   ├── maintenance-work-order/
│   │   └── SKILL.md             # Create work orders with OSHA safety checks
│   ├── maintenance-downtime/
│   │   └── SKILL.md             # Analyze downtime with OEE per SEMI E10
│   ├── maintenance-kb/
│   │   └── SKILL.md             # Domain knowledge base (22 standards)
│   ├── maintenance-compliance-check/
│   │   └── SKILL.md             # OSHA/EPA/NFPA compliance gap analysis
│   └── maintenance-mtbf/
│       └── SKILL.md             # MTBF/MTTR/OEE reliability metrics
├── commands/
│   ├── maintenance-setup.md
│   ├── maintenance-pm-schedule.md
│   ├── maintenance-log.md
│   ├── maintenance-work-order.md
│   ├── maintenance-downtime.md
│   ├── maintenance-kb.md
│   ├── maintenance-compliance-check.md
│   ├── maintenance-mtbf.md
│   ├── maintenance-pipeline.md  # Combined setup + PM schedule
│   └── maintenance-status.md    # View workspace status
├── templates/
│   ├── pm-schedule-base.docx
│   ├── maintenance-log-base.docx
│   ├── work-order-base.docx
│   └── README.md
├── README.md                    # This file
├── USER-GUIDE.md                # Detailed user instructions
├── CHANGELOG.md                 # Version history
└── LICENSE

Skills & Commands (8 skills, 10 commands)

maintenance-setup (Stage 0)

Initializes the workspace with ISO 55001-aligned directory structure, API 580 criticality equipment registry, and regulatory reference data (OSHA/EPA/NFPA, ISO 14224, ANSI/NETA MTS, SMRP).

No AI — Procedural only (now populates 4 reference data files)

maintenance-pm-schedule (Stage 1)

Generates a ranked PM schedule with SMRP 5.5.6 compliance metrics and ANSI/NETA MTS interval validation.

AI Component: PM Priority Ranking (API 580 criticality × days overdue), SMRP PM task codes, OSHA LOTO reminders

maintenance-log (Stage 2)

Records a maintenance event with ISO 14224:2016 failure mode classification and OSHA LOTO verification.

AI Component: ISO 14224 failure mode suggestion for Corrective/Emergency events

maintenance-work-order (Stage 3)

Creates a work order with safety-integrated priority recommendation including OSHA LOTO, confined space, and hot work checks.

AI Component: API 580 risk-based priority, OSHA 29 CFR 1910.147 LOTO, 29 CFR 1910.146 confined space, NFPA 51B hot work

maintenance-downtime (Stage 4)

Analyzes downtime with OEE per SEMI E10 and SMRP planned-vs-reactive benchmarking.

AI Component: OEE calculation, ISO 14224 classification, 5-Why/Ishikawa prompts, API 580 risk-weighted impact

maintenance-kb (Reference)

Centralized domain knowledge base covering 22 regulatory and industry standards.

No AI — Reference data lookup with professionally structured contextualization

maintenance-compliance-check (Stage 5)

Audits maintenance program against OSHA, EPA, NFPA, and SMRP standards.

AI Component: Compliance gap analysis, SMRP maturity model positioning, risk-rated findings

maintenance-mtbf (Stage 6)

Calculates equipment reliability metrics with SEMI E10 benchmarking and SAE JA1011 RCM recommendations.

AI Component: MTBF/MTTR/OEE, bathtub curve analysis, Weibull indicators, RCM task selection

maintenance-pipeline

Runs setup + PM schedule generation in sequence.

maintenance-status

Displays current equipment registry, recent logs, and workspace summary.

Data Files

The workspace uses JSON files stored in processing/:

• equipment-registry.json: Equipment fleet with criticality, PM intervals, last PM date
• maintenance-log-history.json: Append-only log of all maintenance events
• pm-schedule-db.json: PM schedule tracking and metadata
• work-order-config.json: Work order counter and status tracking

Generated documents are stored in outbound/:

• PM-Schedule-{YYYY-MM-DD}.docx
• LOG-{equipment_id}-{YYYY-MM-DD}.docx
• WO-{number}-{YYYY-MM-DD}.docx
• DOWNTIME-{YYYY-MM-DD}.docx

Estimated Cost per Use

Disclaimer: Token estimates are approximate and based on typical usage patterns measured from skill prompt sizes. Actual costs vary with input data size, conversation length, and complexity. Estimates use Claude Sonnet 4.6 pricing ($3/1M input, $15/1M output). Cowork and Claude Desktop subscription users (Pro/Max/Team) are not charged per-token — these estimates apply only to direct Anthropic API usage. Running stages individually in fresh sessions uses fewer input tokens than running the full pipeline sequentially, because pipeline mode accumulates conversation history across stages.

Per skill (run individually in a fresh session):

Stage	Skill Prompt	User Input	Total Input	Output	Est. Cost
maintenance-log	~4.0K	~800	~7.6K	~4.0K	~$0.08
maintenance-kb	~2.4K	~800	~5.9K	~3.0K	~$0.06
maintenance-work-order	~4.6K	~800	~10.3K	~4.6K	~$0.10
maintenance-compliance-check	~4.9K	~800	~8.4K	~4.0K	~$0.09
maintenance-dashboard	~3.4K	~500	~6.7K	~8.0K	~$0.14
maintenance-downtime	~5.6K	~800	~11.7K	~5.6K	~$0.12
maintenance-pm-schedule	~4.1K	~800	~9.3K	~4.1K	~$0.09
maintenance-mtbf	~5.0K	~800	~8.5K	~5.0K	~$0.10
Standalone total			~68.4K	~38.2K	~$0.78

Full pipeline (all stages in one session — context accumulates):

Stage	Base Input	+ History	Total Input	Output	Est. Cost
maintenance-log	~9.8K	0	~9.8K	~4.0K	~$0.09
maintenance-kb	~8.2K	~4.8K	~13.0K	~3.0K	~$0.08
maintenance-work-order	~10.5K	~8.6K	~19.1K	~4.6K	~$0.13
maintenance-compliance-check	~10.8K	~14.0K	~24.8K	~4.0K	~$0.13
maintenance-dashboard	~8.9K	~18.8K	~27.7K	~8.0K	~$0.20
maintenance-downtime	~11.4K	~27.3K	~38.7K	~5.6K	~$0.20
maintenance-pm-schedule	~10.0K	~33.7K	~43.6K	~4.1K	~$0.19
maintenance-mtbf	~10.8K	~38.6K	~49.4K	~5.0K	~$0.22
Pipeline total			~226.3K	~38.2K	~$1.25

Running the full pipeline once typically costs $0.88–$1.63 in API tokens (Claude Sonnet 4.6).

Requirements

• Python 3.7+
• python-docx library (automatically installed by /maintenance:maintenance-setup)
• Workspace directory structure (created automatically)

Version

Current version: 1.1

Author: Plugin Factory

Feature Comparison: pf-maintenance-logs vs Commercial CMMS

Feature	pf-maintenance-logs v1.1	UpKeep ($540-900/yr)	Fiix ($540-900/yr)
PM Scheduling	✅ SMRP/NETA-aligned	✅ Basic	✅ Basic
Work Orders	✅ OSHA safety integrated	✅ Basic	✅ Basic
Compliance Checking	✅ OSHA/EPA/NFPA	❌ None	❌ None
Reliability Metrics	✅ MTBF/OEE/RCM	❌ Limited	✅ Basic
Failure Classification	✅ ISO 14224	❌ None	❌ None
Domain Knowledge	✅ 22 standards	❌ None	❌ None
Data Privacy	Local processing	❌ Cloud only	❌ Cloud only
Cost	✅ $0	❌ $540-900/yr	❌ $540-900/yr

AI-Powered Features (11)

• PM Priority Ranking: API 580 criticality-weighted urgency scoring for preventive maintenance
• SMRP PM Compliance Tracking: PM Compliance Rate per SMRP Metric 5.5.6 (target ≥90%)
• ANSI/NETA Interval Validation: Flags deviations from ANSI/NETA MTS recommended testing frequencies
• Work Order Priority Recommendation: API 580 risk-based priority with integrated OSHA safety checks
• ISO 14224 Failure Classification: AI-assisted failure mode coding from ISO 14224:2016 taxonomy
• OEE Calculation: Overall Equipment Effectiveness per SEMI E10-0814 with world-class benchmarks
• SMRP Planned-vs-Reactive Benchmarking: Maintenance mix analysis against SMRP 5.5.2 targets
• OSHA/EPA/NFPA Compliance Gap Analysis: Multi-regulation audit with risk-rated findings
• MTBF/MTTR Reliability Metrics: Per SEMI E10-0814 definitions with fleet-level aggregation
• Bathtub Curve Analysis: Equipment lifecycle positioning (infant mortality, useful life, wear-out)
• RCM Task Recommendations: SAE JA1011 §8.1-8.4 task selection based on failure patterns

Support

For detailed instructions, see USER-GUIDE.md

For version history, see CHANGELOG.md

---

An alternative to UpKeep, Fiix, or eMaint — no subscription required with professionally structured, standards-compliant maintenance management — backed by 22 industry regulations and standards, for $0.

Commands

• /maintenance:maintenance-compliance-check — Execute Skill
• /maintenance:maintenance-downtime — Execute Skill
• /maintenance:maintenance-kb — Execute Skill
• /maintenance:maintenance-log — Execute Skill
• /maintenance:maintenance-mtbf — Execute Skill
• /maintenance:maintenance-pipeline — Execute Skill
• /maintenance:maintenance-pm-schedule — Execute Skill
• /maintenance:maintenance-setup — Execute Skill
• /maintenance:maintenance-status — Execute Skill
• /maintenance:maintenance-work-order — Execute Skill

Important Disclaimers

• AI-Generated Content: This plugin uses AI (LLM) technology which can produce inaccurate or incomplete outputs. All content should be treated as a starting point and reviewed for accuracy before use.
• Not Professional Advice: Outputs do not constitute legal, financial, tax, medical, or other professional advice. Consult qualified professionals before making decisions based on generated content.
• No Compliance Guarantee: References to industry standards, regulations, or guidelines are for informational purposes only. This plugin does not guarantee compliance with any law or regulation. Users are responsible for verifying all outputs meet their specific regulatory requirements.
• No Endorsement or Affiliation: Mention of third-party products, standards, or organizations does not imply endorsement, partnership, or certification by those entities.