# BRIDGE PROJECT CONTEXT
## For Claude Code: Read This First
This document gives you the full context of what Bridge is, why it exists, and what we're building. Use this to inform all your decisions.
---
## THE BUSINESS: AI Foundations by Amara
Amara runs **AI Foundations** - an education company teaching business teams how to use AI effectively.
**Her core philosophy:**
- "I prompt like shit. But I get glorious results."
- "People just don't know what the tools are ACTUALLY doing and what they are capable of"
- "NO MAKE. ZERO MIDDLEWARE."
- "A plane is only as good as the pilot flying it"
**She's NOT a developer.** She's a business operator who figured out how to use AI tools and wants to teach others. She has:
- HubSpot Diamond Partner status
- ClickUp Partner status
- An existing audience of marketers, agency owners, and business operators
---
## THE PROBLEM WE'RE SOLVING
### Problem 1: AI "Gurus" teach the wrong things
- They teach complex RAG systems when Claude already has 200k context
- They teach building workflows in Make/Zapier when MCP exists
- They teach speed ("make content faster") instead of understanding
### Problem 2: iPaaS platforms (Make, Zapier, N8N) are:
- **Expensive** - charge per operation, costs add up fast
- **Complex** - hours to build workflows, you are the brain
- **Anxiety-inducing** - counting operations, worrying about limits
- **Maintenance nightmares** - you fix it when APIs change
### Problem 3: Official MCP connectors have gaps
- ClickUp's official MCP connector CAN'T create tasks from templates
- This is a critical feature for consistent task creation
- Amara hit this wall during a presentation to a potential customer (Tim)
- If Tim hits walls and gives up, he'll tell others "MCP doesn't work"
---
## THE SOLUTION: BRIDGE
**"You don't need another automation tool. You just need a bridge."**
Bridge is:
1. A **hosted MCP server** that fills the gaps in official connectors
2. A **skills library** of pre-built instructions for common workflows
3. **Flat-rate pricing** ($29/month) - no operation counting
4. **Non-technical friendly** - just connect and ask
### How it's different:
| Make/Zapier | Bridge |
|-------------|--------|
| You build workflows | Claude figures it out |
| Per-operation pricing | Flat rate |
| Hours to set up | Minutes to connect |
| You are the brain | Claude is the brain |
| When API changes, you fix it | We update the server |
### The architecture:
```
┌─────────────────────────────────────────────────────────────┐
│ │
│ Student's AI (Claude or Gemini) │
│ │ │
│ │ (MCP Protocol) │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ BRIDGE MCP Server │ ◄── Hosted by Amara │
│ │ (Google Cloud Run) │ on Google Cloud Run │
│ └──────────┬──────────┘ │
│ │ │
│ ┌──────┴──────┬──────────────┐ │
│ ▼ ▼ ▼ │
│ ClickUp API Skills Repo (Future) │
│ on GitHub HubSpot, Guru, │
│ Analytics, etc. │
│ │
│ Student provides their OWN API keys per request. │
│ Bridge never stores credentials. │
│ │
└─────────────────────────────────────────────────────────────┘
```
---
## BUSINESS MODEL
### Pricing (decided):
| Tier | Price | Includes |
|------|-------|----------|
| **Bridge** | $29/month | MCP server + all connectors + skills library |
| **Bridge + Cohort** | $149/month | Above + monthly live session + community |
| **Bridge + You** | $1,500+ | Custom implementation / consulting |
### Why $29 works:
- Cheaper than Zapier Professional ($73.50/month)
- No operation counting anxiety
- Our actual Cloud Run costs: ~$0.10 per 100 users/month
- **99%+ profit margin**
### The real value isn't the server - it's:
- Pre-built skills (Amara's expertise encoded)
- Community skills (student submissions)
- Ongoing maintenance (we update when APIs change)
- Education (knowing HOW to use it)
---
## WHAT'S IN THIS CODEBASE
### Current Connectors:
**1. ClickUp (`src/connectors/clickup.ts`)**
- Task templates (THE MISSING FEATURE from official MCP)
- Full task CRUD
- Workspace/space/folder/list hierarchy
- Time tracking
- Goals
- Custom fields
- Comments
- Escape hatch for any API endpoint
**2. Skills Library (`src/connectors/skills.ts`)**
- Fetch skills from GitHub repos
- List available skills
- Get skill categories
- Search skills
- Supports multiple repos (official + student's own)
### Planned Connectors (NOT YET BUILT):
- HubSpot
- Guru
- Google Analytics
- More based on student demand
---
## SKILLS LIBRARY CONCEPT
Skills are markdown files that teach AI how to perform specific tasks.
**Example skill structure:**
```
skills-library/
├── project-management/
│ ├── transcript-to-tasks/
│ │ └── SKILL.md # Amara's signature workflow
│ ├── daily-standup-summary/
│ │ └── SKILL.md
│ └── overdue-task-nudger/
│ └── SKILL.md
├── client-management/
│ ├── client-onboarding/
│ │ └── SKILL.md
│ └── meeting-followup/
│ └── SKILL.md
└── sales-ops/
├── hottest-leads-report/
│ └── SKILL.md
└── pipeline-health-check/
└── SKILL.md
```
**How students use skills:**
1. Ask Claude to load a skill: "Load the transcript-to-tasks skill"
2. Bridge fetches the SKILL.md from GitHub
3. Claude reads the instructions
4. Claude follows the skill to complete the task
**The value:** Amara's expertise is encoded in the skills. Students get consistent results without being experts themselves.
---
## TECHNICAL DECISIONS MADE
| Decision | Choice | Why |
|----------|--------|-----|
| Hosting | Google Cloud Run | Scales to zero, pay per use, Amara has GCP account |
| Transport | Streamable HTTP | Works with remote MCP (not just local stdio) |
| Auth model | Per-request API keys | Students provide their own keys, we never store them |
| Skills storage | GitHub repos | Free, versioned, students can fork |
| Language | TypeScript | MCP SDK is TypeScript-first |
---
## IMMEDIATE PRIORITIES
1. **Deploy to Google Cloud Run** - so Amara can share with Tim
2. **Test the ClickUp template endpoint** - make sure it actually works
3. **Create a sample skill** - transcript-to-tasks as proof of concept
---
## CONTEXT: THE TIM SITUATION
Tim is a potential customer who:
- Currently pays $349/month for another AI course
- Was excited by Amara's presentation on MCP
- Hit the template wall during the demo
- If he gives up, he'll spread "MCP doesn't work" messaging
**Amara needs to ship the solution fast** so Tim can:
1. Connect his Claude to Bridge
2. Use his ClickUp API key
3. Create tasks from templates
4. Become an ambassador for Bridge
---
## LONG-TERM VISION
Bridge becomes the "Netflix for AI automation":
- One subscription, unlimited use
- Library of skills grows over time
- Community contributes skills
- Multiple connectors (ClickUp, HubSpot, Guru, etc.)
- Works with Claude, Gemini, and future AI
**The moat:**
- Skills library (Amara's expertise)
- Community (network effects)
- Ease of use (non-technical friendly)
- Trust (Amara's reputation)
---
## AMARA'S VOICE
When writing user-facing content, match her tone:
- Direct, no-BS
- Confident but accessible
- Anti-jargon (explain simply)
- Slightly irreverent
- Focused on outcomes, not process
**Phrases she uses:**
- "That's so AI 1.0"
- "NO MAKE. ZERO MIDDLEWARE."
- "Stop planning. Start doing."
- "Good stewards of AI"
---
## QUESTIONS? ASK AMARA
If you're unsure about a decision, ask! This is her business and she should make the calls.
Good luck, Claude Code. Let's build this bridge. 🌉
