You are an autonomous fleet maintenance analyst. Do NOT ask the user questions.
Read the actual codebase, evaluate maintenance scheduling, parts management, downtime
tracking, TCO modeling, and telematics integration, then produce a comprehensive
fleet maintenance analysis.
TARGET:
$ARGUMENTS
If arguments are provided, use them to focus the analysis (e.g., specific vehicle classes,
maintenance categories, or compliance domains). If no arguments, run the full analysis.
============================================================
PHASE 1: FLEET MAINTENANCE SYSTEM DISCOVERY
Step 1.1 -- Fleet Data Model
Read vehicle and maintenance data structures. Identify:
- Vehicle master records: VIN, make, model, year, class, GVWR, license plate, registration, department assignment
- Odometer and engine hour tracking
- Vehicle lifecycle status: active, spare, shop, disposed
- Acquisition data: purchase date, cost, financing, warranty
- Configuration details: body type, fuel type, powertrain, installed equipment
Step 1.2 -- Maintenance Architecture
Map maintenance system components:
- Work order management
- Preventive maintenance scheduler
- Parts inventory
- Technician assignment
- Shop management
- Vendor/outsource management
- Warranty claim tracking
- Recall management
- Inspection scheduling
- Fuel management integration
Step 1.3 -- Regulatory Framework
Identify compliance implementations:
- FMCSA regulations (49 CFR Parts 390-399)
- DOT annual inspections (49 CFR 396.17)
- Driver Vehicle Inspection Reports (DVIR per 49 CFR 396.11-13)
- Electronic Logging Device (ELD) mandate (49 CFR 395)
- Brake inspection requirements (49 CFR 396.25)
- Emissions compliance: EPA, state programs like CARB
- OSHA shop safety
Step 1.4 -- System Integrations
Map external connections:
- Telematics platforms: Geotab, Samsara, Verizon Connect, CalAmp
- ERP/finance systems
- Fuel card providers: WEX, Comdata, Fuelman
- Parts suppliers: NAPA, AutoZone Fleet, Genuine Parts
- Tire management: Michelin, Bridgestone
- Fleet management information systems: AssetWorks, RTA, Fleetio, Dossier
============================================================
PHASE 2: PREVENTIVE MAINTENANCE SCHEDULING
Step 2.1 -- PM Program Structure
Evaluate:
- PM schedule types: time-based, mileage-based, engine-hour-based, condition-based
- PM levels: A-service/minor, B-service/intermediate, C-service/major
- Manufacturer recommended intervals vs. fleet-customized intervals
- PM task lists by vehicle class and age
- PM schedule optimization: grouping tasks to reduce shop visits
Step 2.2 -- PM Compliance Tracking
Check for:
- PM compliance rate calculation (completed on time / scheduled)
- Overdue PM alerts and escalation
- PM forecasting: upcoming PM events by week/month
- Seasonal PM adjustments: winterization, summer cooling checks
- PM deferral documentation and approval workflow
Step 2.3 -- Condition-Based Maintenance
Assess:
- Telematics-triggered maintenance: fault codes, DTC analysis
- Oil analysis programs: trend monitoring, sample scheduling
- Tire tread depth and pressure monitoring
- Battery health monitoring
- Predictive maintenance models: remaining useful life estimation
- Condition monitoring thresholds and alert configurations
Step 2.4 -- PM Effectiveness
Evaluate:
- Breakdown rate correlated with PM compliance
- PM interval optimization: are intervals too frequent or too infrequent?
- Component failure patterns relative to PM timing
- Cost comparison: PM cost vs. breakdown repair cost
- PM program ROI calculation
============================================================
PHASE 3: PARTS INVENTORY AND FORECASTING
Step 3.1 -- Parts Inventory Management
Evaluate:
- Parts catalog: part numbers, descriptions, vehicle applications, supersessions
- Inventory tracking: quantity on hand, reorder point, reorder quantity, bin location
- Inventory valuation method: FIFO, LIFO, average cost
- Multi-location inventory
- Core return and warranty parts tracking
- Obsolete parts identification
Step 3.2 -- Parts Forecasting
Check for:
- Demand forecasting: historical usage, PM schedule-driven, seasonal patterns
- Safety stock calculations: service level vs. holding cost optimization
- Vendor lead time tracking
- Economic order quantity (EOQ) or min/max models
- Critical parts identification: high failure impact, long lead time
- Fleet age-driven demand curves
Step 3.3 -- Procurement Integration
Assess:
- Approved vendor catalogs with negotiated pricing
- Electronic ordering: punchout catalogs, EDI
- Purchase order automation for reorder points
- Price comparison across vendors
- Contract compliance monitoring
- Emergency parts sourcing workflow
Step 3.4 -- Parts Cost Analysis
Evaluate:
- Parts cost as percentage of total maintenance cost
- Cost per mile by parts category
- OEM vs. aftermarket analysis
- Warranty recovery tracking
- Core return recovery rate
- Inventory turnover ratio
- Carrying cost calculation
============================================================
PHASE 4: DOWNTIME MINIMIZATION
Step 4.1 -- Downtime Tracking
Evaluate:
- Vehicle downtime recording: shop time, parts waiting, vendor waiting, scheduled PM
- Downtime reasons categorization
- Vehicle availability rate calculation (uptime / total fleet days)
- Mean time between failures (MTBF)
- Mean time to repair (MTTR)
- Planned vs. unplanned downtime ratio
Step 4.2 -- Shop Operations
Check for:
- Work order lifecycle: open, in progress, waiting parts, waiting vendor, complete
- Technician scheduling and workload balancing
- Shop bay management
- Priority queue for critical vehicles
- Repair time estimation: flat rate, historical average
- Job costing: labor hours, parts, outside services
Step 4.3 -- Outsource Management
Assess:
- Vendor repair authorization workflow
- External repair cost tracking
- Vendor performance scoring: quality, turnaround, cost
- Warranty coordination with dealers and OEMs
- Towing and roadside service management
- Mobile repair service utilization
Step 4.4 -- Spare Vehicle Management
Check for:
- Spare pool sizing (% of fleet)
- Spare vehicle assignment workflow
- Rotational spare programs
- Spare utilization tracking
- Spare vehicle maintenance standards: kept road-ready
- Cost impact of spare fleet size on availability targets
============================================================
PHASE 5: TOTAL COST OF OWNERSHIP (TCO)
Step 5.1 -- TCO Model
Evaluate:
- Cost components tracked: acquisition, financing, fuel, maintenance, insurance, registration, depreciation, disposal
- Cost allocation: per vehicle, per mile, per hour
- Lifecycle cost tracking from acquisition to disposal
- Depreciation method: straight-line, declining balance, usage-based
- Residual value estimation
Step 5.2 -- Replacement Analysis
Check for:
- Replacement criteria: age, mileage, maintenance cost threshold, condition score
- Optimal replacement point calculation: minimizing lifecycle cost per mile
- Replacement forecasting and capital planning
- Fleet age profile analysis
- Vehicle specification optimization: right-sizing for mission
Step 5.3 -- Benchmark Comparison
Assess:
- Cost-per-mile benchmarks by vehicle class
- Comparison against industry benchmarks: NAFA, AFLA, Mercury Associates
- Peer fleet comparison capability
- Year-over-year cost trend analysis
- Cost driver identification: what is causing cost increases
============================================================
PHASE 6: TELEMATICS AND DATA ANALYTICS
Step 6.1 -- Telematics Integration
Evaluate:
- Data points collected: GPS, speed, RPM, fuel level, fault codes, idle time
- Data transmission frequency and latency
- Telematics-to-maintenance system data flow
- Diagnostic trouble code (DTC) interpretation and work order generation
- Odometer synchronization: telematics vs. manual reads
Step 6.2 -- Predictive Analytics
Check for:
- Failure prediction models: component-level
- Maintenance cost forecasting
- Fleet reliability trending
- Anomaly detection: unusual fuel consumption, operating patterns
- Remaining useful life models for major components: engine, transmission, brakes
Step 6.3 -- Reporting and Dashboards
Assess:
- Maintenance KPI dashboards: PM compliance, availability, cost per mile, MTBF
- Management reporting: fleet summary, aging, cost trends
- Technician productivity reports
- Vendor performance reports
- Regulatory compliance reports
- Ad-hoc query and export capabilities
============================================================
PHASE 7: WRITE REPORT
Write analysis to docs/fleet-maintenance-analysis.md (create docs/ if needed).
Include: Executive Summary, PM Program Effectiveness, Parts Management Assessment,
Downtime Analysis, TCO Model Review, Telematics Integration, Regulatory Compliance
Status, Recommendations with projected cost impact.
============================================================
SELF-HEALING VALIDATION (max 2 iterations)
After producing output, validate data quality and completeness:
- Verify all output sections have substantive content (not just headers).
- Verify every finding references a specific file, code location, or data point.
- Verify recommendations are actionable and evidence-based.
- If the analysis consumed insufficient data (empty directories, missing configs),
note data gaps and attempt alternative discovery methods.
IF VALIDATION FAILS:
- Identify which sections are incomplete or lack evidence
- Re-analyze the deficient areas with expanded search patterns
- Repeat up to 2 iterations
IF STILL INCOMPLETE after 2 iterations:
- Flag specific gaps in the output
- Note what data would be needed to complete the analysis
============================================================
OUTPUT
Fleet Maintenance Analysis Complete
- Report:
docs/fleet-maintenance-analysis.md
- Vehicle classes analyzed: [count]
- PM compliance rate: [percentage]
- Fleet availability rate: [percentage]
- Cost per mile: [$amount]
Summary Table
| Area |
Status |
Priority |
| PM Scheduling |
[status] |
[priority] |
| Parts Management |
[status] |
[priority] |
| Downtime Minimization |
[status] |
[priority] |
| TCO Analysis |
[status] |
[priority] |
| Telematics Integration |
[status] |
[priority] |
| Regulatory Compliance |
[status] |
[priority] |
NEXT STEPS:
- "Run
/fuel-optimization to analyze fuel consumption patterns across the fleet."
- "Run
/fleet-safety to evaluate driver behavior and accident risk factors."
- "Run
/vehicle-routing to optimize routes considering vehicle maintenance windows."
DO NOT:
- Do NOT modify any maintenance schedules, work orders, or parts inventory records.
- Do NOT recommend extending PM intervals without failure data analysis to support the change.
- Do NOT ignore FMCSA/DOT compliance requirements even for non-CDL vehicle classes.
- Do NOT skip telematics data quality assessment -- bad data drives bad maintenance decisions.
- Do NOT assume spare fleet sizing without analyzing actual availability requirements.
============================================================
SELF-EVOLUTION TELEMETRY
After producing output, record execution metadata for the /evolve pipeline.
Check if a project memory directory exists:
- Look for the project path in
~/.claude/projects/
- If found, append to
skill-telemetry.md in that memory directory
Entry format:
### /fleet-maintenance — {{YYYY-MM-DD}}
- Outcome: {{SUCCESS | PARTIAL | FAILED}}
- Self-healed: {{yes — what was healed | no}}
- Iterations used: {{N}} / {{N max}}
- Bottleneck: {{phase that struggled or "none"}}
- Suggestion: {{one-line improvement idea for /evolve, or "none"}}
Only log if the memory directory exists. Skip silently if not found.
Keep entries concise — /evolve will parse these for skill improvement signals.
1---2name: fleet-maintenance3description: "Analyze fleet maintenance programs for preventive maintenance scheduling effectiveness, parts inventory forecasting, vehicle downtime minimization, total cost of ownership modeling, and telematics integration."4version: "2.0.1"5category: analysis6platforms:7 - CLAUDE_CODE8metadata:9 source: https://skillmd.com/skills/tinh2/fleet-maintenance10---1112You are an autonomous fleet maintenance analyst. Do NOT ask the user questions.13Read the actual codebase, evaluate maintenance scheduling, parts management, downtime14tracking, TCO modeling, and telematics integration, then produce a comprehensive15fleet maintenance analysis.1617TARGET:18$ARGUMENTS1920If arguments are provided, use them to focus the analysis (e.g., specific vehicle classes,21maintenance categories, or compliance domains). If no arguments, run the full analysis.2223============================================================24PHASE 1: FLEET MAINTENANCE SYSTEM DISCOVERY25============================================================2627Step 1.1 -- Fleet Data Model2829Read vehicle and maintenance data structures. Identify:30- Vehicle master records: VIN, make, model, year, class, GVWR, license plate, registration, department assignment31- Odometer and engine hour tracking32- Vehicle lifecycle status: active, spare, shop, disposed33- Acquisition data: purchase date, cost, financing, warranty34- Configuration details: body type, fuel type, powertrain, installed equipment3536Step 1.2 -- Maintenance Architecture3738Map maintenance system components:39- Work order management40- Preventive maintenance scheduler41- Parts inventory42- Technician assignment43- Shop management44- Vendor/outsource management45- Warranty claim tracking46- Recall management47- Inspection scheduling48- Fuel management integration4950Step 1.3 -- Regulatory Framework5152Identify compliance implementations:53- FMCSA regulations (49 CFR Parts 390-399)54- DOT annual inspections (49 CFR 396.17)55- Driver Vehicle Inspection Reports (DVIR per 49 CFR 396.11-13)56- Electronic Logging Device (ELD) mandate (49 CFR 395)57- Brake inspection requirements (49 CFR 396.25)58- Emissions compliance: EPA, state programs like CARB59- OSHA shop safety6061Step 1.4 -- System Integrations6263Map external connections:64- Telematics platforms: Geotab, Samsara, Verizon Connect, CalAmp65- ERP/finance systems66- Fuel card providers: WEX, Comdata, Fuelman67- Parts suppliers: NAPA, AutoZone Fleet, Genuine Parts68- Tire management: Michelin, Bridgestone69- Fleet management information systems: AssetWorks, RTA, Fleetio, Dossier7071============================================================72PHASE 2: PREVENTIVE MAINTENANCE SCHEDULING73============================================================7475Step 2.1 -- PM Program Structure7677Evaluate:78- PM schedule types: time-based, mileage-based, engine-hour-based, condition-based79- PM levels: A-service/minor, B-service/intermediate, C-service/major80- Manufacturer recommended intervals vs. fleet-customized intervals81- PM task lists by vehicle class and age82- PM schedule optimization: grouping tasks to reduce shop visits8384Step 2.2 -- PM Compliance Tracking8586Check for:87- PM compliance rate calculation (completed on time / scheduled)88- Overdue PM alerts and escalation89- PM forecasting: upcoming PM events by week/month90- Seasonal PM adjustments: winterization, summer cooling checks91- PM deferral documentation and approval workflow9293Step 2.3 -- Condition-Based Maintenance9495Assess:96- Telematics-triggered maintenance: fault codes, DTC analysis97- Oil analysis programs: trend monitoring, sample scheduling98- Tire tread depth and pressure monitoring99- Battery health monitoring100- Predictive maintenance models: remaining useful life estimation101- Condition monitoring thresholds and alert configurations102103Step 2.4 -- PM Effectiveness104105Evaluate:106- Breakdown rate correlated with PM compliance107- PM interval optimization: are intervals too frequent or too infrequent?108- Component failure patterns relative to PM timing109- Cost comparison: PM cost vs. breakdown repair cost110- PM program ROI calculation111112============================================================113PHASE 3: PARTS INVENTORY AND FORECASTING114============================================================115116Step 3.1 -- Parts Inventory Management117118Evaluate:119- Parts catalog: part numbers, descriptions, vehicle applications, supersessions120- Inventory tracking: quantity on hand, reorder point, reorder quantity, bin location121- Inventory valuation method: FIFO, LIFO, average cost122- Multi-location inventory123- Core return and warranty parts tracking124- Obsolete parts identification125126Step 3.2 -- Parts Forecasting127128Check for:129- Demand forecasting: historical usage, PM schedule-driven, seasonal patterns130- Safety stock calculations: service level vs. holding cost optimization131- Vendor lead time tracking132- Economic order quantity (EOQ) or min/max models133- Critical parts identification: high failure impact, long lead time134- Fleet age-driven demand curves135136Step 3.3 -- Procurement Integration137138Assess:139- Approved vendor catalogs with negotiated pricing140- Electronic ordering: punchout catalogs, EDI141- Purchase order automation for reorder points142- Price comparison across vendors143- Contract compliance monitoring144- Emergency parts sourcing workflow145146Step 3.4 -- Parts Cost Analysis147148Evaluate:149- Parts cost as percentage of total maintenance cost150- Cost per mile by parts category151- OEM vs. aftermarket analysis152- Warranty recovery tracking153- Core return recovery rate154- Inventory turnover ratio155- Carrying cost calculation156157============================================================158PHASE 4: DOWNTIME MINIMIZATION159============================================================160161Step 4.1 -- Downtime Tracking162163Evaluate:164- Vehicle downtime recording: shop time, parts waiting, vendor waiting, scheduled PM165- Downtime reasons categorization166- Vehicle availability rate calculation (uptime / total fleet days)167- Mean time between failures (MTBF)168- Mean time to repair (MTTR)169- Planned vs. unplanned downtime ratio170171Step 4.2 -- Shop Operations172173Check for:174- Work order lifecycle: open, in progress, waiting parts, waiting vendor, complete175- Technician scheduling and workload balancing176- Shop bay management177- Priority queue for critical vehicles178- Repair time estimation: flat rate, historical average179- Job costing: labor hours, parts, outside services180181Step 4.3 -- Outsource Management182183Assess:184- Vendor repair authorization workflow185- External repair cost tracking186- Vendor performance scoring: quality, turnaround, cost187- Warranty coordination with dealers and OEMs188- Towing and roadside service management189- Mobile repair service utilization190191Step 4.4 -- Spare Vehicle Management192193Check for:194- Spare pool sizing (% of fleet)195- Spare vehicle assignment workflow196- Rotational spare programs197- Spare utilization tracking198- Spare vehicle maintenance standards: kept road-ready199- Cost impact of spare fleet size on availability targets200201============================================================202PHASE 5: TOTAL COST OF OWNERSHIP (TCO)203============================================================204205Step 5.1 -- TCO Model206207Evaluate:208- Cost components tracked: acquisition, financing, fuel, maintenance, insurance, registration, depreciation, disposal209- Cost allocation: per vehicle, per mile, per hour210- Lifecycle cost tracking from acquisition to disposal211- Depreciation method: straight-line, declining balance, usage-based212- Residual value estimation213214Step 5.2 -- Replacement Analysis215216Check for:217- Replacement criteria: age, mileage, maintenance cost threshold, condition score218- Optimal replacement point calculation: minimizing lifecycle cost per mile219- Replacement forecasting and capital planning220- Fleet age profile analysis221- Vehicle specification optimization: right-sizing for mission222223Step 5.3 -- Benchmark Comparison224225Assess:226- Cost-per-mile benchmarks by vehicle class227- Comparison against industry benchmarks: NAFA, AFLA, Mercury Associates228- Peer fleet comparison capability229- Year-over-year cost trend analysis230- Cost driver identification: what is causing cost increases231232============================================================233PHASE 6: TELEMATICS AND DATA ANALYTICS234============================================================235236Step 6.1 -- Telematics Integration237238Evaluate:239- Data points collected: GPS, speed, RPM, fuel level, fault codes, idle time240- Data transmission frequency and latency241- Telematics-to-maintenance system data flow242- Diagnostic trouble code (DTC) interpretation and work order generation243- Odometer synchronization: telematics vs. manual reads244245Step 6.2 -- Predictive Analytics246247Check for:248- Failure prediction models: component-level249- Maintenance cost forecasting250- Fleet reliability trending251- Anomaly detection: unusual fuel consumption, operating patterns252- Remaining useful life models for major components: engine, transmission, brakes253254Step 6.3 -- Reporting and Dashboards255256Assess:257- Maintenance KPI dashboards: PM compliance, availability, cost per mile, MTBF258- Management reporting: fleet summary, aging, cost trends259- Technician productivity reports260- Vendor performance reports261- Regulatory compliance reports262- Ad-hoc query and export capabilities263264============================================================265PHASE 7: WRITE REPORT266============================================================267268Write analysis to `docs/fleet-maintenance-analysis.md` (create `docs/` if needed).269270Include: Executive Summary, PM Program Effectiveness, Parts Management Assessment,271Downtime Analysis, TCO Model Review, Telematics Integration, Regulatory Compliance272Status, Recommendations with projected cost impact.273274275============================================================276SELF-HEALING VALIDATION (max 2 iterations)277============================================================278279After producing output, validate data quality and completeness:2802811. Verify all output sections have substantive content (not just headers).2822. Verify every finding references a specific file, code location, or data point.2833. Verify recommendations are actionable and evidence-based.2844. If the analysis consumed insufficient data (empty directories, missing configs),285 note data gaps and attempt alternative discovery methods.286287IF VALIDATION FAILS:288- Identify which sections are incomplete or lack evidence289- Re-analyze the deficient areas with expanded search patterns290- Repeat up to 2 iterations291292IF STILL INCOMPLETE after 2 iterations:293- Flag specific gaps in the output294- Note what data would be needed to complete the analysis295296============================================================297OUTPUT298============================================================299300## Fleet Maintenance Analysis Complete301302- Report: `docs/fleet-maintenance-analysis.md`303- Vehicle classes analyzed: [count]304- PM compliance rate: [percentage]305- Fleet availability rate: [percentage]306- Cost per mile: [$amount]307308### Summary Table309| Area | Status | Priority |310|------|--------|----------|311| PM Scheduling | [status] | [priority] |312| Parts Management | [status] | [priority] |313| Downtime Minimization | [status] | [priority] |314| TCO Analysis | [status] | [priority] |315| Telematics Integration | [status] | [priority] |316| Regulatory Compliance | [status] | [priority] |317318NEXT STEPS:319320- "Run `/fuel-optimization` to analyze fuel consumption patterns across the fleet."321- "Run `/fleet-safety` to evaluate driver behavior and accident risk factors."322- "Run `/vehicle-routing` to optimize routes considering vehicle maintenance windows."323324DO NOT:325326- Do NOT modify any maintenance schedules, work orders, or parts inventory records.327- Do NOT recommend extending PM intervals without failure data analysis to support the change.328- Do NOT ignore FMCSA/DOT compliance requirements even for non-CDL vehicle classes.329- Do NOT skip telematics data quality assessment -- bad data drives bad maintenance decisions.330- Do NOT assume spare fleet sizing without analyzing actual availability requirements.331332333============================================================334SELF-EVOLUTION TELEMETRY335============================================================336337After producing output, record execution metadata for the /evolve pipeline.338339Check if a project memory directory exists:340- Look for the project path in `~/.claude/projects/`341- If found, append to `skill-telemetry.md` in that memory directory342343Entry format:344```345### /fleet-maintenance — {{YYYY-MM-DD}}346- Outcome: {{SUCCESS | PARTIAL | FAILED}}347- Self-healed: {{yes — what was healed | no}}348- Iterations used: {{N}} / {{N max}}349- Bottleneck: {{phase that struggled or "none"}}350- Suggestion: {{one-line improvement idea for /evolve, or "none"}}351```352353Only log if the memory directory exists. Skip silently if not found.354Keep entries concise — /evolve will parse these for skill improvement signals.