The SMS Copilot Console Playbook

Cold-SMS auto-reply: an LLM brain that drafts, and code that decides.

SMS-COPILOT-CONSOLE-PLAYBOOK.md · 15 sections · 5,121 words · 43 KB · markdown

An auto-reply system for cold SMS where the model classifies and drafts, but every decision with a real-world side effect gets re-derived in code on the server. Includes a champion/challenger bandit, a self-improving mistakes knowledge base, four workers, and an admin console to watch it run dry before you let it send.

What's inside

//The full loop: poll → queue → classify + draft → deterministic decision gate → send
//A secret-gated callback API the brain can reach without any DB credentials
//A champion/challenger Thompson bandit for message variants
//A self-improving mistakes knowledge base
//Four background workers + an Activity and Analytics console
//Dry-run-first rollout, so nothing sends until you flip it on

When to use it

Cold-outreach apps with an SMS list, after the admin console.

Build these first

Admin Console, GoHighLevel Integration

Straight from the file

Built from the BKE / Kompozy implementation (LIVE dry-run verified 2026-07-15). Reference repo: reference app. Plan docs: Active/KOMPOZY-COLD-SMS/TIER3_AUTOREPLY_PLAN.md, REPLY_KNOWLEDGE_BASE.md, SMS_COPILOT_ANALYTICS_GAMEPLAN.md.

Table of contents

0. Use this spec
1. Architecture — the loop (read this first)
2. Design system — the console look (copy verbatim)
3. Auth — two guards, one system
4. Page — Activity (sms-copilot/page.tsx + SmsCopilotView.tsx)
5. Page — Analytics (sms-copilot/analytics/page.tsx + AnalyticsView.tsx)
6. Admin API routes (4) — reference
7. Public secret-gated routes (5) — reference
8. The engine layer (lib + workers)
9. Schema — migrations 00177–00184
10. Env vars + secrets
11. Invariants to preserve (do not regress)
12. Build sequence (slices — pause after each for review)
13. Kickoff prompt
14. Reference files in BKE

How to run it

Drop SMS-COPILOT-CONSOLE-PLAYBOOK.md into your repo, then tell Claude Code: “Read SMS-COPILOT-CONSOLE-PLAYBOOK.md and implement it in this codebase.” It's written for an agent to execute end to end. Search the file for angle-bracket placeholders and swap in your own project names, domains, and keys before the first run.

↓ Download the playbook

More outreach playbooks

A-tier

← All 28 Claude templates

The SMS Copilot Console Playbook

Publishing Pipeline

Cold Email Campaign

GoHighLevel Integration