Staff Training Go Live

• Building features (use the relevant feature skill)
• Technical deployment (use devops-deployment-monitoring)
• Data migration (use data-migration-etl)

Training Principles for H&J

THE REALITY:
- 8 people, not 800. This is intimate, hands-on training.
- Most staff are NOT tech-savvy. They use Jobber because they have to.
- Spanish-speaking workers need bilingual materials.
- People learn by DOING, not reading. Training must be interactive.
- Joe has ADHD and won't read a 50-page training manual.
- Cruz is the production manager — if Cruz can use it, everyone can.
- Counter staff (front-facing) must be FAST on day one. No fumbling.

THE APPROACH:
1. ROLE-BASED: Each person learns ONLY what they need for their job.
2. TASK-BASED: Training organized by task ("How do I ring up a sale"),
   not by feature ("Here's the payment module").
3. PROGRESSIVE: Basic tasks first, advanced features later.
4. REFERENCE CARDS: One-page cheat sheets laminated at every workstation.
5. SAFE TO PRACTICE: A training mode or test data so they can play without
   breaking anything.

Role-Based Training Paths

1. Counter Staff (Maria, Front Desk)

DAILY TASKS:
□ Log in to the system
□ Look up a contractor by name or phone
□ Create a new quote (Sketch Quote Builder)
□ Convert a quote to an order
□ Process a payment (Stripe M2 tap-to-pay)
□ Process a pallet return (credit or cash refund)
□ Answer basic inventory questions ("Do you have white privacy 6ft?")
□ Schedule a delivery
□ Handle a walk-in customer pickup

TRAINING TIME: 4 hours over 2 days (2 hrs/day)
DAY 1: Login, contractor lookup, quote creation, payment processing
DAY 2: Delivery scheduling, pallet returns, inventory check, pickup

REFERENCE CARD (laminated, taped to counter):
┌──────────────────────────────────────────────────┐
│      H&J PLATFORM — COUNTER QUICK REFERENCE       │
├──────────────────────────────────────────────────┤
│ LOGIN: hjfence.com → your email + password        │
│                                                    │
│ NEW QUOTE:                                         │
│ Quotes → New Draft → Sketch Builder →              │
│ Draw fence → Add hardware → Done & Review →        │
│ Save Draft or Send to Customer                     │
│                                                    │
│ PROCESS PAYMENT:                                   │
│ Open order → Payment → Tap M2 reader OR            │
│ Enter card → Confirm amount → Print receipt         │
│                                                    │
│ LOOK UP CONTRACTOR:                                │
│ Cmd+K (search) → type name → click result           │
│                                                    │
│ PALLET RETURN:                                     │
│ Contractor profile → Pallets tab → Process Return   │
│                                                    │
│ HELP: Call Joe at [phone]                           │
│ EMERGENCY: If system is down, use paper order forms │
└──────────────────────────────────────────────────┘

2. Cruz (Production Manager)

DAILY TASKS:
□ Check tomorrow's production schedule
□ Assign workers to stations (morning setup)
□ Clock workers in/out
□ Monitor KDS boards for production progress
□ Mark work orders as complete
□ Check inventory levels for key materials
□ Create purchase orders when stock is low
□ Handle receiving (container check-in)
□ Review daily production metrics

TRAINING TIME: 6 hours over 3 days
DAY 1: Login, KDS overview, worker assignment, time clock
DAY 2: Work order management, production schedule, inventory check
DAY 3: Purchasing (PO creation), receiving workflow, daily metrics

REFERENCE CARD (laminated, at Cruz's desk):
┌──────────────────────────────────────────────────┐
│     H&J PLATFORM — PRODUCTION QUICK REFERENCE      │
├──────────────────────────────────────────────────┤
│ MORNING SETUP:                                     │
│ Admin → Production → Morning Setup →               │
│ Assign workers to stations → Start Shift            │
│                                                    │
│ KDS VIEW:                                          │
│ Admin → KDS → Select station →                     │
│ See queue → Start/Complete work orders              │
│                                                    │
│ INVENTORY CHECK:                                   │
│ Admin → Inventory → Search product →               │
│ See on-hand, reorder point, last PO                │
│                                                    │
│ CREATE PO:                                         │
│ Admin → Purchasing → New PO →                      │
│ Select vendor → Add items → Submit                 │
│                                                    │
│ RECEIVING:                                         │
│ Admin → Receiving → Select PO →                    │
│ Count items → Note damage → Complete               │
│                                                    │
│ HELP: Call Joe at [phone]                           │
└──────────────────────────────────────────────────┘

3. Production Workers

DAILY TASKS:
□ Clock in at station terminal
□ View their assigned work orders on KDS
□ Start a work order (tap "Start")
□ Complete a work order (tap "Complete")
□ Report an issue (tap "Issue" — material, quality, equipment)
□ Clock out

TRAINING TIME: 1 hour (on the floor, in person)
Format: Cruz demonstrates, worker practices on test data

BILINGUAL REFERENCE CARD:
┌──────────────────────────────────────────────────┐
│   WORK STATION GUIDE / GUÍA DE ESTACIÓN            │
├──────────────────────────────────────────────────┤
│ CLOCK IN / FICHAR ENTRADA:                         │
│ Tap your name → Enter PIN → ✅                      │
│ Toca tu nombre → Ingresa PIN → ✅                   │
│                                                    │
│ START WORK / INICIAR TRABAJO:                      │
│ See your queue → Tap "Start" on first item          │
│ Ver tu cola → Toca "Iniciar" en el primer item      │
│                                                    │
│ COMPLETE / COMPLETAR:                              │
│ When done → Tap "Complete" → Next item starts       │
│ Al terminar → Toca "Completar" → Siguiente item     │
│                                                    │
│ PROBLEM / PROBLEMA:                                │
│ Tap "Issue" → Select type → Cruz is notified        │
│ Toca "Problema" → Selecciona tipo → Cruz notificado │
│                                                    │
│ CLOCK OUT / FICHAR SALIDA:                         │
│ Tap your name → "Clock Out" → ✅                    │
│ Toca tu nombre → "Salir" → ✅                       │
└──────────────────────────────────────────────────┘

4. Drivers (Subcontractors)

DAILY TASKS:
□ Check assigned deliveries on phone
□ Navigate to delivery location
□ Mark arrival at job site
□ Take delivery photo (proof of delivery)
□ Get customer sign-off
□ Mark delivery complete
□ Check earnings and ratings

TRAINING TIME: 30 minutes (phone walkthrough)
Format: Joe or counter staff demonstrates on driver's phone

REFERENCE (sent via text):
"Driver Portal: hjfence.com/driver
1. Login with your phone number
2. See today's stops → tap first one
3. Navigate → deliver → take photo → get signature
4. Tap 'Complete' → next stop loads
Questions? Text [H&J number]"

SOP Template

# SOP: [Task Name]
## Role: [Who performs this]
## Frequency: [Daily / As needed / Weekly]
## Time Required: [X minutes]

### Prerequisites
- [ ] Logged in to H&J Platform
- [ ] [Any other requirements]

### Steps
1. Navigate to [location]
2. Click [button/tab]
3. [Action]
4. [Action]
5. Verify: [what should you see if it worked?]

### If Something Goes Wrong
- **[Specific error]**: [What to do]
- **System is down**: Use paper form, enter when system is back
- **Not sure**: Call Joe at [phone number]

### Screenshots
[Include screenshots of each step]

Go-Live Checklist

4 Weeks Before (July 2026)

SYSTEM READINESS:
□ All critical features tested and working
□ Data migration from Jobber complete
□ Separate production database (no more shared dev/prod!)
□ Monitoring and alerting configured
□ Backup and recovery tested
□ SSL and domain configured
□ Performance tested under load

TRAINING READINESS:
□ Training materials created for each role
□ Reference cards printed and laminated
□ Test environment or training mode available
□ Training schedule published
□ Cruz has completed full training
□ Counter staff have completed training
□ Production workers have completed training
□ Drivers have received phone walkthrough

2 Weeks Before

PARALLEL RUN:
□ Both Jobber and H&J Platform running simultaneously
□ Counter staff entering orders in BOTH systems (1 week)
□ Discrepancies documented and resolved
□ Staff confidence assessed — anyone need more training?
□ Fallback plan documented (what if we need to stay on Jobber?)

COMMUNICATION:
□ Contractors notified of upcoming changes
□ Drivers notified of new delivery portal
□ Paper backup forms printed (10 copies at each station)
□ Emergency contact list at every workstation
□ "System Down" procedure documented and practiced

1 Week Before

FINAL PREP:
□ Final data sync from Jobber → H&J Platform
□ All open quotes/orders migrated
□ Staff have practiced on the new system for 3+ days
□ Known issues documented with workarounds
□ Joe has signed off on go/no-go decision
□ Celebratory lunch planned for launch day (team morale!)

Day 1 (THE SWITCH)

MORNING:
□ 6:00 AM: Final Jobber data sync
□ 6:30 AM: Verify all data in H&J Platform
□ 7:00 AM: Joe makes Go/No-Go call
□ 7:30 AM: Staff arrives — brief morning huddle
□ 7:45 AM: "We're going live. Jobber is now read-only."
□ 8:00 AM: First customer interaction on new system

DAY-1 SUPPORT PLAN:
□ Joe: Available all day, roaming between stations
□ Cruz: At production, help workers with KDS
□ Designated "help" person at counter (someone who trained early)
□ Quick-response text group for "I can't find X" questions
□ Paper backup forms ready at every station

END OF DAY:
□ Debrief: What worked? What didn't?
□ Log all issues encountered
□ Fix critical issues tonight (Joe + agent)
□ Update reference cards if needed
□ Plan for Day 2 adjustments

Training Materials Generation

Agent Instruction for Creating Training Docs

When asked to create training materials:

1. IDENTIFY THE ROLE: Who is this for? Counter, Cruz, production, driver?
2. IDENTIFY THE TASK: What specific workflow are they learning?
3. WALK THROUGH THE UI: Open the actual feature, screenshot each step
4. WRITE AT 6TH GRADE READING LEVEL: Short sentences, numbered steps
5. INCLUDE "IF WRONG" SECTION: What to do when something doesn't work
6. BILINGUAL: For production workers, include Spanish translations
7. FORMAT FOR PRINTING: One page, large font, clear headers

OUTPUT FORMAT:
- Quick reference card (one page, laminated) — for the workstation
- Step-by-step SOP (2-3 pages) — for training binder
- Video script (optional) — record Joe or Cruz walking through it

Fallback Procedures

IF THE NEW SYSTEM GOES DOWN ON DAY 1:

LEVEL 1 (< 15 minutes): 
  → Refresh browser
  → Check internet connection
  → Try on a different device
  → "Hold on, give us a minute"

LEVEL 2 (15-60 minutes):
  → Switch to paper order forms
  → Process payments via square/manual card entry
  → Note all orders on paper for later entry
  → Text Joe: "System is down, using paper forms"

LEVEL 3 (> 1 hour):
  → Revert to Jobber for the rest of the day
  → Joe investigates and fixes
  → Enter paper orders into H&J Platform later
  → Try again tomorrow

★ THE GOLDEN RULE: Never tell a customer "our system is down."
  Say: "Let me write this up for you right now" (paper form)
  The customer doesn't care what system you use.

Anti-Patterns