# Susan Agent Setup Checklist
**Date:** 2026-02-16  
**Owner:** Implementation roadmap for the complete team  
**Status:** Ready to execute  

---

## Overview

This checklist gets Susan from specification to operational sales agent in **3-5 days**. Work happens in parallel across team members, with clear handoffs and dependencies.

**Timeline:** 2 days foundation → 1 day testing → 2 days full capability  
**Cost:** ~$0/month (Kimi default model, Opus for security only)  
**Risk:** Low (all external comms require approval)  

---

## Phase 1: Foundation Setup (Day 1-2)

### 🟨 Michael's Tasks (30 minutes total)

**Priority 1: Create Telegram Bot** ⏱️ 5 minutes
- [ ] Open @BotFather in Telegram
- [ ] Send `/newbot` command  
- [ ] Bot name: `Susan Sales Bot`
- [ ] Bot username: `@SusanRateRightBot` (or similar if taken)
- [ ] **CRITICAL:** Copy the bot token and send to Rivet securely
- [ ] Add bot to "Rocky & Rivet" group (-1003505625266)
- [ ] Assign bot to "Sales" topic (ID: 4)

**Priority 2: Auto-Send Approval Decision** ⏱️ 10 minutes
- [ ] **Question:** Can Susan auto-send follow-ups to leads you've already contacted?
- [ ] **Recommendation:** Start with NOTHING auto-sends (Phase 1), enable follow-ups after 2 weeks
- [ ] **Decision needed:** What's the threshold? (Suggestion: leads you've called personally = auto-follow-up allowed)

**Priority 3: Growth Engine Access** ⏱️ 5 minutes  
- [ ] Confirm Susan should use same API key as Rivet (full access)
- [ ] OR create dedicated API key for Susan in Growth Engine admin panel
- [ ] Provide key to Rivet for secure storage

**Priority 4: Phone Number Collection Fix** ⏱️ 10 minutes
- [ ] **BLOCKER:** RateRight signup doesn't collect phone numbers
- [ ] **Impact:** Blocks SMS outreach to workers who sign up via website
- [ ] **Action:** Add to Builder's task list (1-2 hour fix)
- [ ] **Alternative:** Susan can work contractor-side while this gets fixed

### 🟦 Rivet's Tasks (4-6 hours)

**Setup Clawdbot Instance** ⏱️ 90 minutes
- [ ] Create new gateway config for Susan on port 18792
- [ ] Configure workspace `/home/ccuser/susan-sales/`
- [ ] Set default model to `moonshot/kimi-chat`  
- [ ] Configure Telegram bot integration (after Michael provides token)
- [ ] Test basic connectivity and heartbeat

**Create Core Files** ⏱️ 120 minutes
- [ ] Copy `susan-soul.md` to `/home/ccuser/susan-sales/SOUL.md`
- [ ] Create `IDENTITY.md` — Sales & Marketing Agent for RateRight
- [ ] Copy Michael's context to `USER.md` 
- [ ] Create sales-specific `AGENTS.md` workflow rules
- [ ] Create `HEARTBEAT.md` with autonomous task checklist
- [ ] Create `TOOLS.md` with Growth Engine API details
- [ ] Initialize `MEMORY.md` with business context

**Configure API Access** ⏱️ 60 minutes
- [ ] Install Growth Engine skill in Susan's workspace
- [ ] Configure API authentication and endpoints
- [ ] Test basic API calls (dashboard, leads, sequences)
- [ ] Install prospector skill for lead enrichment
- [ ] Verify Apollo/Exa API access

**Create Communication Structure** ⏱️ 90 minutes  
- [ ] Create `RIVET-INBOX.md` in Susan's workspace
- [ ] Create `APPROVAL-QUEUE.md` for external comms
- [ ] Set up memory structure (`pipeline/`, `drafts/`, `intel/`)
- [ ] Configure shared file protocols
- [ ] Test gateway-to-gateway messaging (if needed)

### 🟩 Builder's Tasks (Optional - 1-2 hours)

**Phone Number Collection** ⏱️ 60-120 minutes  
- [ ] Add phone number field to worker signup form
- [ ] Update database schema if needed
- [ ] Add phone number to profile display/editing
- [ ] Test signup flow with phone collection
- [ ] **Note:** Not blocking for Susan launch — she can focus on contractors first

---

## Phase 2: Integration & Testing (Day 3)

### 🟦 Rivet's Tasks (2-3 hours)

**Growth Engine Integration Test** ⏱️ 60 minutes
- [ ] Susan fetches dashboard stats successfully
- [ ] Susan creates test lead entry  
- [ ] Susan adds notes to existing leads
- [ ] Susan generates AI intel brief
- [ ] Susan drafts SMS (saves to queue, doesn't send)

**Communication Protocol Test** ⏱️ 45 minutes
- [ ] Susan posts daily report to RIVET-INBOX.md
- [ ] Susan queues draft message in APPROVAL-QUEUE.md  
- [ ] Susan responds appropriately in Sales topic
- [ ] Test heartbeat cycle (autonomous tasks)
- [ ] Verify model routing (Kimi default, Opus for dirty data)

**Autonomous Task Validation** ⏱️ 90 minutes
- [ ] Susan finds leads on job boards (3-5 test leads)
- [ ] Susan enriches leads via Apollo (contact details)
- [ ] Susan saves enriched leads to Growth Engine
- [ ] Susan drafts personalized outreach messages
- [ ] Susan generates competitive intel report
- [ ] Susan produces daily pipeline summary

### 🟨 Michael's Testing (30 minutes)

**Approval Workflow Test** ⏱️ 15 minutes
- [ ] Review drafted SMS in approval queue
- [ ] Approve one message for sending
- [ ] Verify message sends correctly through Growth Engine
- [ ] Confirm Susan logs the approval/send in notes

**Voice & Tone Review** ⏱️ 15 minutes  
- [ ] Read 3-5 drafted messages Susan created
- [ ] Verify Australian business tone (not too formal/corporate)
- [ ] Check $50 pricing messaging is correct
- [ ] Confirm no employment agency language used
- [ ] Approve Susan's communication style OR provide feedback

---

## Phase 3: Full Capability (Day 4-5)

### 🟦 Rivet's Tasks (3-4 hours)

**Pipeline Process Implementation** ⏱️ 120 minutes
- [ ] Susan processes existing 231 leads (categorization)
- [ ] Susan creates intel briefs for top 20 hot leads  
- [ ] Susan designs follow-up sequences for stale leads
- [ ] Susan sets up competitive monitoring routine
- [ ] Susan creates weekly reporting template

**Content Creation Setup** ⏱️ 90 minutes
- [ ] Susan drafts 5 social media posts (LinkedIn focus)
- [ ] Susan creates 3 email templates for different lead types
- [ ] Susan researches and outlines 2 blog post topics
- [ ] Susan builds competitive analysis template
- [ ] Susan creates SEO keyword research process

**Worker Acquisition Prep** ⏱️ 60 minutes (when phone collection is ready)
- [ ] Susan identifies top 10 Facebook groups for backpackers
- [ ] Susan drafts engagement templates for "looking for work" posts  
- [ ] Susan creates worker onboarding sequence
- [ ] Susan builds referral program framework
- [ ] Susan plans hostel partnership outreach

### 🟨 Michael's Tasks (45 minutes)

**Strategic Direction** ⏱️ 30 minutes
- [ ] Review Susan's pipeline categorization  
- [ ] Approve lead prioritization approach
- [ ] Set weekly targets (leads found, drafts created, etc.)
- [ ] Define which lead types get immediate attention
- [ ] Approve content themes and messaging approach

**Final Approval Gates** ⏱️ 15 minutes
- [ ] Review and approve initial SMS sequences
- [ ] Confirm social media content themes  
- [ ] Set limits on autonomous actions (daily quotas)
- [ ] Enable or disable specific heartbeat tasks
- [ ] Give green light for full operation

---

## Success Metrics & Monitoring

### Week 1 Targets (Baseline)
- **Leads found:** 15-20 new contractors
- **Drafts created:** 8-12 outreach messages
- **Pipeline notes:** Activity logged on 50+ existing leads
- **Content output:** 3 social posts, 2 email templates
- **Response rate:** Measure baseline for improvement

### Week 2 Targets (Optimization)
- **Leads found:** 25-30 new contractors  
- **Response rate:** Improve by 20% from Week 1
- **Approval rate:** >90% of drafts approved first time
- **Pipeline velocity:** Average time to first contact <48h
- **Content approval:** All drafted content approved or revised

### Monthly Review Points
- **Conversion funnel:** Track lead → contact → demo → hire
- **Cost analysis:** Model usage costs (should be <$50/month)
- **Quality metrics:** Lead accuracy, message effectiveness  
- **Team integration:** Communication flow with Rivet and Michael
- **Competitive advantage:** Intelligence gathering ROI

---

## Phase 1 vs Phase 2 Capabilities

### Phase 1 Capabilities (Launch Day)
✅ **Lead Discovery** — Find contractors on job boards daily  
✅ **Lead Enrichment** — Apollo contact details and company info  
✅ **Pipeline Management** — Update statuses, add notes, track conversations  
✅ **Outreach Drafting** — Personalized SMS and email drafts (approval required)  
✅ **Competitive Intel** — Monitor competitor pricing and features  
✅ **Daily Reporting** — Pipeline summaries and activity logs  
✅ **Internal Communication** — Team coordination via Telegram and files  

### Phase 2 Capabilities (Week 2-3)
⭕ **Auto Follow-ups** — Send approved follow-ups to leads Michael has contacted  
⭕ **Worker Outreach** — Target backpackers and tradies (needs phone collection fix)  
⭕ **Content Marketing** — Blog posts and SEO content creation  
⭕ **Sequence Enrollment** — Automated nurture campaigns (with approval)  
⭕ **Social Media Management** — LinkedIn posting and engagement  
⭕ **Partnership Outreach** — Hostel and community partnerships  
⭕ **Advanced Analytics** — Conversion tracking and optimization  

---

## Risk Mitigation

### Technical Risks 🔧
- **Growth Engine downtime:** Susan caches leads locally, syncs when restored
- **API rate limits:** Built-in retry logic and batch processing  
- **Model costs:** Kimi default keeps costs near zero, Opus only for security
- **Gateway communication:** Shared files provide reliable backup to WebSocket

### Business Risks 💼
- **Brand damage:** All external comms require approval, hardcoded compliance rules
- **Legal issues:** Clear boundaries on employment vs platform facilitator language
- **Spam perception:** Rate limits on outreach, personalized messages only
- **Quality control:** Regular review cycles and approval workflows

### Operational Risks ⚙️
- **Michael overload:** Approval queue system batches requests efficiently
- **Team miscommunication:** Clear handoff protocols and shared file system
- **Data loss:** Daily backups of all Susan's memory and pipeline data
- **Performance degradation:** Monitoring and alerting on key metrics

---

## Go/No-Go Decision Points

### After Day 2 (Foundation Complete)
**Go Criteria:**
- [ ] Telegram bot working and connected
- [ ] Growth Engine API integration functional
- [ ] Basic lead discovery and drafting working
- [ ] Michael approves Susan's communication style

**No-Go Signals:**
- [ ] API authentication failing repeatedly
- [ ] Model costs exceeding budget ($50/month)
- [ ] Michael uncomfortable with Susan's message quality
- [ ] Major technical blocker requiring Builder time

### After Day 3 (Testing Complete)  
**Go Criteria:**
- [ ] Approval workflow smooth and efficient
- [ ] Susan's autonomous tasks running without errors
- [ ] Pipeline integration accurate and useful
- [ ] No brand compliance violations in test messages

**No-Go Signals:**
- [ ] Approval queue overwhelming Michael
- [ ] Susan creating low-quality leads or drafts  
- [ ] Technical issues causing data loss or corruption
- [ ] Team communication protocols breaking down

---

## Post-Launch Support Plan

### Week 1: Daily Check-ins
- Rivet monitors Susan's output quality
- Michael provides feedback on drafted messages
- Adjust heartbeat frequency and task priorities
- Track early performance metrics

### Week 2-4: Weekly Reviews
- Analyze conversion funnel performance
- Optimize message templates based on response data
- Enable additional autonomous capabilities
- Plan Phase 2 feature rollout

### Month 2+: Strategic Development
- Expand to Phase 2 capabilities
- Launch worker acquisition campaigns
- Develop content marketing engine
- Scale to other Australian cities

---

## Emergency Contacts & Escalation

### Technical Issues
- **Primary:** Rivet (immediate response during work hours)
- **Secondary:** Builder (via Rivet coordination, code issues only)
- **Emergency:** Michael (revenue-impacting issues only)

### Business Issues  
- **Legal questions:** Michael (immediate escalation)
- **Brand compliance:** Rivet → Michael (within 2 hours)
- **Major opportunities:** Susan → Rivet → Michael (same day)

### System Failures
- **Growth Engine down:** Susan continues with local caching
- **Telegram outage:** Use shared files for coordination
- **Complete system failure:** Manual fallback to existing Sales topic workflow

---

**🎯 Ready to launch? Michael creates the bot, Rivet builds the system, Susan starts selling. RateRight's sales machine goes live.**