# COMPLETE-KNOWLEDGE.md
> Everything I know about Michael, RateRight, and Growth Engine
> Last updated: 2026-01-30

---

## 👤 About Michael

**Who you are:**
- Founder of RateRight Pty Ltd
- 30 years as a steelfixer — you know construction inside out
- On site 12 hours a day, then code til 11pm
- Pronouns: he/him
- Timezone: Australia (AEST/AEDT)

**Your schedule:**
- On site: Keep it SHORT, you're in gloves, probably voice
- Coding (6:30-11pm): More detailed discussion welcome
- Building a startup while working full-time physical labor — brutal

**People:**
- **Tony McCabe** — Friend, was going to be Head of Sales & Marketing. On hold because his mum is sick. NOT a sales lead.
- **Markus** — Full-stack dev in Philippines, works on RateRight marketplace platform ONLY. Has nothing to do with Growth Engine.
- **Mae Yting** (ytingmae@gmail.com) — New hire, Lead Generator trial. CRM access fixed Jan 27, but 0 activity so far.
- **Vena Entero** (entero.vena@gmail.com) — New hire, Lead Generator trial. Crushing it — 31 calls, 18 SMS, Level 2, 266 XP.
- **Jon Flannelly** — Old mate from DTMT Construction (2012-2014). Now MD at Flancon Pty Ltd, Perth. Phone: 0405 690 651. Warm lead for re-engagement.

---

## 🏗️ RateRight

**What it is:**
Construction marketplace connecting contractors with workers for construction jobs. Australia-focused.

**The disruption:**
- Agencies charge contractors 30-40% ON TOP of worker pay
- RateRight: 7% platform fee + 2.9% Stripe = **9.9% total all-in**
- **CRITICAL: Contractors pay NOTHING. The 9.9% comes from the worker's rate.**

**Pitches:**

*To contractors:*
> "Post jobs for free. No agency markup. Workers set their own rates, you see exactly what you're paying. We only take 9.9% from the worker's side - costs you nothing."

*To workers:*
> "Set your own rate. Keep more of your money - we take 9.9% total, not 30-40% like agencies. Get paid faster. You're in control."

**Platform URL:** https://app.rateright.com.au

**Key trades:** Electrical, plumbing, carpentry, painting, landscaping, roofing, tiling, plastering, concreting, formwork, steelfixing

**Team:**
- Michael (Founder) — Steelfixer, builds Growth Engine with Claude Code
- Markus (Full-stack dev, PH) — RateRight marketplace platform only

---

## 📞 Growth Engine CRM

**What it is:**
Custom-built sales CRM for RateRight. Michael built it with Claude Code.

**API:** https://rateright-growth-production.up.railway.app
**Phone:** +61 468 087 171 (Twilio)

### Core Features

**Lead Management:**
- AI call list (leads scored 0-100, ranked by urgency/intent/timing)
- Lead profiles with full history
- Notes, tags, status tracking
- Auto-extract intel from inbound SMS/calls

**Calling:**
- Browser-based calling
- Pre-call intel briefs with similar wins
- Live call copilot with real-time objection handling
- Call recording + Deepgram transcription
- AI post-call analysis (buying signals, score adjustments)
- Voicemail drop (one-click)

**Messaging:**
- SMS via Twilio
- SMS sequences (automated follow-ups)
- Reply detection and lead updates

**Team Management:**
- Manager dashboard (calls, conversions, talk time per rep)
- Leaderboards/gamification (XP, challenges, streaks)
- Call recording and playback
- Coaching insights

**AI Features:**
- Intel briefs before calls
- Objection handling suggestions
- Message drafting
- Conversion predictions
- Weekly intel reports (Monday 7am)
- Daily quality audits (6am)
- Platform sync (every 15 mins for new signups)

### Recent Bugs Fixed (Jan 29, 2026)

1. **Call stats showing 0** — Queries used non-existent `created_by` column. Fixed to use `handled_by`/`user_id`.
2. **Deepgram empty transcripts** — `diarize=true` causing garbage returns. Removed parameter.
3. **Intel not extracting from calls** — Added `extractFullCallIntel()` to post-call path.
4. **copilot_sessions column error** — Moved `recording_url` to metadata field.
5. **SMS duplicates** — Leads could be in multiple sequences. Added 30-min throttle + enrollment check.
6. **Messages scroll triggers click** — Added position-based scroll detection.
7. **Back button goes to dashboard** — Added URL↔state bidirectional sync.

### Features Added (Jan 29, 2026)

1. **TranscriptViewer.jsx** — View past call transcripts on Lead Profile
2. **CallSummariesCard.jsx** — View AI call summaries on Lead Profile

---

## 📊 Pipeline Status (as of Jan 29)

- **Hot leads:** 3
- **Warm leads:** 3
- **Total leads:** ~200
- **Wins this week:** 0
- **Last win:** Liam Fitzgerald (Jan 23)

**Overdue callbacks:**
- Ardi The Turk — 7h overdue, follow-up from interested call

---

## 🎯 Lead Research Done

### Sydney Contractors (85 leads researched)
- Enriched via Apollo: 35 (41% hit rate)
- Key Tier 1s found: Boral, Holcim, Multiplex, Laing O'Rourke, Hickory
- Plus regional contractors across QLD/VIC/WA/NSW

### Files:
- `contractor-hitlist-final.md` — Target contractors
- `worker-hitlist-final.md` — Target workers
- `sydney-contractors-list.md` — Sydney leads
- `memory/fresh-leads.json` — 85 enriched leads
- `memory/enriched-leads-summary.md` — Summary

---

## 🔍 Competitive Intel

**Main competitors:**
- **Workmate** — workmate.app
- **Sidekicker** — sidekicker.com.au (SEEK bought 100% — competitive threat)
- **Airtasker** — airtasker.com.au

**Key insight (Jan 29):**
Labour hire companies (EIREWORKS, HLH, BDK) can't fill orders. Potential to position RateRight as their *overflow solution* — B2B partnerships not just customers.

**Industry:**
Sydney Metro West — 4 major contracts awarded (Gamuda, 5 stations). Sustained demand for civil trades through 2028+.

---

## 🛠️ Development System

**RIVET-DEV-SYSTEM.md** — How we build/fix things

**Workflow:**
1. **Architect** (sub-agent) → Investigate, plan (INVESTIGATION.md + plan.md)
2. **Michael approval** → Before building
3. **Builder** (sub-agent) → Code, test locally, commit
4. **QA** (sub-agent) → Deploy, verify, document (SOLUTION.md, LESSONS.md)

**Rules:**
- Always approval before: Production deploys, DB migrations, security changes
- Three docs per issue: INVESTIGATION.md, SOLUTION.md, LESSONS.md
- No cowboy coding — follow the plan or escalate

---

## 📁 Notion Structure

| Database | Purpose |
|----------|---------|
| Business State | Daily snapshots, pipeline health |
| Tasks | To-dos, action items |
| Knowledge Base | Objection responses, winning patterns |
| Team | Team member profiles/stats |
| Metrics Dashboard | Weekly metrics, trends |

**Notion Pages Created:**
- Lead Generator Playbook (Mae & Vena)
- Contractor Hit List (Jan 2026)
- Worker Hit List (Jan 2026)

---

## ⏰ Scheduled Tasks

| Time (AEST) | Task |
|-------------|------|
| 2:00 AM | Nightly scan (research) |
| 2:30 AM | Apollo enrichment |
| 4:00 AM | Morning brief + CRM upload |
| 9:00 AM | Onboarding check (Mae/Vena) |
| 12:00 PM | Midday check |
| 6:00 PM | Evening review |
| Mon 7:00 AM | Weekly report |

---

## 🌙 My Nightly Routine

1. **Self-Improvement Scan** — What's clunky? What's missing? Fix or flag it.
2. **Tech Radar** — New AI tools, APIs, automations that could help RateRight.
3. **Competitor Watch** — Workmate, Sidekicker, Airtasker changes.
4. **Industry Pulse** — Sydney construction news, big projects, labour shortages.

---

## 💰 Cost Situation (Action Needed)

**Current spend:** ~$129 in 3 days (~$1,300/month projected)
**Problem:** Running Opus for everything

**Plan:**
- Clawdbot → DeepSeek V3 (~$15/mo)
- Research → Kimi K2.5 (~$5/mo)
- Coding → Claude Code in PowerShell (Max plan)
- **Target:** ~$20/mo

**Waiting for:** OpenRouter API key from Michael

---

## 🔐 Security Notes

- Growth Engine CRM = Michael's app (not Markus)
- API keys in `~/.clawdbot/.env`
- Draft external comms, wait for approval before sending
- Never send without explicit "yes"

---

## 📝 Lessons Learned

1. **Supabase silently returns empty on non-existent columns** — No error, just empty results. Always verify column names.
2. **Position-based scroll detection** — getBoundingClientRect() catches scrolls even when touchmove events are consumed.
3. **URL↔State bidirectional sync** — For browser back button to work, sync URL changes back to state.
4. **Touch scroll triggering click** — Track vertical movement >10px to cancel click.

---

*This is everything I know. I update MEMORY.md and daily logs as I learn more.*

— Rivet 🔧
