# RateRight — Comprehensive Briefing Document

**Generated:** 2026-02-06 (AEST)
**Scope:** Platform status, development, features, blockers, voice/VAPI, finance/Stripe
**Sources:** MEMORY.md, daily logs (Feb 3–6), topic files, plans/, codebase inspection

---

## 1. EXECUTIVE SUMMARY

RateRight is an AI-first construction worker marketplace undergoing a complete rebuild (v2). The platform pivoted from a 9.9% commission model to a **$50 flat-fee per hire** model in early February 2026. The v2 Next.js + Supabase app is scaffolded with 11 routes, builds cleanly, and has been pushed to GitHub. Core features (auth, signup flows, messaging UI, ABN lookup, AI profile builder, PWA) are scaffolded but **not production-deployed**. Stripe payment integration is designed but not implemented. Voice/VAPI is operational for calls but read-only. The Growth Engine CRM is healthy on Railway. No production deployment of v2 has occurred yet.

**Status: Pre-launch / Active development. Earliest deploy target: ~2–3 weeks with focused effort.**

---

## 2. BUSINESS MODEL (v2 — February 2026)

| Aspect | Detail |
|--------|--------|
| **Pricing** | $50 flat fee per hire (individual), $100 per crew, bulk rate for agencies |
| **Worker cost** | $0 — workers keep 100% of their rate, always |
| **Legal framing** | Matching service, NOT labour hire |
| **Crew feature** | Unique differentiator — no flat-fee crew hire exists in AU |
| **Agency channel** | B2B: one agency = 20–50 placements/month = $1k–$2.5k/month |
| **Payment protection** | Optional $10/week worker insurance, max payout = 1 week's wages (⚠️ may need AFSL) |
| **Competitors** | Workmate, Sidekicker, Airtasker, HiPages, SEEK, traditional agencies — none do flat-fee + AI |

**Key positioning:** "Like Uber/DoorDash, NOT like Hipages/Airtasker." Simple matching, flat fee, done.

---

## 3. CURRENT PLATFORM STATUS

### 3.1 RateRight v2 App (`/home/ccuser/rateright-v2`)

| Item | Status |
|------|--------|
| **Repo** | `RateRight-PTY-LTD/the-50-dollar-app` on GitHub |
| **Stack** | Next.js 16.1.6, React 19.2.3, Supabase, Tailwind CSS, shadcn/ui, TypeScript 5.9 |
| **Build** | ✅ Compiles cleanly |
| **Local dev** | ⚠️ Not currently running (`localhost:3000` unresponsive) |
| **Production deploy** | ❌ Not deployed — no hosting configured yet |
| **Git status** | Clean working tree, 9 commits |

**Routes implemented (11 total):**
- `/` — Landing page
- `/auth/login`, `/auth/signup`, `/auth/verify-email`, `/auth/callback`
- `/contractor/signup`, `/contractor/post-job`, `/contractor/matches`
- `/worker/signup`, `/worker/profile/build`, `/worker/jobs`
- `/dashboard`
- `/messages`, `/messages/[conversationId]`

**API routes:**
- `/api/abn-lookup` — ABR integration (mock mode until GUID obtained)
- `/api/ai/generate-profile` — AI profile generation
- `/api/company-logo` — Company logo fetch
- `/api/auth/verify-email` — Email verification

**Components:** Bottom nav, MessageBubble, ConversationPreview, sign-out button, full shadcn/ui library

### 3.2 Growth Engine CRM

| Item | Status |
|------|--------|
| **URL** | https://rateright-growth-production.up.railway.app |
| **Health** | ✅ Healthy (API ok, DB ok, OpenAI configured) |
| **Version** | 1.0.1, build 2026-01-15-v2 |
| **Uptime** | ~24+ hours at time of check |
| **SMS sequences** | Updated with new $50 model messaging (Feb 5) |
| **Status** | Paused for outreach — waiting on business model pivot to settle |

### 3.3 Infrastructure

| Resource | Detail |
|----------|--------|
| **VPS** | DigitalOcean syd1, 2 vCPU, 8GB RAM, 77GB disk (18% used) |
| **Clawdbot** | Gateway running on port 18789, Opus 4.5 via OAuth |
| **Supabase** | Active (Postgres, Auth, Realtime, Storage) |
| **Domain** | rateright.com.au (GoDaddy) — DNS not yet pointed to v2 |
| **Tailscale** | VPS connected, exit node configured (phone approved) |

---

## 4. RECENT DEVELOPMENT WORK (Feb 3–6, 2026)

### Feb 4 — "Ultimate System Build Day"
- Full system redesign: 12 cron jobs → 5, INBOX/OUTBOX → native sub-agents
- Product spec written (443 lines): `plans/rateright-v2-product-spec.md`
- v2 app scaffolded with Claude Code: Next.js 16, Supabase auth, all core routes
- Three-tier pricing model defined ($50 / $100 / agency bulk)
- Voice call system explored — VAPI adopted over Clawdbot plugin
- Marketing research completed
- Git pushed to `RateRight-PTY-LTD/the-50-dollar-app`

### Feb 5 — "Autonomous System Day"
- 10+ tasks completed autonomously by agent system
- UX improvements: glove-first design, swipe-to-apply, consolidated flows
- Brand voice guide created and updated with $50 pricing
- Competitor analysis: 6 competitors mapped (`plans/competitor-analysis.md`)
- SMS sequences rewritten for new model (worker intro 3 msgs, contractor intro 4 msgs)
- Growth Engine SMS templates updated in database
- AI Profile Builder feature added and committed
- YouTube transcript pipeline built
- WhatsApp channel connected to Clawdbot
- ABN validated: 62 841 523 907 — RateRight Pty Ltd

### Feb 6 — "Stabilization & Spec Day"
- Worker signup bug fixed (added error handling to `handleConfirm()`)
- ABR API integration completed (both repos, modulus-89 validation)
- Messaging UI scaffolded (conversation list + chat view, iMessage-style)
- LinkedIn content pipeline script created
- **6 major design specs completed autonomously:**
  1. ✅ VAPI webhook tools spec (`plans/vapi-webhook-tools-spec.md`)
  2. ✅ Stripe payment flow design (`plans/stripe-payment-flow.md`)
  3. ✅ Voice signup flow design (`plans/voice-signup-flow.md`)
  4. ✅ Messaging UI (implemented + committed)
  5. ✅ LinkedIn content pipeline (script ready)
  6. ✅ Git history cleanup (132MB venv removed)
- Claude Code reviewed Stripe spec → found 22 issues (5 critical security holes)
- Coding pipeline documented: Kimi drafts → Claude Code reviews

---

## 5. PENDING FEATURES & IMPLEMENTATION STATUS

### Core Features

| Feature | Design | Implemented | Notes |
|---------|--------|-------------|-------|
| Contractor signup + AI company research | ✅ | ⚠️ Partial | ABN lookup works (mock mode), AI profile gen scaffolded |
| Worker signup (typed) | ✅ | ⚠️ Partial | Form exists, error handling fixed, DB write needs testing |
| Worker voice signup | ✅ Designed | ❌ | `plans/voice-signup-flow.md` — Web Speech API + Whisper fallback |
| Job posting with AI suggestions | ✅ | ⚠️ Partial | Route exists, AI assistance not wired |
| Smart matching algorithm | ✅ Specced | ❌ | Distance + experience + ratings + availability |
| One-tap hire flow | ✅ | ❌ | Requires Stripe integration |
| Stripe $50 payment | ✅ Designed | ❌ | `plans/stripe-payment-flow.md` — Checkout recommended, 2–3 day build |
| Push notifications | ✅ Specced | ❌ | PWA service worker ready |
| Ratings system | ✅ Specced | ❌ | DB schema designed |
| In-app messaging | ✅ | ⚠️ UI only | MessageBubble + ConversationPreview components, no backend |
| White Card verification (OCR) | ✅ Specced | ❌ | Gemini for image analysis |
| Crew hire feature | ✅ Specced | ❌ | Unique differentiator — $100 per crew |

### Supporting Systems

| System | Status | Notes |
|--------|--------|-------|
| **PWA** | ✅ Configured | manifest.json, service worker, icons |
| **ABR/ABN validation** | ✅ Code complete | Mock data until GUID obtained |
| **Content engine** | ✅ Planned | LinkedIn pipeline script ready, blog templates created |
| **SMS sequences** | ✅ Updated | Worker (3 msgs) + Contractor (4 msgs) rewritten |
| **Construction glossary** | ✅ | Links, conduits, cages, shutters, aids |
| **Work log system** | ⚠️ Basic | Git-based, Notion sync planned |

---

## 6. BLOCKERS

### 🔴 Critical (Blocking Launch)

| Blocker | Owner | Action Required | ETA |
|---------|-------|-----------------|-----|
| **ABR GUID registration** | Michael | Register at abr.business.gov.au (5-min form) | ~1 business day approval |
| **Production deployment** | Rivet/Michael | Choose host (Fly.io preferred, not Vercel), configure DNS | 1–2 days |
| **Stripe account setup** | Michael | Create/configure Stripe account, get API keys | 1 day |
| **Supabase production schema** | Rivet | Run migrations for payments, hires, ratings tables | 2–4 hours |

### 🟡 Important (Blocking Key Features)

| Blocker | Owner | Action Required | ETA |
|---------|-------|-----------------|-----|
| **Notion API integration** | Michael | Share Notion workspace with Clawdbot | 10 min |
| **Apollo/Exa API keys** | Michael | For prospector skill (lead enrichment) | N/A |
| **DNS for rivet.rateright.com.au** | Michael | Point to 134.199.153.159 in GoDaddy | 5 min |
| **AFSL determination** | Legal | Payment protection may require Australian Financial Services License | Research needed |
| **Labour hire licensing** | Legal | Required in QLD/VIC/ACT if operating as labour hire | Research needed |

### 🟢 Minor / Nice-to-Have

| Item | Note |
|------|------|
| Telegram Topics group | Michael needs to create group with topics for parallel conversations |
| Clawdbot update to latest | Needed for Claude Opus 4.6 model support |
| WhatsApp eSIM | For posting site reports to work groups |

---

## 7. VOICE / VAPI INTEGRATION STATUS

### Current Setup

| Component | Status | Detail |
|-----------|--------|--------|
| **VAPI Assistant** | ✅ Active | ID: `63ac4ff9-e562-4c8e-9c19-c1f1c87ed034` |
| **Phone line** | ✅ Active | +61 238 205 443 (Twilio) |
| **Voice** | Rachel (ElevenLabs) | Also tested: GPT-4o Realtime Coral, GPT-4o-mini |
| **Brain** | Claude Sonnet | ~900ms latency |
| **Context injection** | ✅ Working | `scripts/update-vapi-context.sh` (TODO + daily memory → system prompt) |
| **Transcript processing** | ✅ Script ready | `scripts/process-vapi-calls.sh` |
| **Clawdbot voice plugin** | ❌ Disabled | 6s latency, notification-only, too slow for conversation |

### Tested Model Configurations

| Model | Latency | Cost/min | Status |
|-------|---------|----------|--------|
| Claude Sonnet + Rachel | ~900ms | ~$0.06 | ✅ Current production |
| GPT-4o Realtime | ~300ms | ~$0.08 | 🧪 Tested, fastest |
| GPT-4o-mini + Rachel | ~700ms | ~$0.04 | ✅ Works |
| Groq + Llama | ~465ms | ~$0.02 | Not tested yet |
| DeepSeek | N/A | Near-free | ❌ Failed (can't do real-time) |

### Key Limitation
VAPI-Rivet is a **separate Claude brain** — it can read context but cannot write files, trigger actions, or interact with the main Rivet system. The workaround is: pull transcripts after calls → process action items → feed back to main Rivet.

### Pending VAPI Work
- **Webhook tools server** — Designed (`plans/vapi-webhook-tools-spec.md`): 4 endpoints (Create TODO, Check Availability, Lookup Lead, Schedule Follow-up). Express.js, HMAC signature validation. **Not implemented yet.**
- **Voice signup flow** — Designed (`plans/voice-signup-flow.md`): Phone + SMS verification, voice profile creation in 2.5 mins, Web Speech API primary. **Not implemented yet.**

---

## 8. FINANCE / STRIPE STATUS

### Current State: **DESIGNED, NOT IMPLEMENTED**

**Design document:** `plans/stripe-payment-flow.md`

| Aspect | Decision |
|--------|----------|
| **Method** | Stripe Checkout (hosted payment page) |
| **Amount** | $50 AUD flat fee per hire |
| **Net revenue** | ~$48.82 domestic / ~$48.25 international (after Stripe fees) |
| **Refund policy** | No refunds once contact details accessed |
| **Implementation estimate** | 11–16 hours (2–3 days) |

**Required for implementation:**
1. Stripe account created and API keys obtained (test mode first)
2. Install `stripe` npm package
3. Create 4 API endpoints: create-checkout-session, webhook, status, hire-confirm
4. Create `payments` and `hires` database tables
5. Frontend: "Hire Worker" button, confirmation modal, success/cancel pages

**Security review (Claude Code, Feb 6):**
- 22 issues found in original Kimi spec
- **5 Critical:** Webhook signature spoofing, success page bypass, hires endpoint attack surface
- **5 High:** Race conditions, idempotency, expired session handling
- **6 Medium:** Validation gaps, nullable fields, fee timing
- All issues documented, none blocking implementation start

### Revenue Projections (from product spec)

| Milestone | Hires/month | Revenue |
|-----------|-------------|---------|
| Month 1 (launch) | 10 | $500 |
| Month 3 | 100 | $5,000 |
| Month 6 | 500 | $25,000 |

---

## 9. TEAM & OPERATIONS

| Person | Role | Status |
|--------|------|--------|
| **Michael ("Rocky")** | Founder, steelfixer/formworker | Working at Arncliffe for Ford Civil (Parramatta) via LF Construction Services |
| **Markus** | Full-stack dev (Philippines) | Platform dev — separate workspace (`mcloughlinmichaelr-debug`) |
| **Rivet** | COO system / AI agent | Autonomous development, specs, research, monitoring |

**Financials:** Father in Ireland provides financial backing (family trust). Every dollar matters — keep costs low.

**Company details:**
- RateRight Pty Ltd
- ABN: 62 841 523 907
- Address: Elizabeth Street, Surry Hills NSW
- Website: rateright.com.au

---

## 10. RECOMMENDED PRIORITIES (Next 2 Weeks)

### Week 1: Foundation
1. **ABR GUID registration** (Michael, 5 min + 1 day wait)
2. **Stripe account setup** (Michael, 30 min)
3. **Stripe integration implementation** (Rivet/Claude Code, 2–3 days)
4. **Database migrations** — payments, hires, ratings tables (Rivet, 2–4 hours)
5. **Production deployment** to Fly.io (Rivet, 1 day)

### Week 2: Core Features
6. **Smart matching algorithm** implementation
7. **Push notifications** (PWA already configured)
8. **Ratings system** implementation
9. **Worker signup end-to-end testing** (with real Supabase)
10. **DNS configuration** — point rateright.com.au to production

### Ongoing
- Content engine activation (LinkedIn 3x/week)
- VAPI webhook tools server implementation
- Voice signup flow (Phase 2)
- Crew hire feature (Phase 2)

---

## 11. KEY FILES REFERENCE

| File | Purpose |
|------|---------|
| `plans/rateright-v2-product-spec.md` | Full 443-line product specification |
| `plans/stripe-payment-flow.md` | Stripe Checkout integration design |
| `plans/voice-signup-flow.md` | Voice-first worker signup UX |
| `plans/vapi-webhook-tools-spec.md` | VAPI webhook endpoints for phone-Rivet |
| `plans/competitor-analysis.md` | 6-competitor market analysis |
| `plans/content-engine-plan.md` | LinkedIn + SEO content automation |
| `plans/brand-voice-guide.md` | RateRight messaging tone and style |
| `plans/coding-pipeline.md` | Kimi drafts → Claude Code reviews workflow |
| `plans/construction-management-system.md` | Notion site logbook system (future) |
| `topics/business.md` | Business model & pricing details |
| `topics/technical.md` | System architecture & integrations |
| `2025-02-06-abr-integration.md` | ABR/ABN integration completion notes |

---

*Report compiled by research subagent from 60+ files across rivet workspace and rateright-v2 codebase.*
*Last updated: 2026-02-06*