# OpsMan Gap Analysis

*What's missing from the current spec — functionality gaps, edge cases, and future needs*

---

## Current Coverage (5 Agents)

| Agent | Coverage | Status |
|-------|----------|--------|
| Crew | Attendance, clock in/out | ✅ Defined |
| Costing | Pricing, estimates, learning | ✅ Defined |
| Timesheet | Weekly compile, export | ✅ Defined |
| Invoice | Billing, Xero export | ✅ Defined |
| Assets | Tools, materials, vehicles | ✅ Defined |

---

## 🔴 HIGH PRIORITY GAPS

### 1. Safety & Compliance Agent

**What's Missing:**
- White card expiry tracking
- High-risk work licenses (HRW)
- Working at heights tickets
- First aid certificates
- Safety incident reporting
- Near-miss logging
- Site induction records

**Why It Matters:**
- Fines for expired licenses
- Insurance claims need incident logs
- Safety culture = fewer accidents

**Example:**
> "Rocky's working at heights ticket expires in 14 days. Book refresher."

---

### 2. Subcontractor Management

**What's Missing:**
- Subcontractor database
- Insurance expiry tracking (public liability, workers comp)
- ABN verification
- Subbie timesheet collection
- Subbie payment tracking
- Contract/compliance docs

**Why It Matters:**
- Sham contracting risk (ATO crackdown)
- Insurance gaps = liability exposure
- Tracking who did what job

**Example:**
> "Concreting Solutions PL insurance expires 15 March. Request renewal."

---

### 3. Job Scheduling & Planning

**What's Missing:**
- Forward job schedule (what's coming next week/month)
- Resource allocation (who's on what job when)
- Equipment booking (crane booked Tue-Thu)
- Client access arrangements
- Permits to work

**Why It Matters:**
- Double-booking workers = chaos
- Crane hire wasted if not coordinated
- Client expects start dates

**Example:**
> "Week of 17 Feb: Eastern Creek (Mon-Wed), Arncliffe (Thu-Fri). Rocky + Mike both sites."

---

### 4. Client/CRM Management

**What's Missing:**
- Client database
- Contact history
- Quote follow-ups
- Payment status tracking
- Dispute/complaint logging
- Retention money tracking

**Why It Matters:**
- Who owes money and how much
- Quote sent 3 weeks ago, no response = follow up
- Dispute history if client comes back

**Example:**
> "Eastern Creek LTP: Quote sent 21 Jan, no response. Follow up with Liam?"

---

## 🟡 MEDIUM PRIORITY GAPS

### 5. Weather & Environmental

**What's Missing:**
- Weather forecast integration
- Rain day logging
- Weather-related delay tracking
- Environmental conditions (too hot/cold for concrete)
- Site access issues (flooding, etc.)

**Why It Matters:**
- Rain days = lost revenue
- Concrete pours need 48hr dry forecast
- Variation claims for weather delays

**Example:**
> "Thu 13 Feb: 80% rain. Eastern Creek concrete pour at risk — confirm with Liam."

---

### 6. Photo & Document Management

**What's Missing:**
- Progress photo logging (date, location, job)
- As-built documentation
- Engineer instruction photos
- Defect/snag photos
- Before/after comparisons
- Photo search ("show me Eastern Creek footing photos")

**Why It Matters:**
- Proof of work for variations
- Engineer disputes = photo evidence
- Marketing material

**Example:**
> "Eastern Creek LTP: 23 photos logged. Missing: completed footing photos."

---

### 7. Variations & Extras Tracking

**What's Missing:**
- Scope change logging
- Extra work authorization
- Day work rates application
- Variation pricing vs original
- Client approval tracking

**Why It Matters:**
- Variations = 20-30% of job revenue
- Unapproved extras = you eat the cost
- Disputes over "was that included?"

**Example:**
> "Eastern Creek: 3 variations logged, total $4,200. Client approval: 2 of 3."

---

### 8. Purchase Orders & Suppliers

**What's Missing:**
- Supplier database
- Purchase order generation
- Delivery tracking
- Price history (paid $X for ply last time)
- Supplier performance (on-time, quality)
- Material warranty tracking

**Why It Matters:**
- Material costs 40-50% of job
- Supplier reliability affects schedule
- Price increases = need to update quotes

**Example:**
> "Ply prices up 12% since last job. Update Costing Agent rates?"

---

### 9. Quality & Defects

**What's Missing:**
- Defect/snag list per job
- Rework tracking (why, cost, who caused)
- Quality checklists
- Engineer inspection failures
- Sign-off tracking

**Why It Matters:**
- Rework kills margins
- Pattern analysis (always failing on X)
- Who causes defects = training needed

**Example:**
> "Last 5 jobs: 3 failed inspections on reinforcement spacing. Issue with Mike?"

---

### 10. Location & GPS

**What's Missing:**
- Job site addresses
- Travel time calculation
- Nearest worker to site
- Worker location verification (optional)
- Site boundary alerts (geofencing)

**Why It Matters:**
- Travel time = chargeable or not?
- Closest worker = faster response
- Proof worker was on site

**Example:**
> "Mike is 15 min from Eastern Creek. Rocky is 45 min. Send Mike for urgent fix?"

---

## 🟢 LOW PRIORITY / NICE TO HAVE

### 11. Communication Logging

**What's Missing:**
- Engineer instructions logged
- Client decisions recorded
- Verbal agreement tracking
- Meeting notes
- Phone call summaries

**Why It Matters:**
- "He said, she said" disputes
- Engineer changes mind = variation

---

### 12. Training & Skills

**What's Missing:**
- Worker skill matrix
- Training completed
- Skill gaps identified
- Mentorship tracking

**Why It Matters:**
- Who can do what
- Training investment tracking

---

### 13. Equipment Utilization

**What's Missing:**
- Tool utilization rates (laser level used 20% of time)
- ROI per tool (rent vs buy analysis)
- Equipment depreciation
- Hire equipment tracking

**Why It Matters:**
- Expensive tools sitting idle = sell them
- Hire vs buy decisions

---

### 14. Fuel & Vehicle Costs

**What's Missing:**
- Fuel logging per vehicle
- Vehicle cost per job
- Toll tracking
- Maintenance beyond service

**Why It Matters:**
- Vehicle costs $$$, rarely tracked to jobs
- True job profitability

---

## Summary Matrix

| Gap | Priority | Complexity | Value to LFCS |
|-----|----------|------------|---------------|
| Safety & Compliance | 🔴 High | Medium | 🔥 Critical |
| Subcontractor Mgmt | 🔴 High | Medium | 🔥 Critical |
| Job Scheduling | 🔴 High | Medium | 🔥 High |
| Client/CRM | 🔴 High | Low | 🔥 High |
| Weather Integration | 🟡 Medium | Low | Medium |
| Photo Management | 🟡 Medium | Medium | Medium |
| Variations Tracking | 🟡 Medium | Low | 🔥 High |
| Purchase Orders | 🟡 Medium | Medium | Medium |
| Quality/Defects | 🟡 Medium | Medium | Medium |
| Location/GPS | 🟡 Medium | Medium | Low |
| Communication Log | 🟢 Low | Low | Medium |
| Training/Skills | 🟢 Low | Medium | Low |
| Equipment Utilization | 🟢 Low | High | Medium |
| Fuel/Vehicle Costs | 🟢 Low | Medium | Low |

---

## Recommendations

### Phase 1 (V1 - First 2 Months)
- ✅ Keep: Crew, Costing, Timesheet, Invoice, Assets (current 5)
- 🆕 Add: Variations Tracking (quick win, high value)
- 🆕 Add: Photo Logging (simple, useful)

**Total: 7 agents for V1**

### Phase 2 (V2 - Months 3-4)
- 🆕 Add: Safety & Compliance (critical for insurance)
- 🆕 Add: Job Scheduling (resource planning)
- 🆕 Add: Client/CRM (who owes money)

**Total: 10 agents for V2**

### Phase 3 (V3 - Months 5-6)
- 🆕 Add: Subcontractor Management (if using subs)
- 🆕 Add: Purchase Orders (if material ordering complex)
- 🆕 Add: Quality/Defects (if rework is problem)

**Total: 13 agents for V3**

---

## Questions for Liam

1. **Safety:** Does LFCS track white cards/licenses now? How?
2. **Subs:** Does Liam use subcontractors? How many?
3. **Scheduling:** Does he plan jobs ahead or day-by-day?
4. **Photos:** Does he take progress photos? Where do they go?
5. **Variations:** How are extras/variations tracked now?
6. **Suppliers:** Does he have preferred suppliers? Price lists?
7. **Defects:** Is rework a problem? How is it tracked?

---

*Gap Analysis Version: 1.0*
*Date: 2026-02-09*
*Analyst: Rivet*