Clone this repo. Open it in Claude Code. Say
onboard. You now have a marketing, sales, research, strategy, content, intelligence, and management team working for you.
No API keys. No pip install. No configuration. Just results.
Quick Start · All Teams · Workflows · Obsidian Setup · Save Credits
- Introduction
- Quick Start
- The 8 Teams
- Commands
- Workflows
- How It Works
- Obsidian Setup Guide
- Project Structure
- Templates
- Quality Gate
- Credit-Saving Guide
- ROI Tracking
- Battle-Tested
- Step-by-Step Walkthrough
- Multi-Client Support
- Contributing
- License
Most businesses can't afford a full-service agency. The ones that can still wait weeks for deliverables and pay $150/hr for work that's often generic.
AI Agency in a Box changes that.
It's a complete agency system -- 8 specialized teams with 113+ AI agents -- that runs entirely inside Claude Code. No external APIs. No monthly SaaS fees. No complex setup.
Here's what makes it different from other AI tools:
- It's not one agent -- it's a full agency. 8 teams with distinct specializations. Marketing alone has 60 agents across 13 sub-teams.
- It remembers everything. An Obsidian-compatible vault stores your brand voice, competitor research, campaign history, and every deliverable. Every session builds on the last.
- It delivers real output. Blog posts, email campaigns, landing pages, competitive analyses, sales proposals, SEO strategies -- actual ready-to-use deliverables, not summaries.
- It checks its own work. Every deliverable passes through a quality gate that verifies brand voice, factual accuracy, completeness, and formatting.
- It does real research. The Research team uses web search to pull real market data, real competitor info, and real industry stats -- with sources cited.
- It saves you credits. Built-in efficiency rules and a credit-saving guide help Claude Pro users reduce token usage by 40-70%.
git clone https://github.com/z1fex/Agency-in-a-BOX.git
cd Agency-in-a-BOXOpen the folder in Claude Code -- works with CLI, VS Code extension, or desktop app. Claude reads the CLAUDE.md file automatically and becomes your agency.
You: onboard
The agency interviews you in 5 phases:
- Company Basics -- name, industry, products, pricing, value proposition
- Target Market -- ideal customer, pain points, channels, deal size
- Competition -- top competitors, your differentiation, their strengths
- Brand & Voice -- personality, tone, words to use/avoid, example content
- Goals -- business goals, challenges, 90-day success criteria, budget
After the interview, the agency automatically creates 5 files in your vault:
| File | What It Contains |
|---|---|
profile.md |
Complete company overview |
brand-voice.md |
Tone, style, dos and don'ts with writing samples |
competitors.md |
Competitive landscape analysis |
icp.md |
Ideal customer profile with messaging |
goals.md |
Goals, KPIs, 90-day success criteria, recommended actions |
You: workflow content-month
The agency researches trends, plans a content calendar, writes 4 blog posts, 30 social media posts, 4 newsletters, and 2 video scripts -- all tailored to your brand voice.
You: dashboard
See everything the agency has produced, active campaigns, and estimated cost savings.
| Team | Agents | What They Do |
| 🔴 Marketing | 60 | SEO, social media, email campaigns, Google/Meta ads, landing pages, brand management, analytics, influencer marketing, A/B testing, competitive analysis, community management, PR -- organized into 13 specialized sub-teams |
| 🟠 Sales | 10 | Lead generation, qualification, cold outreach, call analysis, proposals, CRM management, pipeline tracking, follow-ups, forecasting, competitive battlecards |
| 🔵 Intelligence | 10 | Competitor monitoring, market research, sentiment analysis, trend detection, price tracking, news monitoring, social listening, web scraping, data analysis, industry reports |
| 🟢 Strategy | 7 | SWOT analysis, growth strategy, pricing optimization, market entry planning, resource allocation, risk assessment, business model analysis |
| 🟣 Content | 10 | Blog posts, copywriting, social content, newsletters, video scripts, podcast scripts, whitepapers, content repurposing, editorial calendars, performance analysis |
| 🔍 Research | 8 | Deep market analysis (TAM/SAM/SOM), competitor teardowns, product landscape mapping, company profiling, industry scanning, customer behavior research, technology scouting, research synthesis |
| 🟡 Direction | 4 | OKR setting, priority management (ICE/RICE scoring), vision alignment, data-driven decision frameworks |
| ⚪ Managing | 4 | Task coordination, quality review, progress reporting, cross-team coordination |
| Sub-Team | Agents | Focus |
|---|---|---|
| SEO | 6 | Keyword research, content optimization, technical audits, rank tracking |
| Social Media | 6 | Content scheduling, platform-specific copywriting, engagement |
| 6 | Campaign building, cold outreach, nurture sequences, analytics | |
| Advertising | 8 | Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, creative, budgets |
| Landing Pages | 4 | Copywriting, conversion optimization, sales decks |
| Brand | 3 | Voice management, brand guidelines, messaging consistency |
| Analytics | 5 | Dashboards, web tracking, report generation, KPI monitoring |
| Influencer | 4 | Scouting, vetting, campaign coordination, outreach |
| A/B Testing | 3 | Experiment design, copy variants, results analysis |
| Competitive | 5 | Intelligence gathering, market research, trend analysis, positioning |
| Campaign | 5 | Planning, asset creation, scheduling, budgets, performance tracking |
| Community | 3 | Management, content curation, engagement tracking |
| PR | 3 | Press releases, media outreach, coverage tracking |
| Agent | What It Does |
|---|---|
| Market Analyst | TAM/SAM/SOM calculation, market sizing, growth projections, segment analysis |
| Competitor Deep Diver | Thorough competitor teardowns -- website, pricing, features, funding, reviews, content strategy |
| Product Researcher | Product landscape mapping, feature comparison matrices, gap analysis |
| Company Profiler | Complete company dossiers -- team, funding, revenue, tech stack, culture, strategy |
| Industry Scanner | Full industry landscape -- players by tier, M&A, regulations, technology shifts |
| Customer Researcher | Voice-of-customer from reviews, Reddit, forums -- sentiment, pain points, buying triggers |
| Technology Scout | Emerging tech radar -- GitHub trending, Product Hunt, build-vs-buy analysis |
| Research Compiler | Synthesizes all research into one executive brief with confidence levels and recommendations |
| Command | What Happens |
|---|---|
onboard |
Interactive 5-phase client interview -- builds your complete profile (5 vault files) |
switch client [name] |
Switch between multiple client profiles |
run marketing |
Activate the marketing team (choose sub-team or run all) |
run sales |
Activate the sales team |
run intelligence |
Activate the intelligence team |
run strategy |
Activate the strategy team |
run content |
Activate the content team |
run research |
Activate the research team -- deep market/competitor/product analysis |
run direction |
Activate the direction team |
run managing |
Activate the managing team |
workflow [name] |
Run a pre-built workflow chain (see below) |
dashboard |
View agency status, active campaigns, deliverables, stats |
roi |
See what the agency has produced and estimated cost savings |
save credits |
Show credit-saving tips for Claude Pro users |
watch competitors |
Run the competitive intelligence autopilot |
qa [file] |
Run quality gate on any deliverable |
list teams |
Show all 8 teams and their agents |
list workflows |
Show all 9 available workflows |
status |
Current client, active campaigns, recent work |
Each workflow chains multiple agents together. One command delivers a complete package.
| Workflow | Steps | What You Get |
| 🚀 Product Launch | 11 | Market research, competitor analysis, positioning, 3 blogs, 30 social posts, email sequence, ad copy, landing page, press release, launch calendar |
| 🎯 Lead Generation | 8 | ICP research, 50-lead list, qualification scoring, 5 outreach email variants, follow-up sequence, battlecards, proposal template |
| 📝 Content Month | 7 | Trend research, content calendar, 4 blogs, 30 social posts, 4 newsletters, 2 video scripts, repurposing plan |
| 🔍 Competitor Report | 8 | Competitor scraping, SWOT per competitor, feature comparison, pricing analysis, positioning map, battlecards, final report |
| 🎨 Brand Audit | 6 | Brand analysis, voice audit, messaging framework, brand guidelines, editorial style guide |
| 📈 SEO Overhaul | 8 | Technical audit, 100 keywords, competitor SEO, content gaps, 5 optimized posts, meta descriptions, internal linking strategy |
| 📧 Email Sequence | 6 | Audience segments, welcome series (5), nurture series (5), re-engagement (3), 39 A/B subject line variants |
| 📱 Social Media Blitz | 7 | Platform strategy, 30 posts, hashtag playbook, engagement plan, community guidelines |
| 🧠 Full Strategy | 10 | OKRs, SWOT, market research, competitive analysis, growth + marketing + sales + content strategy, 90-day plan, KPI dashboard |
┌─────────────────────────────────────────────────────┐
│ YOU GIVE AN OBJECTIVE │
│ "Launch my product" / "Get me leads" │
└─────────────────────┬───────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ CLAUDE.md routes to the right team(s) │
└─────────────────────┬───────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ Agent reads your client profile from the vault │
│ (brand voice, competitors, ICP, goals) │
└─────────────────────┬───────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ Agent researches using web search & web fetch │
│ (real data, real competitors, cited sources) │
└─────────────────────┬───────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ Agent produces deliverable using templates │
│ (blog posts, emails, reports, proposals) │
└─────────────────────┬───────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ Quality gate verifies everything │
│ (brand voice, accuracy, completeness, formatting) │
└─────────────────────┬───────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ Saved to vault (memory) + output/ (delivery) │
│ Dashboard and ROI tracker updated automatically │
└─────────────────────────────────────────────────────┘
The vault/ folder is an Obsidian-compatible knowledge base. It's the agency's brain -- it remembers your brand, research, campaigns, and every deliverable across sessions.
| Feature | Why It Matters |
|---|---|
| Visual knowledge graph | See how clients, campaigns, research, and deliverables connect visually |
| Bidirectional links | [[Client Name]] creates a web of context automatically |
| Free and open source | Just a folder of markdown files -- no vendor lock-in |
| You can edit too | Add notes, correct info, and the agency picks it up next session |
Step 1: Download Obsidian for free from obsidian.md
Step 2: Open Obsidian and click "Open folder as vault"
Step 3: Navigate to this project and select the vault/ folder
Step 4: You'll see the full agency knowledge base:
vault/
├── 00-Dashboard/ → Agency dashboard + ROI tracker
├── 01-Clients/ → Client profiles (created during onboarding)
├── 02-Campaigns/ → Campaign tracking
├── 03-Research/ → Market research, trends, reports
├── 04-Intelligence/ → Competitor monitoring, sentiment data
├── 05-Content/ → Content library, calendars, drafts
├── 06-Sales/ → Leads, proposals, pipeline
├── 07-Strategy/ → SWOT analyses, growth plans, pricing
└── 08-Operations/ → QA reviews, progress reports
Step 5: After onboarding a client, open Graph View (left sidebar) to see your knowledge web with all the connections between clients, research, campaigns, and deliverables.
Don't have Obsidian? No problem. The files are just markdown. Browse them in VS Code, any text editor, or let the AI manage everything automatically.
Agency-in-a-BOX/
│
├── CLAUDE.md # The brain — tells Claude Code how the agency works
├── README.md # You are here
├── LICENSE # MIT
│
├── agents/ # 75 agent prompt files across 8 teams
│ ├── marketing/ # 60 agents, 13 sub-teams
│ ├── sales/ # 10 agents
│ ├── intelligence/ # 10 agents
│ ├── research/ # 8 agents (NEW in v2)
│ ├── strategy/ # 7 agents
│ ├── content/ # 10 agents
│ ├── direction/ # 4 agents
│ ├── managing/ # 4 agents
│ └── _base/ # Quality standards for all agents
│
├── workflows/ # 9 pre-built workflow chains
├── templates/ # 12 professional deliverable templates
├── tools/ # 7 free tool guides + 3 helper scripts
├── onboarding/ # Client interview and profile builder
├── quality/ # Quality gate checklist
│
├── vault/ # Obsidian vault (persistent memory)
│ ├── 00-Dashboard/ # Agency dashboard + ROI tracker
│ ├── 01-Clients/ # Client profiles
│ ├── 02-Campaigns/ # Campaign tracking
│ ├── 03-Research/ # Market research, trends
│ ├── 04-Intelligence/ # Competitor monitoring
│ ├── 05-Content/ # Content library, calendars
│ ├── 06-Sales/ # Leads, proposals, pipeline
│ ├── 07-Strategy/ # SWOT, growth plans
│ └── 08-Operations/ # QA reviews, reports
│
└── output/ # Final deliverables by client/date
12 professional templates that agents use to produce polished deliverables:
| Template | What It Produces |
|---|---|
marketing-strategy.md |
Full marketing strategy with market analysis, positioning, channels, budget, KPIs |
seo-audit-report.md |
Technical SEO audit with issues, rankings, competitor comparison, action plan |
content-calendar.md |
Monthly content calendar with dates, platforms, topics, status tracking |
sales-proposal.md |
Client proposal with scope, timeline, pricing, terms, next steps |
competitive-analysis.md |
Competitor report with feature matrix, pricing comparison, SWOT per competitor |
email-campaign.md |
Email sequence with 5 emails, subject lines, A/B variants, success metrics |
social-media-batch.md |
30-post social media batch across platforms with hashtags and scheduling |
weekly-report.md |
Weekly progress report with metrics, completed work, blockers, next steps |
monthly-report.md |
Monthly agency report with KPIs, team activity, revenue impact, priorities |
swot-analysis.md |
SWOT framework with cross-analysis (SO/WO/ST/WT) and priority actions |
press-release.md |
AP-style press release with headline, quotes, boilerplate |
case-study.md |
Case study with challenge, solution, results (with before/after metrics) |
Every deliverable passes through a quality gate before delivery. No exceptions.
| Check | What Gets Verified |
|---|---|
| Brand Voice | Matches your personality, tone, approved/banned words from brand-voice.md |
| Factual Accuracy | All facts verified via web search. All claims have cited sources. |
| Completeness | No placeholders, no TODOs, no empty sections. Every deliverable is finished. |
| Specificity | Tailored to YOUR business. Never generic advice that could apply to anyone. |
| Formatting | Professional structure. Templates used when appropriate. |
| Vault Integration | Saved to vault with [[wikilinks]]. Dashboard and ROI tracker updated. |
Built for Claude Pro users who want to maximize output per credit.
| Technique | Savings | How |
|---|---|---|
/compact at 60% context |
40-60% per session | Compress context while cache is warm |
| Batch related tasks | Up to 5x savings | One prompt with 5 tasks instead of 5 prompts |
| Use Sonnet for routine work | ~70% cheaper | Switch to Opus only for complex strategy |
/clear between workflows |
Prevents bloat | Fresh context for each workflow |
| Specific prompts | Fewer tokens | Name the agent file, state the outcome |
| Reuse vault research | Skip redundant work | Check vault before re-researching |
| Skip known workflow steps | Save entire steps | If vault has competitor data, skip that step |
Full guide: tools/credit-saving.md
Every deliverable is tracked in vault/00-Dashboard/ROI Tracker.md against the industry agency rate of $150/hr.
| Deliverable | Hours Saved | Value |
|---|---|---|
| Blog post (1,500 words) | ~2.5 hrs | $375 |
| 30 social media posts | ~30 hrs | $4,500 |
| Email campaign (5 emails) | ~10 hrs | $1,500 |
| Competitor analysis | ~3 hrs | $450 |
| Marketing strategy | ~8 hrs | $1,200 |
| Full strategy package | ~40 hrs | $6,000 |
| SEO audit + 100 keywords | ~12 hrs | $1,800 |
| Sales proposal | ~4 hrs | $600 |
A single workflow content-month produces ~40 deliverables worth $3,000+ in agency fees.
A single workflow full-strategy produces ~15 deliverables worth $6,000+ in agency fees.
This system was tested with 5 simulations across wildly different business types before release:
| Simulation | Business Type | What Was Tested | Result |
|---|---|---|---|
| FreshBrew Coffee | D2C specialty coffee | Onboarding, content-month workflow, social media, quality gate | PASS |
| NexusAI | B2B SaaS (AI support platform) | Product launch, market research, positioning, landing page | PASS |
| VelvetThread | D2C sustainable fashion | Research team, SWOT, editorial blog writing, brand voice | PASS |
| ShieldOps | B2B enterprise cybersecurity | Sales team, cold outreach, technical tone, lead generation | PASS |
| LoopAI | Pre-launch AI startup ($0 revenue) | Direction team OKRs, build-in-public content, $500 budget | PASS |
Every bug found during simulations was fixed before release. The quality gate caught real issues in every run -- proof that it works.
Here's exactly what happens when you use the agency:
You: onboard
Agency: Welcome to your AI Agency! I'll ask you some questions about
your business so I can set up your profile. Let's start with
the basics. What's your company name?
You: FreshBrew Coffee — we sell single-origin coffee beans online
Agency: What industry are you in, and who's your ideal customer?
You: D2C specialty coffee. Coffee enthusiasts 25-40 who care about
quality and sustainability.
Agency: [continues through 5 phases: basics, market, competitors, brand, goals]
The agency creates 5 files in your vault:
vault/01-Clients/FreshBrew Coffee/
├── profile.md → Full company overview
├── brand-voice.md → Tone guide with writing samples
├── competitors.md → Competitive landscape
├── icp.md → Ideal customer profile with messaging
└── goals.md → Goals, KPIs, recommended actions
You: workflow content-month
The agency executes 7 steps:
Step 1: Trend research → Searches real 2026 trends, finds 10 topics
Step 2: Content calendar → Plans 30 days across all channels
Step 3: Blog posts (4) → SEO-optimized, 1,500 words each
Step 4: Social posts (30) → Platform-specific, brand voice matched
Step 5: Newsletters (4) → Weekly emails with subject lines and CTAs
Step 6: Video scripts (2) → 3-5 min scripts with B-roll suggestions
Step 7: Repurposing plan → How to transform each piece across formats
Every deliverable is checked:
- Brand voice matches your profile
- All facts verified via web search
- No placeholder text
- Professional formatting
- Saved to vault with links
output/freshbrew-coffee/2026-04-07/content-month/
├── blogs/
│ ├── 01-what-is-single-origin-coffee.md
│ ├── 02-processing-methods-explained.md
│ ├── 03-subscription-guide.md
│ └── 04-coffee-cupping-guide.md
├── social-posts.md → 30 posts across platforms
├── newsletters/ → 4 weekly newsletters
├── video-scripts/ → 2 video scripts
└── repurposing-plan.md → Transformation instructions
You: dashboard
FreshBrew Coffee | Active
40 deliverables | 20.5 hours saved | $3,075 value generated
The agency supports multiple clients simultaneously. Each gets their own vault folder.
You: switch client NexusAI
All agents automatically load NexusAI's brand voice, competitors, ICP, and goals. Research and deliverables stay organized per client in both the vault and output folder.
vault/01-Clients/
├── FreshBrew Coffee/ → D2C coffee brand profile
├── NexusAI/ → B2B SaaS profile
└── VelvetThread/ → Sustainable fashion profile
| Requirement | Details |
|---|---|
| Claude Code | CLI, VS Code extension, or desktop app |
| Python 3.6+ | Optional -- only for helper scripts in tools/scripts/ |
| Obsidian | Optional -- for visual vault browsing |
That's it. No API keys, no packages, no environment variables, no build steps.
Contributions welcome. Here's how:
- Fork the repo
- Create a branch (
git checkout -b feature/new-workflow) - Add your agents, workflows, or templates
- Submit a pull request
Ideas for contributions:
- New agents for existing teams
- New workflow chains (e.g.,
workflow podcast-launch,workflow fundraise) - Industry-specific templates (SaaS, e-commerce, real estate, healthcare)
- Translations
- Obsidian plugins or themes for the vault
MIT License -- see LICENSE for details.
8 teams. 113+ agents. 9 workflows. 12 templates. Battle-tested.
Your agency is one git clone away.