Skip to content

Latest commit

 

History

History
371 lines (313 loc) · 19.5 KB

File metadata and controls

371 lines (313 loc) · 19.5 KB
╔══════════════════════════════════════════════════════════════════════╗
║                                                                      ║
║    ██╗ ██████╗ ██╗  ██╗    ██╗   ██╗██╗██████╗ ███████╗             ║
║   ███║██╔═████╗╚██╗██╔╝    ██║   ██║██║██╔══██╗██╔════╝            ║
║   ╚██║██║██╔██║ ╚███╔╝     ██║   ██║██║██████╔╝█████╗              ║
║    ██║████╔╝██║ ██╔██╗     ╚██╗ ██╔╝██║██╔══██╗██╔══╝              ║
║    ██║╚██████╔╝██╔╝ ██╗     ╚████╔╝ ██║██████╔╝███████╗            ║
║    ╚═╝ ╚═════╝ ╚═╝  ╚═╝      ╚═══╝  ╚═╝╚═════╝ ╚══════╝           ║
║                                                                      ║
║              M A R K E T E R                                         ║
║                                                                      ║
║    Your Autonomous Marketing Agency — Powered by Agent Swarms        ║
║                                                                      ║
║    Developed by 10x.in                                               ║
║                                                                      ║
╚══════════════════════════════════════════════════════════════════════╝

10X Vibe Marketer — Full-Featured Skills Plugin v2.1

An autonomous marketing agency powered by Claude Code agent swarms. Works with ANY model — from Claude Haiku to Opus, GPT-4o Mini to GPT-4, Qwen Coder to Qwen 72B. Give it a marketing task, and it dynamically assembles the right team of specialists to deliver results.

First-Time Setup

Run /setup to auto-install all local dependencies (TLDraw SDK, output directories, tracking system).

How It Works

  1. You describe what you need — "Create a content strategy for my SaaS product" or just use a slash command
  2. The 10x CMO analyzes your request — classifies it, identifies the right department
  3. CMO lists assumptions and asks clarifying questions — multiple-choice, never open-ended
  4. Specialist agents spawn with explicit step-by-step instructions — any model can execute
  5. Agents follow numbered steps: gather data, create deliverable, save to output/, report back
  6. Quality Judge evaluates everything before delivery (score 0-100)
  7. Deliverables land in output/ — reports, content, strategies, visuals, tracking data

Assumption Register (Built-In)

Every agent documents assumptions BEFORE acting:

# Assumption Why It Matters Status
1 [what is assumed] [impact if wrong] CONFIRMED / UNCONFIRMED / FROM PROMPT

This prevents silent failures, wrong decisions, and costly corrections. If an assumption is unconfirmed, the agent notes it as a caveat — never guesses silently.

Model Compatibility

All skills use explicit step-by-step instructions that work across model sizes:

Model Tier Examples Capability
Large (full features) Claude Opus, GPT-4, Sonnet 4.5+ Multi-agent orchestration, complex campaigns
Medium (most features) Claude Sonnet, GPT-4o, Qwen 72B Single-department tasks, 2-3 agent coordination
Small (basic features) Claude Haiku, GPT-4o Mini, Qwen Coder Worker execution, content creation, research

See .claude/skills/10x-orchestrator/references/model-compatibility.md for full details.

27 Slash Commands

Campaigns & Workflows

Command Description
/campaign Launch structured campaign templates
/strategy Marketing strategy and planning
/audit Run marketing audits (SEO, content, competitor, full)

Department Specialists

Command Description
/seo SEO audits, keywords, on-page optimization
/content Content creation and strategy
/copy Copywriting — headlines, CTAs, landing pages
/social Social media management and posts
/email Email marketing and sequences
/ads Paid advertising — Google/Meta/LinkedIn
/brand Branding and creative direction
/funnel Funnel optimization and CRO
/outreach PR, outreach, link building
/research Market research and analysis
/community Community management

Platform Research

Command Description
/deep-research Multi-platform real-time research (deploys up to 13 platform agents)
/scrape Web scraping — download website assets for analysis
/analyze Content and website analysis with AI
/image-gen Generate marketing images with Gemini AI

Visuals & Tracking

Command Description
/report Generate visual reports
/visualize Create TLDraw canvas visuals
/track View activity tracking and metrics
/status Quick status check

Utilities

Command Description
/setup First-time setup and configuration
/mega Access Mega cloud resources
/help-10x Full documentation and guide
/db Database operations, queries, and management
/schema Review agent schema change proposals

Or just describe what you need in plain English — no commands required.

42 Specialist Agents

26 Marketing Department Agents

Each agent has a unique visual identity in the CLI for easy recognition:

CLI Department Agent Specialty
🔍 SEO seo-specialist Keyword research, technical SEO, audits, on/off-page
✍️ Copywriting copywriter Headlines, body copy, CTAs, landing pages, ad copy
📋 Content Strategy content-strategist Content calendars, pillar/cluster, editorial planning
📱 Social Media social-media-manager Platform strategy, post creation, engagement
📧 Email Marketing email-marketer Sequences, newsletters, segmentation, A/B testing
📢 Outreach & PR outreach-pr-specialist Link building, media pitches, influencer outreach
📊 Research & Analytics research-analyst Market research, competitor analysis, data insights + Research Lead
🎯 Strategy & Planning strategy-planner Campaign strategy, positioning, goal-setting
💰 Paid Ads / PPC paid-ads-specialist Google Ads, Meta Ads, budget planning
🎨 Branding & Creative brand-creative-director Brand voice, visual identity, messaging
🔄 Funnel & CRO funnel-cro-specialist Conversion optimization, landing pages, A/B tests
👥 Community community-manager Community strategy, engagement, moderation
⚖️ Quality Assurance quality-judge Evaluation loop, scoring, quality gate
🤖 GEO/AEO geo-specialist AI search optimization, Perplexity, AI Overviews
🕵️ Competitive Intel competitive-intel-analyst Ad library intel, competitor website/ad spying
⚙️ Automation marketing-automation-specialist Workflows, behavioral triggers, drip sequences
💼 CRM crm-specialist Pipeline strategy, customer data, HubSpot/Salesforce
🧩 MarTech martech-architect Tech stack selection, integration, platform audits
🚨 Crisis Comms crisis-comms-specialist Reputation management, PR crisis response
✏️ Editorial content-editor Proofreading, style guide enforcement, editorial QA
🎙️ Podcast podcast-specialist Episode planning, show notes, interview prep
🎬 Video video-marketing-specialist Video strategy, YouTube, Reels, Shorts
🤝 Affiliate affiliate-specialist Affiliate programs, referral strategy, partnerships
🔬 Competitive Analysis competitive-analyst SWOT, benchmarking, market positioning
📈 Trends trend-forecaster Trend prediction, virality forecasting, emerging topics
📉 Data/Analytics data-analyst KPI dashboards, GA4, campaign analytics, attribution

3 Meta/Utility Agents

Internal optimization agents (not routed through orchestrator — invoked directly):

CLI Function Agent Purpose
🧠 Context Optimization context-optimizer Token efficiency, prompt compression, memory management
📚 Knowledge Synthesis knowledge-synthesizer Multi-source intelligence consolidation, conflict resolution
🔧 Prompt Optimization prompt-optimizer Agent prompt refinement, output quality improvement

13 Platform Research Agents

Real-time platform research using Claude in Chrome + WebSearch/WebFetch:

CLI Platform Agent Data Types
🔗 LinkedIn platform-linkedin B2B trends, professional content, company insights
🐦 Twitter/X platform-twitter Real-time trends, public sentiment, hashtags
🟠 Reddit platform-reddit Community discussions, unfiltered opinions
📸 Instagram platform-instagram Visual trends, influencer content, hashtags
👤 Facebook platform-facebook Community groups, ad library, demographic insights
💲 Google Ads platform-google-ads Competitor ad intelligence, ad copy trends
🔎 Google Keywords platform-google-keywords Search trends, keyword opportunities, SERP data
▶️ YouTube platform-youtube Video trends, creator strategies, audience interests
📌 Pinterest platform-pinterest Visual trends, product inspiration, seasonal content
🎵 TikTok platform-tiktok Viral content trends, Gen Z culture, sounds
Quora platform-quora Q&A trends, pain points, knowledge gaps
📝 Medium platform-medium Thought leadership, content formats, publications
🚀 Product Hunt platform-producthunt Product launches, tech trends, startup ecosystem

8 Campaign Templates

  • Full Launch — Complete product/service launch across all channels
  • SEO Audit — Technical + content + competitor SEO analysis
  • Content Calendar — Monthly editorial calendar with content briefs
  • Competitor Analysis — Deep-dive competitor research
  • Email Sequence — Multi-step nurture/sales email sequence
  • Social Media Blitz — Multi-platform social campaign
  • Brand Refresh — Brand identity and messaging overhaul
  • Funnel Optimization — Conversion funnel audit + fixes

Output Structure

output/
├── campaigns/          # Full campaign packages
├── content/            # Blog posts, copy, emails, social posts
│   ├── blog-posts/
│   ├── email-sequences/
│   ├── social-media/
│   ├── ad-copy/
│   └── landing-pages/
├── reports/            # Structured markdown/JSON reports
│   ├── seo-audits/
│   ├── competitor-analysis/
│   └── analytics/
├── research/           # Platform research outputs
│   ├── linkedin/       # LinkedIn research
│   ├── twitter/        # Twitter/X research
│   ├── reddit/         # Reddit research
│   ├── instagram/      # Instagram research
│   ├── facebook/       # Facebook research
│   ├── google-ads/     # Google Ads research
│   ├── google-keywords/# Google Keywords research
│   ├── youtube/        # YouTube research
│   ├── pinterest/      # Pinterest research
│   ├── tiktok/         # TikTok research
│   ├── quora/          # Quora research
│   ├── medium/         # Medium research
│   ├── producthunt/    # Product Hunt research
│   ├── consolidated/   # Cross-platform consolidated reports
│   └── scraped/        # Web scraper downloaded assets
├── images/             # AI-generated marketing images
│   └── generated/      # Gemini AI image outputs
├── strategies/         # Strategy documents and plans
├── visuals/            # TLDraw canvas exports (SVG/PNG)
│   ├── strategy-maps/
│   ├── funnel-diagrams/
│   ├── campaign-flows/
│   └── canvas/
├── tracking/           # Activity tracking and performance data
│   ├── activity-log.md
│   ├── performance/
│   ├── learnings/
│   └── metrics/
├── briefs/             # Content briefs
├── logs/               # System logs
knowledge/              # JSONL knowledge base (persistent intelligence)
├── strategies.jsonl
├── plans.jsonl
├── learnings.jsonl
├── prompts.jsonl
├── errors.jsonl
└── templates.jsonl
db/
├── init/               # Schema DDL and seed functions
├── import/             # Data import scripts (Python)
├── helpers/            # Cross-platform query helpers
└── migrations/         # Schema migrations (001-schema, 002-research-tables)
scripts/research/       # Python research tools
├── web_scraper.py      # Website asset scraper
├── image_generator.py  # Gemini AI image generation
├── knowledge_base.py   # JSONL knowledge base manager
└── config.py           # Research configuration

Tech Stack

  • Database: DoltgreSQL (versioned PostgreSQL — Git for data) with PostgreSQL MCP access
  • Runtime: Claude Code Skills Plugin v2.2 + OpenCode compatibility
  • Orchestration: Dynamic agent swarm with Task system (42 agents)
  • Platform Research: 13 platform-specific agents + Claude in Chrome for authenticated browsing + WebSearch/WebFetch fallback
  • Image Generation: Gemini AI (Imagen 4 + gemini-2.0-flash-exp) — 10 styles, 11 platform dimensions
  • Knowledge Base: JSONL-based persistent intelligence across sessions (6 categories)
  • Web Scraping: Python BeautifulSoup scraper for website asset download
  • Visualization: TLDraw SDK (local install) for canvas whiteboard + Mermaid fallback
  • Tracking: Built-in activity tracking — what works, what doesn't
  • Quality: Evaluation loop with Quality Judge (0-100 confidence scoring)
  • Platform: Cross-platform (Windows, macOS, Linux) — auto-detects OS
  • Agent Teams: Experimental multi-agent mode on Mac/Linux (cowork support)
  • Cloud: Mega CLI for cloud resource access
  • MCP Integration: Universal — ANY MCP server auto-discovered from .mcp.json (databases, CMS, analytics, social, email, CRM, design, AI, custom APIs)
  • Invocation: Natural language OR 27 slash commands
  • Tools: ALL Claude Code tools enabled — no restrictions
  • Dependencies: Local node_modules/ via package.json + Python scripts/research/requirements.txt
  • Frameworks: 8 comprehensive marketing framework references (copywriting, ads, email, funnels, SEO, social, brand, campaigns)
  • Templates: 12+ output templates for consistent deliverable formatting
  • No-Setup Mode: All features work without /setup — files + JSONL always, DB optional

Decision Flow

The CMO decides first, then confirms with you:

  1. CMO analyzes your request internally
  2. CMO presents its recommended approach as multiple-choice options
  3. You select your preference (one click)
  4. CMO deploys the swarm accordingly
  5. All questions use structured multiple-choice (never open-ended text)

Quality Assurance

Every output passes through a Quality Judge evaluation loop:

  1. Department agent creates the deliverable
  2. Quality Judge evaluates with rubric (accuracy, completeness, actionability, relevance, quality, 10x factor)
  3. Score >= 75: Approved and delivered
  4. Score < 75: Sent back for revision (max 2 rounds)
  5. Results logged to tracking system for continuous improvement

Activity Tracking

The system learns from every campaign:

  • What worksoutput/tracking/learnings/what-works.md
  • What doesn'toutput/tracking/learnings/what-doesnt.md
  • Channel performanceoutput/tracking/performance/channels.md
  • Content performanceoutput/tracking/performance/content-types.md
  • Strategy effectivenessoutput/tracking/performance/strategies.md

Agents read tracking data before starting new work to build on proven strategies.

Architecture

User Request
     │
     ▼
┌──────────────────┐
│  10x CMO         │  ← Analyzes, decides, presents options
│  (Orchestrator)  │
└────────┬─────────┘
         │
    ┌────┴────┬────────┬────────┬────────┐
    ▼         ▼        ▼        ▼        ▼
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│ SEO  │ │ Copy │ │Strat │ │Rsrch │ │ ...  │  ← 13 Dept Agents
│Agent │ │Agent │ │Agent │ │Lead  │ │      │
└──┬───┘ └──┬───┘ └──┬───┘ └──┬───┘ └──┬───┘
   │        │        │        │        │
   │        │        │   ┌────┴────┐   │
   │        │        │   ▼  ...   ▼   │
   │        │        │ ┌────┐ ┌────┐  │     ← 13 Platform Agents
   │        │        │ │ LI │ │ TW │  │       (LinkedIn, Twitter,
   │        │        │ │ RD │ │ IG │  │        Reddit, Instagram,
   │        │        │ │ YT │ │ TK │  │        YouTube, TikTok...)
   │        │        │ └────┘ └────┘  │
   └────────┴────────┴────────┴───────┘
                     │
                     ▼
            ┌──────────────┐
            │ Quality Judge │  ← Score 0-100
            └──────┬───────┘
                   │
                   ▼
      output/ + tracking/ + knowledge/

OpenCode Compatibility

This project is dual-compatible with both Claude Code and OpenCode (opencode.ai).

Platform Directory Config
Claude Code .claude/ (agents, commands, skills) CLAUDE.md
OpenCode .opencode/ (auto-generated) opencode.json + CLAUDE.md

Setup for OpenCode

npm run sync:opencode

This generates .opencode/agents/, .opencode/commands/, and .opencode/skills/ from the .claude/ source files. All 26 agents, 27 commands, and skills are synced with proper OpenCode YAML frontmatter (model IDs, tool permissions, agent modes).

Maintenance

.claude/ is the single source of truth. After editing any agent, command, or skill file in .claude/, run npm run sync:opencode to regenerate the .opencode/ directory.

Model Mapping

Claude Code OpenCode
sonnet anthropic/claude-sonnet-4-5-20250929
opus anthropic/claude-opus-4-6
haiku anthropic/claude-haiku-4-5-20251001

Developed by 10x.in