# CLAUDE.md - RateRight Phone AI

## What This Is
AI phone answering system for RateRight. When calls aren't answered within 5 rings, an AI picks up, qualifies the lead, and logs it to Growth Engine.

## The Goal
Build a working AI receptionist that:
1. Answers unanswered calls on two RateRight numbers
2. Sounds human (Aussie female voice)
3. Qualifies leads (what trade, where, when)
4. Logs leads to Growth Engine CRM
5. Texts/notifies Michael immediately

## Tech Stack
- **Vapi.ai** - AI voice agent (already paid, keys ready)
- **Twilio** - Phone numbers and forwarding (already configured)
- **Growth Engine** - CRM to log leads (existing API)
- **Node.js** - Keep it simple

## Two Phone Lines

### Line 1: +61 468 087 171 (Main RateRight)
- General enquiries
- Workers and contractors calling in
- Script: Friendly, qualifies what they need

### Line 2: +61 426 246 472 (Second line)
- TBD - Michael to specify use case
- Different script

## API Keys Location
- Vapi keys: `~/.env.rateright-phone`
- Twilio: Already in environment (TWILIO_ACCOUNT_SID, TWILIO_API_KEY_SID, etc.)

## Key Files
- `BUILD.md` - Detailed spec (READ THIS FIRST)
- `src/` - Main code
- `scripts/` - Vapi assistant setup, Twilio config

## Working Style
- Keep it minimal - this should be <500 lines total
- Use Vapi's built-in features where possible
- Test each piece as you build
- Log to Growth Engine via its existing API

## When Done
- Both numbers should forward unanswered calls to AI
- AI should sound natural (not robotic)
- Leads should appear in Growth Engine within seconds
- Michael should get a text/Slack notification

## Memory
Check BUILD.md and this file frequently to stay on track.
Don't overcomplicate - this is a weekend MVP.

## Use Your Plugins
You have 24 MCP plugins available. USE THEM:
- **context7** - for documentation lookups
- **playwright** - for testing/browser automation
- **greptile** - for code search
- **Notion** - update Work Tracker when done
- **supabase** - if needed for Growth Engine
- **github** - for commits/PRs

Run `claude mcp list` to see all available tools.
Don't reinvent what plugins already do.