pf-fleet-compliance

DOT Guidance documentation for small trucking carriers

An alternative to Tenstreet ($300-2,500/month) with free, AI-powered compliance management. Generate Driver Qualification Files (DQF), Digital Vehicle Inspection Reports (DVIR), IFTA fuel tax reports, Hours of Service (HOS) audit logs, and drug & alcohol testing records — all compliant with FMCSA regulations.

Target audience: Owner-operators and trucking fleets of 1-20 trucks

Important: All documents generated by this plugin are drafts intended as starting points. Regulatory compliance documentation should be reviewed by your compliance officer or qualified professional before submission to regulatory agencies. Requirements vary by jurisdiction.

Why This Exists

Regulatory compliance for motor carriers is expensive and manual:

• Tenstreet ($300-2,500/month depending on fleet size) is the industry standard but overkill for small carriers
• DQFs must be audited manually per 49 CFR Part 391
• DVIR logs need categorization per FMCSA standards
• IFTA quarterly reports require state-by-state mileage/fuel tracking
• HOS logs must be validated against 49 CFR Part 395 limits
• Drug & alcohol records need annual compliance reporting

This plugin automates all of it. Input driver records, inspection data, mileage logs, and fuel receipts—output structured for audit preparation documents. Included with your subscription. Offline. Owned by you.

Quick Start (5 Steps)

1. Install the plugin — Download the .zip file and drag it into Claude Desktop (Cowork mode)
2. Run setup — Type /fleet:setup to initialize your workspace folder structure
3. Add driver data — Copy driver records, inspection logs, and mileage data to the inbound/ folder
4. Run the pipeline — Type /fleet:pipeline to process all compliance documents
5. Review outputs — Check the outbound/ folder for DQF packets, DVIR logs, IFTA reports, and audit bundles

Commands

Command	Description	Input	Output
/fleet:setup	Initialize workspace with carrier identity and compliance calendar	Carrier name, USDOT #, MC #, carrier type, fleet size	.fleet/config.json, compliance calendar, lifecycle folders
/fleet:dqf	Driver Qualification File generator (49 CFR §391.51 — all 10 elements)	Driver records (inbound/driver-*.json)	DQF DOCX with §391.51 checklist, expiry tracker, CSA risk assessment
/fleet:dvir	Digital Vehicle Inspection Report (20-point FMCSA standard with CVSA OOS criteria)	Vehicle inspections (inbound/dvir-*.json)	DVIR form DOCX with OOS determination, defect severity classification
/fleet:ifta	IFTA quarterly fuel tax calculator with audit red flag detection	Mileage CSV, fuel receipt CSV	IFTA summary DOCX, quarterly worksheet CSV, filing checklist with deadlines
/fleet:hos	Hours of Service audit (§395.3 — all 5 violation types with exemption checks)	HOS log CSV (date, status, hours)	Violation report with CSA severity, at-risk flags, available hours
/fleet:dnt	Drug & Alcohol testing compliance (§382 — all 6 test types, Clearinghouse tracking)	Test records CSV	Testing summary, compliance rates vs. FMCSA minimums, retention schedule
/fleet:audit	structured for audit preparation bundle mapped to FMCSA 6 rating factors (§385.7)	All outbound/ files	Audit bundle DOCX, readiness score (0-100) mapped to BASICs
/fleet:pipeline	Run all commands in sequence (setup → dqf → dvir → ifta → hos → dnt → audit)	All inbound/ files	All outbound/ files + audit bundle
/fleet:status	Display workspace status with expiry alerts and compliance calendar	None	Dashboard with document inventory and upcoming deadlines

AI-Powered Features

1. professionally structured DQF Validation: Validates all 10 §391.51 required elements with specific CFR subsection citations, tracks FMCSA Drug & Alcohol Clearinghouse query compliance (§382.701), calculates CSA Driver Fitness BASIC violation risk with severity weights
2. CVSA-Standard Vehicle Inspections: Full 20-point FMCSA inspection checklist with Out-of-Service criteria per category, three-tier defect severity classification (safety-critical/major/minor), repair certification tracking per §396.13
3. IFTA Tax Calculation with Audit Protection: State-by-state fuel tax calculation with reference rates, 5-algorithm audit red flag detection (abnormal MPG, fuel gaps, jurisdiction imbalance), quarterly filing deadline tracking per IFTA Article VI
4. Comprehensive HOS Analysis: All 5 violation types detected (11-hour, 14-hour window, 30-minute break, 60/70-hour, 34-hour restart) with specific §395.3 citations, sleeper berth 7/3 split recognition, 5 exemption checks (short-haul, agricultural, adverse driving, oilfield, non-CDL)
5. DOT Drug & Alcohol Program Management: All 6 test types tracked per §382.301-.311 with FMCSA minimum rate verification (50% drug, 10% alcohol), DOT 5-panel drug test awareness with cutoff levels, MRO verification tracking per 49 CFR Part 40
6. FMCSA audit preparation Scoring: Readiness score (0-100) mapped to all 6 FMCSA rating factors (§385.7), acute vs. critical violation identification, BASICs self-assessment with SMS percentile methodology, color-coded scoring (GREEN/YELLOW/ORANGE/RED)

Feature Comparison

Feature	pf-fleet-compliance v1.1	Tenstreet ($300-2,500/mo)
DQF with §391.51 checklist	✅ All 10 elements + CSA risk	✅
DVIR with OOS criteria	✅ 20-point + CVSA severity	✅
IFTA calculation	✅ + audit red flags	✅
HOS audit (all 5 violations)	✅ + exemption checks	✅ + ELD integration
Drug & alcohol tracking	✅ + Clearinghouse awareness	✅ + Clearinghouse API
audit preparation scoring	✅ Mapped to 6 rating factors	✅
CSA/BASICs awareness	✅ Violation codes + severity	✅ + live SMS data
Regulatory citations	✅ Specific CFR §§ throughout	Partial
Real-time ELD	❌ CSV import only	✅
Clearinghouse integration	❌ Awareness only	✅ Direct API
Price	Free (included)	$300-2,500/month
Offline capable	✅	❌

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
fleet-audit	~3.1K	~800	~6.7K	~4.0K	~$0.08
fleet-dqf	~3.0K	~800	~6.7K	~3.0K	~$0.07
fleet-hos	~3.3K	~800	~7.0K	~3.3K	~$0.07
fleet-dnt	~3.8K	~800	~7.5K	~3.8K	~$0.08
fleet-ifta	~2.6K	~800	~6.3K	~3.0K	~$0.06
fleet-dvir	~3.1K	~800	~6.8K	~3.1K	~$0.07
Standalone total			~41.1K	~20.2K	~$0.43

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

Stage	Base Input	+ History	Total Input	Output	Est. Cost
fleet-audit	~6.7K	0	~6.7K	~4.0K	~$0.08
fleet-dqf	~6.6K	~4.8K	~11.4K	~3.0K	~$0.08
fleet-hos	~6.9K	~8.6K	~15.5K	~3.3K	~$0.10
fleet-dnt	~7.4K	~12.7K	~20.1K	~3.8K	~$0.12
fleet-ifta	~6.2K	~17.3K	~23.6K	~3.0K	~$0.12
fleet-dvir	~6.7K	~21.1K	~27.8K	~3.1K	~$0.13
Pipeline total			~105.1K	~20.2K	~$0.62

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

Known Limitations

1. No real-time ELD integration — Accepts CSV imports only. ELD data must be exported manually.
2. State-specific IFTA surcharges not included — Base rates provided as reference; surcharges for KY, NM, NY, VA documented but not calculated. Verify at IFTA.org.
3. No e-signature capture — Documents require wet signature. Many DOT auditors still require handwritten signatures.
4. HOS exemptions flagged but not auto-applied — Short-haul (§395.1(e)(1)), agricultural (§395.1(k)), and other exemptions are detected and documented but require driver attestation.
5. No FMCSA Clearinghouse integration — Tracks Clearinghouse query dates but does not perform actual queries (requires portal access + driver consent).
6. Not a substitute for legal counsel — Complex cases (disputes, exemption requests, audit appeals) require a DOT Guidance attorney.
7. Oregon IFTA weight-mile tax — Oregon uses weight-mile tax instead of fuel tax; Oregon miles are flagged but tax not calculated (requires vehicle weight data).

Data Privacy

• All data processed entirely offline (local processing)
• Generated documents stay in your outbound/ folder
• No telemetry, tracking, or third-party sharing
• Data persists only in your workspace directory

Installation

Method 1: Manual Upload (Recommended)

1. Download the .zip file from the release page
2. Open Claude Desktop in Cowork mode
3. Drag the .zip file into the Cowork window
4. The plugin installs automatically

Method 2: CLI Installation

claude plugin install /path/to/pf-fleet-compliance.plugin

After Installation

1. Run /fleet:setup to initialize your workspace
2. Run /fleet:status to verify the plugin is ready
3. Consult the USER-GUIDE.md for step-by-step instructions

Versions & Changelog

Current version: 1.1

See CHANGELOG.md for version history and updates.

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.
• Not Legal Advice: This plugin does not provide legal services or legal advice. All legal documents and analysis should be reviewed by a licensed attorney before use.