AI agent skills for startup validation, competitive intelligence, and planning
ai-agentsbattle-cardsclaude-codeclaude-skillscompetitive-analysiscompetitive-intelligencemarket-researchpricing-analysisstartupstartup-validation
feat: add startup-competitors skill for competitive intelligence
Ferdinando Bonsegnaa6751e263568
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex 5a38288..41c6ac8 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -5,8 +5,8 @@"email": "[email protected]"},"metadata": {- "description": "AI agent skills for startup design, validation, and planning",- "version": "1.1.0"+ "description": "AI agent skills for startup design, validation, competitive intelligence, and planning",+ "version": "1.2.0"},"plugins": [{@@ -15,7 +15,8 @@"source": "./","strict": false,"skills": [- "./startup-design"+ "./startup-design",+ "./startup-competitors"]}]diff --git a/.gitignore b/.gitignoreindex a830bc5..160ca7f 100644--- a/.gitignore+++ b/.gitignore@@ -1,11 +1,17 @@# Skill workspace (test results, iterations, benchmarks)startup-design-workspace/+startup-competitors-workspace/# Marketing (private, not published)marketing/# Release assetsstartup-design.zip+startup-competitors.zip+*.skill++# Eval exports+eval_set.json# Local skills.agents/diff --git a/CLAUDE.md b/CLAUDE.mdindex 97d6ea5..82b90b6 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -4,13 +4,21 @@ Guidelines for AI agents working in this repository.## Repository Overview-This repository contains the **startup** plugin for AI agents. The plugin namespace is `startup`, and it currently includes the `startup-design` skill (`/startup:startup-design`). The skill guides comprehensive startup design and idea validation through 8 structured phases.+This repository contains the **startup** plugin for AI agents. The plugin namespace is `startup`, and it includes multiple skills organized in 3 categories: Design, Analyze, and Build.-- **Name**: Startup Design Skill+- **Name**: Startup Skills- **GitHub**: [ferdinandobons/startup-skill](https://github.com/ferdinandobons/startup-skill)- **Creator**: Ferdinando Bons- **License**: MIT+## Skill Taxonomy++| Category | Purpose | Skills |+|----------|---------|--------|+| **Design** | Full process, idea to validated plan | `startup-design` |+| **Analyze** | Deep standalone analysis of one area | `startup-competitors`, `startup-positioning` (planned) |+| **Build** | Post-validation execution tools | `startup-pitch` (planned) |+## Repository Structure```@@ -18,8 +26,8 @@ startup-skill/ # Plugin namespace (startup:*)├── .claude-plugin/│ └── marketplace.json # Plugin definition (name must be "startup")├── startup-design/ # Skill: startup:startup-design-│ ├── SKILL.md # Main skill file (~495 lines, 8 phases)-│ └── references/ # Supporting documents loaded on demand+│ ├── SKILL.md # Main skill file (~495 lines, 8 phases)+│ └── references/ # Supporting documents loaded on demand│ ├── research-principles.md│ ├── research-wave-1-market.md│ ├── research-wave-2-competitors.md@@ -27,6 +35,14 @@ startup-skill/ # Plugin namespace (startup:*)│ ├── research-wave-4-distribution.md│ ├── research-synthesis.md│ └── frameworks.md+├── startup-competitors/ # Skill: startup:startup-competitors+│ ├── SKILL.md # Main skill file (~190 lines, 3 waves)+│ └── references/+│ ├── research-principles.md+│ ├── research-wave-1-profiles-pricing.md+│ ├── research-wave-2-sentiment-mining.md+│ ├── research-wave-3-gtm-signals.md+│ └── research-synthesis.md├── CLAUDE.md├── CONTRIBUTING.md├── LICENSE@@ -38,9 +54,9 @@ startup-skill/ # Plugin namespace (startup:*)### Naming Convention- **Plugin name** (`startup`): defined in `.claude-plugin/marketplace.json` → becomes the namespace prefix-- **Skill name** (`startup-design`): defined in `SKILL.md` frontmatter → must match directory name-- **Command**: `/startup:startup-design` — `plugin-name:skill-name`-- Future skills go in the same repo as separate directories (e.g. `startup-pitch/`, `startup-growth/`)+- **Skill name** (`startup-design`, `startup-competitors`): defined in `SKILL.md` frontmatter → must match directory name+- **Command**: `/startup:startup-design`, `/startup:startup-competitors` — `plugin-name:skill-name`+- Future skills go in the same repo as separate directories (e.g. `startup-pitch/`, `startup-positioning/`)### Skill Format@@ -49,20 +65,26 @@ startup-skill/ # Plugin namespace (startup:*)- `description` must be 1-1024 characters with trigger phrases- Keep `SKILL.md` under 500 lines; move details to `references/`- References are loaded progressively (only when needed for current phase)+- Reference files use `research-wave-N-` prefix for consistency across skills### Research Architecture-Phase 3 (Market Research) uses 4 sequential waves of parallel agents:+**startup-design** Phase 3 uses 4 sequential waves of parallel agents:- Wave 1: Market Landscape (3 agents)- Wave 2: Competitive Analysis (3 agents)- Wave 3: Customer & Demand (3 agents)- Wave 4: Distribution (2 agents)-Each wave must complete before the next starts. Agents use WebSearch for real data.+**startup-competitors** uses 3 sequential waves of parallel agents:+- Wave 1: Competitor Profiles + Pricing Intelligence (2 agents)+- Wave 2: Customer Sentiment Mining (2 agents)+- Wave 3: GTM & Strategic Signals (2 agents)++Each wave must complete before the next starts. Agents use WebSearch for real data. Both skills support Claude.ai (sequential fallback) and Knowledge-Based Mode when WebSearch is unavailable.### Output Structure-The skill generates files in subdirectories:+**startup-design** generates files in subdirectories:- `00-intake/` — Brief, brainstorm- `01-discovery/` — Market research (raw + synthesized)- `02-strategy/` — Lean canvas, positioning, business model, GTM@@ -71,9 +93,21 @@ The skill generates files in subdirectories:- `05-financial/` — Revenue, costs, projections- `06-validation/` — Experiments, risks, scorecard+**startup-competitors** generates files in `{project-name}/`:+- `intake.md` — Product and market context+- `competitors-report.md` — Main deliverable with strategic analysis+- `competitive-matrix.md` — Feature comparison table+- `pricing-landscape.md` — Pricing analysis and positioning+- `battle-cards/{competitor}.md` — Per-competitor one-pagers+- `raw/` — Raw research data from each wave++### Integration Between Skills++`startup-competitors` can detect and leverage prior `startup-design` output. If files like `01-discovery/competitor-landscape.md` exist, it uses them as a starting point instead of re-interviewing.+### Testing-Eval cases are in `startup-design-workspace/evals/evals.json`. To test:+Eval cases are in `{skill}-workspace/evals/evals.json`. To test:1. Run each eval prompt through the skill2. Grade against assertions in `eval_metadata.json`3. Compare with/without skill performancediff --git a/README.md b/README.mdindex 301d60f..fd81f87 100644--- a/README.md+++ b/README.md@@ -1,24 +1,46 @@-# Startup Design Skill+# Startup Skill-An AI agent skill for comprehensive startup design and idea validation. Takes a raw idea from concept to validated business plan through structured research, strategic frameworks, and honest assessment.+AI agent skills for startup design, validation, and competitive intelligence. Built for founders, solopreneurs, and product people who want to make better decisions with real data.-Built for founders, solopreneurs, and product people who want to validate ideas rigorously before investing time and money. Works with [Claude Code](https://claude.ai/claude-code) and any agent that supports skills.+Works with [Claude Code](https://claude.ai/claude-code) and any agent that supports skills.-**Contributions welcome!** Found a way to improve the skill or have a new idea? [Open a PR](#contributing).+**Contributions welcome!** Found a way to improve a skill or have a new idea? [Open a PR](#contributing).Run into a problem or have a question? [Open an issue](https://github.com/ferdinandobons/startup-skill/issues).-## What It Does+## Skill Categories-The skill guides an AI agent through 8 structured phases, producing a complete set of markdown documents:+Skills are organized in 3 categories:```-INTAKE -> BRAINSTORM -> RESEARCH -> STRATEGY -> BRAND -> PRODUCT -> FINANCIAL -> VALIDATION+startup (plugin)+│+├── DESIGN — Full process, idea to validated plan+│ └── startup-design ✅ Complete startup design (8 phases)+│+├── ANALYZE — Deep standalone analysis of one area+│ ├── startup-competitors ✅ Competitive intelligence+│ ├── startup-positioning 🔜 Coming soon+│+└── BUILD — Post-validation, ready to execute+ └── startup-pitch 🔜 Coming soon```-Each phase builds on the previous one. Sessions can be interrupted and resumed from checkpoints.+| Category | Purpose | When to Use |+|----------|---------|-------------|+| **Design** | Complete process from idea to validated business plan | Starting from scratch, exploring a new idea |+| **Analyze** | Deep analysis of a single dimension, standalone | Already have a startup, need specific intelligence |+| **Build** | Tools for executing after validation | Idea is validated, ready to build and present |++## Skills++### startup-design (Design)++The core skill. Takes a raw idea through 8 structured phases, producing a complete set of markdown documents:-### Phases+```+INTAKE -> BRAINSTORM -> RESEARCH -> STRATEGY -> BRAND -> PRODUCT -> FINANCIAL -> VALIDATION+```| Phase | What It Produces | Key Output Files ||-------|-----------------|-----------------|@@ -31,29 +53,55 @@ Each phase builds on the previous one. Sessions can be interrupted and resumed f| 7. Financial | Revenue model, cost structure, projections | `05-financial/*.md` || 8. Validation | Experiments, risk analysis, scorecard | `06-validation/*.md` |-### Modes+**Modes:** Full Mode (all 8 phases) or Fast Track (compressed for quick go/no-go decisions).++### startup-competitors (Analyze)++Deep competitive intelligence for any market. Goes far beyond basic competitor lists — analyzes pricing strategy, customer sentiment, GTM channels, and growth signals.++```+INTAKE -> RESEARCH (3 parallel waves) -> SYNTHESIS -> BATTLE CARDS+```++| Wave | What It Researches | Key Output |+|------|-------------------|------------|+| 1. Profiles + Pricing | Competitor deep-dives, pricing reverse-engineering, switching costs | `competitor-profiles.md`, `pricing-intelligence.md` |+| 2. Sentiment Mining | Review mining (G2, Capterra), forum mining (Reddit, HN), language map | `review-mining.md`, `forum-mining.md` |+| 3. GTM & Signals | Acquisition channels, content/SEO gaps, hiring patterns, funding trajectory | `gtm-analysis.md`, `strategic-signals.md` |-- **Full Mode** (default): All 8 phases, thorough analysis-- **Fast Track**: Compressed version for quick go/no-go decisions+**Output:** Competitive report, feature matrix, pricing landscape, and per-competitor battle cards.-### Features+### startup-positioning (Analyze) — Coming Soon++Dedicated positioning strategy using April Dunford's complete framework. Not just "how to describe your product" — a deep process that maps competitive alternatives, unique attributes, value chains, and market categories.++**Output:** Positioning document + messaging framework reusable for landing pages, pitch decks, and ads.++### startup-pitch (Build) — Coming Soon++Structured pitch deck generation with narrative design, data integration, and slide-by-slide content. Supports investor pitch, customer pitch, and accelerator applications in multiple formats (5-slide lightning to 15-slide detailed).++**Output:** Complete slide content in markdown, ready for Keynote/Google Slides/Figma.++## Features- Multi-language support (auto-detects from user input, defaults to English)- Progress tracking via `PROGRESS.md` for session resumption- Multi-agent parallel web research with source quality tiers- Strategic frameworks: Lean Canvas, April Dunford Positioning, Value Proposition Canvas, RICE/MoSCoW- Honest assessment with risk analysis and validation experiments+- Works in Claude Code (parallel agents) and Claude.ai (sequential fallback)## Installation### Option 1: Claude.ai (Web App)-Use this skill directly in Claude.ai without any terminal or CLI:+Use skills directly in Claude.ai without any terminal or CLI:-1. Download the latest `startup-design.zip` from the [Releases page](https://github.com/ferdinandobons/startup-skill/releases)+1. Download the latest `.zip` from the [Releases page](https://github.com/ferdinandobons/startup-skill/releases)2. Open [claude.ai](https://claude.ai) and go to **Settings → Skills**3. Click **"Add Skill"** and upload the `.zip` file-4. Start a new conversation and describe your startup idea — the skill triggers automatically+4. Start a new conversation — skills trigger automatically### Option 2: CLI Install@@ -81,11 +129,12 @@ claude plugin install startup@startup-skill### Option 4: Clone and Copy-Clone the entire repo and copy the skill folder:+Clone the entire repo and copy the skill folders:```bashgit clone https://github.com/ferdinandobons/startup-skill.gitcp -r startup-skill/startup-design .agents/skills/+cp -r startup-skill/startup-competitors .agents/skills/```### Option 5: Git Submodule@@ -96,12 +145,10 @@ Add as a submodule for easy updates:git submodule add https://github.com/ferdinandobons/startup-skill.git .agents/startup-skill```-Then reference the skill from `.agents/startup-skill/startup-design/`.-### Option 6: Fork and Customize1. Fork this repository-2. Customize the skill for your specific needs+2. Customize the skills for your specific needs3. Clone your fork into your projects### Option 7: SkillKit (Multi-Agent)@@ -115,22 +162,31 @@ npx skillkit install ferdinandobons/startup-skill## Usage-Start a conversation with your AI agent and describe your startup idea:+### Startup Design++Start a conversation and describe your startup idea:```I have an idea for a SaaS that helps real estate agents automate their follow-up emails using AI.I've been an agent for 12 years and I know the pain. Can you help me figure out if it's worth building?```-The skill will automatically trigger and guide you through the intake interview, then proceed phase by phase.+### Competitive Analysis++Ask for competitor research on any market:++```+I'm building a project management tool for creative agencies. Who are my competitors+and where are the gaps in the market?+```-To resume a previous session:+### Resume a Session```Resume from checkpoint```-For a quick validation:+### Fast Track```I need a quick validation of this idea: [your idea]. Fast track mode.@@ -141,26 +197,34 @@ I need a quick validation of this idea: [your idea]. Fast track mode.```startup-skill/├── .claude-plugin/-│ └── marketplace.json # Plugin marketplace definition-├── startup-design/-│ ├── SKILL.md # Main skill file (8 phases)+│ └── marketplace.json # Plugin marketplace definition+├── startup-design/ # DESIGN: Full startup design process+│ ├── SKILL.md # Main skill file (8 phases)│ └── references/-│ ├── research-principles.md # Cross-cutting research rules-│ ├── research-wave-1-market.md # Market sizing agents+│ ├── research-principles.md # Cross-cutting research rules+│ ├── research-wave-1-market.md # Market sizing agents│ ├── research-wave-2-competitors.md # Competitive analysis agents-│ ├── research-wave-3-customers.md # Customer research agents+│ ├── research-wave-3-customers.md # Customer research agents│ ├── research-wave-4-distribution.md # Distribution agents-│ ├── research-synthesis.md # How to synthesize findings-│ └── frameworks.md # Strategic frameworks-├── CLAUDE.md # Agent guidelines-├── CONTRIBUTING.md # How to contribute-├── LICENSE # MIT License-└── README.md # This file+│ ├── research-synthesis.md # How to synthesize findings+│ └── frameworks.md # Strategic frameworks+├── startup-competitors/ # ANALYZE: Competitive intelligence+│ ├── SKILL.md # Main skill file (3 waves)+│ └── references/+│ ├── research-principles.md # Research rules+│ ├── research-wave-1-profiles-pricing.md # Competitor profiles + pricing+│ ├── research-wave-2-sentiment-mining.md # Review + forum mining+│ ├── research-wave-3-gtm-signals.md # GTM + strategic signals+│ └── research-synthesis.md # Synthesis + battle card templates+├── CLAUDE.md # Agent guidelines+├── CONTRIBUTING.md # How to contribute+├── LICENSE # MIT License+└── README.md # This file```## Eval Results-The skill has been tested across 5 eval scenarios comparing skill-guided output vs. baseline:+The startup-design skill has been tested across 5 eval scenarios comparing skill-guided output vs. baseline:| Metric | With Skill | Without Skill ||--------|-----------|---------------|diff --git a/startup-competitors/SKILL.md b/startup-competitors/SKILL.mdnew file mode 100644index 0000000..d9b9d76--- /dev/null+++ b/startup-competitors/SKILL.md@@ -0,0 +1,202 @@+---+name: startup-competitors+description: Deep competitive intelligence for any market. Analyzes competitors' products, pricing, customer sentiment, GTM strategy, and growth signals using real web data. Produces battle cards, pricing landscape, and feature matrix. Use when the user wants to understand their competitive landscape, analyze competitors, compare products in a market, or research who they're competing against. Triggers for "who are my competitors", "competitive analysis", "competitor research", "battle cards", "pricing comparison", "competitor pricing", "market players", "competitive intelligence", "competitive landscape", "who else is in this space", "competitive moat", or any request to profile, compare, or map competitors in a category. Works standalone — no prior startup-design session needed.+---++# Startup Competitors++Deep competitive intelligence that goes beyond surface-level profiles. Produces actionable battle cards, pricing landscape analysis, and strategic vulnerability mapping using real web data.++## How It Works++```+INTAKE → RESEARCH (3 parallel waves) → SYNTHESIS → BATTLE CARDS+```++The process is focused: understand the product, research competitors deeply across 3 dimensions, synthesize findings, and produce actionable output. Typical runtime: 15-25 minutes in Claude Code (parallel agents), 30-45 minutes in Claude.ai (sequential).++### Language++Default output language is **English**. If the user writes in another language or explicitly requests one, use that language for all outputs instead.++---++## Phase 1: Intake++Short and focused — 1-2 rounds of questions, not an extended interview. The goal is just enough context to run targeted research.++### Check for Prior startup-design Work++Before asking questions, check if a `startup-design` session has already been completed for this project. Look for these files in the working directory or subdirectories:++- `01-discovery/competitor-landscape.md` — competitor profiles and analysis+- `01-discovery/market-analysis.md` — market size, trends, regulatory+- `01-discovery/target-audience.md` — customer personas, pain points+- `00-intake/brief.md` — product description and context++If these files exist, read them and use the data as a head start:+- Extract the product description, target market, and known competitors from the brief+- Use the competitor list from `competitor-landscape.md` as the starting point for deeper analysis (startup-design profiles 5-8 competitors at surface level — this skill goes much deeper on each)+- Pull market size and trends from `market-analysis.md` to contextualize the competitive landscape+- Use customer pain points from `target-audience.md` to focus the sentiment mining on what matters most++Tell the user: "I found data from a previous startup-design session. I'll use it as a starting point and go deeper on the competitive analysis."++Skip the intake interview entirely if the startup-design files provide enough context. Go straight to research.++### What to Ask (if no prior data exists)++**Round 1 — The basics:**+- What's your product/idea? (one sentence is fine)+- What problem does it solve and for whom?+- What market/category are you in?+- Do you know any competitors already? (names, URLs)++**Round 2 — Sharpening (only if needed):**+- What geography/market are you targeting?+- What's your pricing model or range?+- What do you consider your key differentiator?++Don't over-interview. If the user gives a clear description upfront, skip straight to research. The competitive analysis itself will surface what matters.++### Output++Save to `{project-name}/intake.md` — a brief summary of the product, market, and known competitors. If built on startup-design data, note the source files used. The project name should be derived from the product/market (kebab-case, e.g., `ai-email-assistant`).++---++## Phase 2: Research++Three parallel research waves, each attacking the competitive landscape from a different angle. Together they produce a 360-degree view.++### Environment Detection++Check if the `Agent` tool is available:++- **Agent tool available (Claude Code):** Spawn all agents within each wave in parallel. This is faster.+- **Agent tool NOT available (Claude.ai, web):** Execute research sequentially, following the same templates. Same depth, just slower.++### Web Search++This skill requires WebSearch for real data. If WebSearch is unavailable or denied, fall back to **Knowledge-Based Mode**: use training data, mark all findings with **[Knowledge-Based — verify independently]**, and reduce confidence ratings by one level.++> **Reference:** Read `references/research-principles.md` before starting any wave. It defines source quality tiers, cross-referencing rules, and how to handle data gaps.++### Wave 1: Competitor Profiles + Pricing Intelligence++> **Reference:** Read `references/research-wave-1-profiles-pricing.md` for agent templates.++Two agents (or two sequential blocks):++**A1: Competitor Deep-Dives** — Identify and profile 5-8 direct competitors plus 2-3 adjacent solutions (broader platforms, manual alternatives, tools from neighboring categories that compete for the same budget). For each: product, features, team size, funding, traction signals, strengths, weaknesses. Go beyond their marketing page — check reviews, job postings, and funding data.++**A2: Pricing Intelligence** — For each competitor: reverse-engineer the pricing model. Not just "it costs $49/mo" but: what's the value metric (per seat? per usage? flat?), how do tiers differentiate, what pricing psychology do they use (anchoring, decoy, charm pricing), what's the switching cost (technical, contractual, emotional). Build a tier-by-tier comparison.++### Wave 2: Customer Sentiment Mining++> **Reference:** Read `references/research-wave-2-sentiment-mining.md` for agent templates.++Two agents (or two sequential blocks):++**B1: Review Mining** — Mine G2, Capterra, TrustRadius, Product Hunt, and App Store reviews for each competitor. Extract patterns: what do people praise? What do they complain about? What features do they request? Organize by competitor and by pain theme. Include verbatim quotes.++**B2: Forum & Community Mining** — Mine Reddit, Indie Hackers, Hacker News, Quora, and niche communities. Find: complaints about existing tools, "what do you use for X?" threads, migration stories, workaround discussions. Build a **language map** — the exact words customers use to describe their problems and desires. Identify **churn signals** — why people leave each competitor.++### Wave 3: GTM & Strategic Signals++> **Reference:** Read `references/research-wave-3-gtm-signals.md` for agent templates.++Two agents (or two sequential blocks):++**C1: Go-to-Market Analysis** — For each competitor: primary acquisition channel, sales motion (self-serve vs. sales-led), content strategy (blog frequency, topics, quality), social presence, paid advertising signals, partnership plays. Build a **channel opportunity map** showing competitor saturation vs. opportunity per channel.++**C2: Strategic & Growth Signals** — Funding trajectory (rounds, investors, timing), hiring patterns (engineering-heavy = building, sales-heavy = scaling, support-heavy = struggling), content/SEO footprint (what keywords they rank for, where the gaps are), product roadmap signals from changelogs and public statements. Identify **content pillars** each competitor owns and which topics nobody covers well.++---++## Phase 3: Synthesis++> **Reference:** Read `references/synthesis-battle-cards.md` for synthesis protocol and battle card template.++After all waves complete, synthesize raw findings into strategic deliverables. This step creates the real value — it's not reporting, it's pattern-matching across data sources.++### How to Synthesize++1. Read all raw files before writing anything+2. Connect findings across waves: pricing gaps + customer complaints + hiring signals = strategic opportunities+3. Identify contradictions between sources and explain which to trust+4. Rate confidence for each major claim (High / Medium / Low)+5. Surface strategic implications — not just facts, but what they mean+6. Aggregate all data gaps from raw files into a dedicated "Data Gaps & Research Limitations" section in the competitors-report — every analysis has blind spots, and being explicit about them prevents false confidence+7. Include adjacent solutions (broader platforms, manual alternatives, tools from neighboring categories) — customers don't just choose between direct competitors, they choose between "good enough" options from adjacent spaces++### Output Files++**`{project-name}/competitors-report.md`** — The main deliverable:+- Executive summary (5-sentence competitive landscape overview)+- Market concentration assessment (fragmented / consolidating / dominated)+- Key findings per research dimension+- Strategic opportunities (where to compete)+- Strategic risks (where to avoid)+- Competitive moat assessment (network effects, switching costs, data moat, brand, scale)+- Data gaps & research limitations (mandatory — aggregate from all raw files)+- Red flags and yellow flags++**`{project-name}/competitive-matrix.md`** — Feature comparison table:+- Features as rows, competitors as columns+- Rating: strong / adequate / weak / missing+- Highlight gaps where no competitor serves well+- Your product included (or placeholder if pre-launch)++**`{project-name}/pricing-landscape.md`** — Dedicated pricing analysis:+- Tier-by-tier comparison across all competitors+- Value metric analysis (what each charges for and why)+- Pricing psychology breakdown (anchoring, decoy, freemium strategies)+- Price positioning map (axes: price vs. feature depth)+- Pricing whitespace — where there's room to position+- Switching cost matrix (per competitor: technical, contractual, emotional)++**`{project-name}/battle-cards/{competitor-name}.md`** — One per competitor:+- One-page format: who they are, their strengths, their weaknesses+- How to win against them (specific talking points)+- When they win over you (be honest)+- Customer objections and responses+- Key vulnerability to exploit+- Churn signals (why their customers leave)++### Raw Data++Keep raw research files in `{project-name}/raw/` for reference:+- `competitor-profiles.md`+- `pricing-intelligence.md`+- `review-mining.md`+- `forum-mining.md`+- `gtm-analysis.md`+- `strategic-signals.md`++---++## Honesty Protocol++Competitive intelligence is only useful if it's honest. These rules are non-negotiable:++1. **No cheerleading.** If a competitor is objectively better at something, say so. Battle cards that ignore competitor strengths are useless in real sales conversations.+2. **Label claims.** Use **[Data]**, **[Estimate]**, **[Assumption]** tags. Never present guesses as facts.+3. **Quantify.** "$12M ARR growing 40% YoY" not "they're growing fast."+4. **Date everything.** Flag data older than 12 months.+5. **Declare gaps.** "DATA GAP: Could not find reliable data on [X]" is always better than fabrication.+6. **Surface red flags.** If the competitive landscape looks brutal, say so directly.++---++## Reference Files++Read only what you need for the current phase.++| File | When to Read | Purpose |+|------|-------------|---------|+| `research-principles.md` | Before starting Phase 2 | Source quality, cross-referencing, data gaps |+| `research-wave-1-profiles-pricing.md` | When running Wave 1 | Agent templates for profiles + pricing |+| `research-wave-2-sentiment-mining.md` | When running Wave 2 | Agent templates for review + forum mining |+| `research-wave-3-gtm-signals.md` | When running Wave 3 | Agent templates for GTM + strategic signals |+| `research-synthesis.md` | After all waves complete | How to synthesize + battle card template |diff --git a/startup-competitors/references/research-principles.md b/startup-competitors/references/research-principles.mdnew file mode 100644index 0000000..3335632--- /dev/null+++ b/startup-competitors/references/research-principles.md@@ -0,0 +1,54 @@+# Research Principles++These principles apply to ALL research agents across all waves. Every agent must follow them.++## Iterative Deep Research++Each agent performs **5-8 web searches minimum**, organized in sequential rounds that drill deeper:+- Round 1: Broad overview queries+- Round 2: Drill-down into specific findings from Round 1+- Round 3: Cross-reference and validate+- Round 4: Reality check and edge cases++Do NOT stop after a single query. The first search gives you the surface — the follow-ups give you the insight.++## Source Quality Tiers++Rank every finding by source reliability:++| Tier | Source Type | Use For |+|------|-----------|---------|+| **Tier 1** | Industry reports (Gartner, Forrester, McKinsey, IBISWorld), SEC filings, government data, G2/Capterra aggregate data | Hard numbers, market share, verified metrics |+| **Tier 2** | Reputable tech press (TechCrunch, Bloomberg, WSJ), company press releases, Crunchbase, investor presentations | Funding data, company news, expert opinions |+| **Tier 3** | Blog posts, Reddit threads, individual reviews, social media | Sentiment, customer voice, anecdotal evidence |++For competitive intelligence, Tier 3 sources are more valuable than usual — individual reviews and forum posts reveal the real customer experience that polished marketing hides. But don't use them for hard numbers.++## Cross-Referencing++Never trust a single source for important claims. For every key finding:+- Look for 2-3 independent sources+- If sources agree: note convergence and cite all+- If sources disagree: note both figures, explain the discrepancy, and state which you trust more and why++## Quantification++Vague claims are worthless. Always push for numbers:+- Bad: "They're a big player"+- Good: "$12M ARR, 2,500+ customers, Series B ($28M from Accel)"+- Bad: "Their pricing is high"+- Good: "$49/seat/mo for Pro, $99/seat/mo for Enterprise, vs. market median of $35/seat/mo"++## Dating++Always note when data was published. Flag anything older than 12 months as potentially outdated. Competitor landscapes shift fast — a funding round, pivot, or acquisition can change everything in weeks.++## Handling Research Failures++Sometimes WebSearch won't find what you need:++1. **Try alternative queries.** Rephrase, use synonyms, try different angles. At least 3 variations before declaring a gap.+2. **Use proxy data.** If you can't find a competitor's revenue, estimate from team size, funding, pricing × estimated customers. Show your math.+3. **Declare the gap explicitly.** Write: "DATA GAP: Could not find reliable data on [X]. Closest proxy: [Y]. Confidence: Low."+4. **Never fabricate.** An honest "unknown" is infinitely more valuable than a made-up number.+5. **Suggest how to fill the gap.** Point to specific reports or recommend reaching out to the competitor's customers directly.diff --git a/startup-competitors/references/research-synthesis.md b/startup-competitors/references/research-synthesis.mdnew file mode 100644index 0000000..304ef19--- /dev/null+++ b/startup-competitors/references/research-synthesis.md@@ -0,0 +1,228 @@+# Synthesis & Battle Cards++After ALL waves complete (6 agents), synthesize the raw findings into polished deliverables. This step creates the real analytical value — it connects dots across data sources to surface opportunities that individual research pieces can't reveal on their own.++## Synthesis Protocol++### Before Writing++1. Read ALL raw files in `{project-name}/raw/` before writing anything+2. Look for patterns across sources — what themes repeat?+3. Identify contradictions between sources and explain which you trust more+4. Connect the dots: pricing gaps + customer complaints + hiring signals = opportunities++### Cross-Wave Connections to Look For++These are the high-value insights that come from combining data:++- **Complaint + Pricing = Opportunity:** Customers complain about a feature AND the competitor charges a premium for it → undercut with better value+- **Hiring + Product Direction = Threat:** Competitor hiring AI engineers + recent AI mentions in changelog → they're coming for that space+- **Churn Signal + Switching Cost = Wedge:** People want to leave but data portability is hard → build easy migration as a differentiator+- **Content Gap + Search Volume = Quick Win:** Nobody ranks for a high-volume term → own it early+- **Review Pattern + Missing Feature = MVP Feature:** Multiple competitors lack something customers want → build it first+- **Funding + Team Size = Reality Check:** Well-funded competitor with 100+ engineers → don't compete on features, compete on focus++### Confidence Rating++Rate every major claim:+- **High:** Multiple Tier 1/2 sources agree, recent data+- **Medium:** Some evidence but gaps, or sources partially disagree+- **Low:** Limited data, mostly inferred, or data older than 12 months++---++## Output File: competitors-report.md++Structure:++```markdown+# Competitive Intelligence Report: {market/product}+*Generated: {date}*++## Executive Summary+{5 sentences max: market concentration, key finding, biggest opportunity, biggest risk, overall assessment}++## Market Concentration+- **Structure:** fragmented / consolidating / dominated+- **Number of active players:** {count}+- **Funding concentration:** {is money flowing in or drying up?}+- **Entry barriers:** low / medium / high — {why}++## Key Players at a Glance+| Competitor | Stage | Funding | Strength | Weakness | Threat |+|-----------|-------|---------|----------|----------|--------|+| ... | ... | ... | ... | ... | H/M/L |++## Strategic Opportunities+For each opportunity:+### Opportunity: {name}+- **What:** {description}+- **Evidence:** {data points from research}+- **Confidence:** High / Medium / Low+- **How to exploit:** {specific recommendation}++## Strategic Risks+For each risk:+### Risk: {name}+- **What:** {description}+- **Evidence:** {data points}+- **Severity:** High / Medium / Low+- **Mitigation:** {how to protect against it}++## Competitive Moat Assessment+Evaluate the market on 5 moat dimensions:+| Moat Type | Present in Market? | Who Has It | Strength |+|----------|-------------------|-----------|----------|+| Network effects | yes / no | {who} | strong / weak |+| Switching costs | yes / no | {who} | strong / weak |+| Data moat | yes / no | {who} | strong / weak |+| Brand/trust | yes / no | {who} | strong / weak |+| Economies of scale | yes / no | {who} | strong / weak |++{Paragraph explaining what this means for a new entrant}++## Data Gaps & Research Limitations+Aggregate all data gaps from raw research files into a single section. For each gap:+- What data is missing+- Why it matters for decision-making+- How to fill it (specific actions the founder can take)++This section is mandatory — every competitive analysis has blind spots. Being explicit about them builds trust and prevents false confidence.++## Red Flags+- {flag 1 — things that should worry the founder}+- {flag 2}++## Yellow Flags+- {flag 1 — things to watch}+- {flag 2}+```++---++## Output File: competitive-matrix.md++```markdown+# Competitive Feature Matrix: {market}++## Feature Comparison+| Feature | {Your Product} | {Comp 1} | {Comp 2} | {Comp 3} | {Comp 4} |+|---------|---------------|----------|----------|----------|----------|+| {feature 1} | {rating} | {rating} | ... | ... | ... |+| {feature 2} | ... | ... | ... | ... | ... |++Rating scale: Strong / Adequate / Weak / Missing / Unknown++## Gap Analysis+Features where no competitor excels (all Weak or Missing):+- {gap 1} — {opportunity implication}+- {gap 2} — {opportunity implication}++## Differentiation Opportunities+Based on the matrix, the clearest paths to differentiation:+1. {opportunity — what to build and why}+2. {opportunity}+3. {opportunity}+```++---++## Output File: pricing-landscape.md++```markdown+# Pricing Landscape: {market}++## Market Pricing Overview+- **Dominant value metric:** {what most charge for}+- **Price range:** {lowest — highest for comparable tiers}+- **Median price point:** {for standard tier}+- **Free tier prevalence:** {X of Y competitors offer free}++## Tier-by-Tier Comparison+| | {Comp 1} | {Comp 2} | {Comp 3} | {Comp 4} |+|---|----------|----------|----------|----------|+| Free tier | {what's included} | ... | ... | ... |+| Entry tier | ${price} — {limits} | ... | ... | ... |+| Mid tier | ${price} — {limits} | ... | ... | ... |+| Top tier | ${price} — {limits} | ... | ... | ... |+| Enterprise | {custom?} | ... | ... | ... |++## Value Metric Analysis+| Competitor | Value Metric | Why It Works/Doesn't | Impact on Scaling |+|-----------|-------------|---------------------|-------------------|+| ... | per seat | {analysis} | {how costs grow} |++## Pricing Psychology in Use+| Tactic | Used By | How |+|--------|---------|-----|+| Anchoring | {who} | {details} |+| Decoy tier | {who} | {details} |+| Charm pricing | {who} | {details} |+| Annual lock-in | {who} | {discount %} |++## Switching Cost Matrix+| Competitor | Technical Cost | Contractual Cost | Emotional Cost | Overall |+|-----------|---------------|-----------------|----------------|---------|+| ... | H/M/L | H/M/L | H/M/L | H/M/L |++## Pricing Whitespace+{Where there's room to position on price — underserved segments, untried models, price points nobody occupies}++## Recommendations+- **If competing on price:** {strategy}+- **If competing on value:** {strategy}+- **If competing on model:** {alternative pricing approach that no competitor uses}+```++---++## Output File: battle-cards/{competitor-name}.md++One battle card per competitor. Keep each to ONE page — these are reference tools for quick use, not deep research docs.++```markdown+# Battle Card: {Competitor Name}+*Last updated: {date}*++## At a Glance+- **What they do:** {one sentence}+- **Founded:** {year} | **Funding:** {total} | **Team:** ~{size}+- **Price:** {range} | **Model:** {value metric}+- **Best for:** {their ideal customer}++## Their Strengths (be honest)+- {strength 1 — with evidence}+- {strength 2}+- {strength 3}++## Their Weaknesses (your openings)+- {weakness 1 — with evidence from reviews/forums}+- {weakness 2}+- {weakness 3}++## How to Win Against Them+Specific talking points when a prospect is evaluating both:+- **When they say "{objection},"** respond: {counter with evidence}+- **When they say "{objection},"** respond: {counter}+- **Lead with:** {your strongest differentiator vs. this specific competitor}++## When They Win Over You+Be honest about when the competitor is the better choice:+- {scenario 1 — e.g., "Enterprise teams needing SSO and audit logs"}+- {scenario 2}++## Their Customers' Top Complaint+"{verbatim quote from review}" — {source}+This matters because: {strategic implication}++## Key Vulnerability+{The single biggest weakness you can exploit — with evidence}++## Churn Signals+Why their customers leave:+- {reason 1} — frequency: common / occasional+- {reason 2}++## Watch For+{What this competitor is likely to do next based on strategic signals}+```diff --git a/startup-competitors/references/research-wave-1-profiles-pricing.md b/startup-competitors/references/research-wave-1-profiles-pricing.mdnew file mode 100644index 0000000..0866685--- /dev/null+++ b/startup-competitors/references/research-wave-1-profiles-pricing.md@@ -0,0 +1,186 @@+# Wave A: Competitor Profiles + Pricing Intelligence++Read `research-principles.md` first.++---++## Agent A1: Competitor Deep-Dives++```+Research task: Deep analysis of direct competitors for {product description}+Context: {product summary from intake}+Known competitors: {list from intake, if any}++RESEARCH PROTOCOL — identify and profile 5-8 direct competitors:++ROUND 1 — Identify competitors (4-5 searches):+- "{problem} software/app/tool {current year}"+- "best {product category} tools {current year}"+- "{known competitor 1} vs alternatives"+- "G2 {product category} grid"+- "{product category} Product Hunt"+- "top {product category} startups"+- "{problem} solutions" OR "how do {customer type} currently handle {problem}"+ (this catches adjacent solutions — inventory tools, platforms with overlapping features, manual/offline alternatives that compete for the same budget)++ROUND 2 — Deep-dive each competitor (2-3 searches per competitor):+- Visit their website: capture positioning, features, messaging, social proof+- "{competitor name} review G2 Capterra"+- "{competitor name} crunchbase funding"+- "{competitor name} linkedin employees" (team size signals)+- "{competitor name} changelog" or "{competitor name} updates {current year}"++ROUND 3 — Competitive dynamics (2-3 searches):+- "{product category} market share"+- "{competitor 1} vs {competitor 2}" comparison articles+- "{product category} landscape {current year}"++For EACH competitor, build a complete profile:++## {Competitor Name}+- **Website:** {url}+- **Founded:** {year}+- **Headquarters:** {location}+- **Team size:** {estimate from LinkedIn/Crunchbase}+- **Funding:** {total raised, last round, lead investors}+- **Stage:** bootstrapped / seed / Series A / Series B+ / public+- **Estimated revenue:** {if available, or proxy estimate}++### Product+- **Tagline:** {their actual tagline/positioning statement}+- **Core offering:** {what they sell in one sentence}+- **Key features:** {top 5-8 features}+- **Tech stack signals:** {any public info}+- **Integrations:** {key integrations}+- **Platform:** {web / mobile / desktop / API}++### Market Position+- **Target customer:** {who they serve — be specific}+- **Positioning:** {how they describe themselves}+- **Key differentiator:** {what they claim makes them unique}+- **Social proof:** {notable customers, case studies, logos}++### Traction Signals+- **G2/Capterra:** {review count and average rating}+- **Product Hunt:** {launch date, upvotes}+- **Social media:** {follower counts, engagement level}+- **Job postings:** {number and type}+- **Web traffic signals:** {if available from Similarweb/press mentions}+- **Notable customers:** {logos or case studies}++### Strengths+- {strength 1 — based on evidence, not speculation}+- {strength 2}+- {strength 3}++### Weaknesses+- {weakness 1 — based on reviews, gaps, complaints}+- {weakness 2}+- {weakness 3}++### Threat Level: Low / Medium / High+- {why — with evidence}++---++After all profiles:++## Landscape Summary+- **Total competitors identified:** {number profiled + number found but not profiled}+- **Market concentration:** fragmented / consolidating / dominated by 1-2 players+- **Average funding level:** {across profiled competitors}+- **Common positioning themes:** {what most competitors emphasize}+- **Gaps in the market:** {what no competitor does well}++## Adjacent Solutions+Products that aren't direct competitors but compete for the same budget or solve an overlapping problem. These matter because customers often choose "good enough" adjacent tools over a dedicated solution.+- {adjacent solution 1} — what it does, how it overlaps, why someone might pick it instead+- {adjacent solution 2}+Include: broader platforms with partial feature overlap, manual/offline alternatives, tools from adjacent categories that could expand into this space.++## Data Gaps+- [What you couldn't find and why it matters]++Save to: {project-name}/raw/competitor-profiles.md+```++---++## Agent A2: Pricing Intelligence++```+Research task: Pricing reverse-engineering for competitors in {product category}+Context: {product summary from intake}+Competitors to analyze: {list from A1 if available, otherwise discover during research}++RESEARCH PROTOCOL:++ROUND 1 — Capture pricing pages (1 search per competitor):+- Visit each competitor's pricing page directly+- Screenshot or capture: tiers, prices, feature lists, CTAs+- Note: annual vs monthly pricing, currency, any free tier++ROUND 2 — Deep pricing analysis (2-3 searches):+- "{competitor name} pricing" (for third-party breakdowns)+- "{competitor name} pricing changes" (for pricing history)+- "{product category} pricing comparison {current year}"+- "{competitor name} enterprise pricing" (often hidden)++ROUND 3 — Value metric analysis (1-2 searches):+- "{product category} pricing model" (per-seat vs usage vs flat)+- "how much does {competitor name} cost" (real user discussions)++For EACH competitor, analyze:++## {Competitor Name} — Pricing Breakdown++### Pricing Model+- **Value metric:** {what they charge for — per seat / per usage / flat / hybrid}+- **Why this metric:** {how it aligns with value delivered}+- **How it scales:** {does price grow linearly with usage? Are there volume discounts?}++### Tier Structure+| | {Tier 1} | {Tier 2} | {Tier 3} | {Enterprise} |+|---|----------|----------|----------|-------------|+| Price (monthly) | | | | |+| Price (annual) | | | | |+| Annual discount | | | | |+| {Key feature 1} | | | | |+| {Key feature 2} | | | | |+| {Key feature 3} | | | | |+| {Key limit 1} | | | | |+| Target persona | | | | |++### Pricing Psychology+- **Anchoring:** {do they use a high-price tier to make mid-tier attractive?}+- **Decoy effect:** {is there a tier designed to push people to a specific plan?}+- **Charm pricing:** {$49 vs $50? $99 vs $100?}+- **Social proof on pricing:** {which tier is "most popular"?}+- **Free tier strategy:** {what's free and what's gated?}+- **Annual lock-in:** {discount size, refund policy}++### Switching Costs+- **Technical:** {data export? API migration? Integration rewiring?}+- **Contractual:** {annual contracts? Cancellation penalties?}+- **Emotional:** {brand loyalty? Learning curve for alternatives?}+- **Data portability:** {can you export your data easily?}++---++After all competitors:++## Pricing Landscape Summary+- **Dominant value metric:** {what most charge for}+- **Price range:** {lowest to highest for comparable tiers}+- **Median price point:** {for the most common tier}+- **Free tier prevalence:** {how many offer free plans}+- **Annual discount range:** {typical discounts}+- **Pricing whitespace:** {where there's room to position — underserved price points or models}+- **Switching cost patterns:** {are switching costs high or low in this market?}++## Data Gaps+- [Competitors with hidden/custom pricing]+- [Enterprise pricing that couldn't be found]++Save to: {project-name}/raw/pricing-intelligence.md+```diff --git a/startup-competitors/references/research-wave-2-sentiment-mining.md b/startup-competitors/references/research-wave-2-sentiment-mining.mdnew file mode 100644index 0000000..5ae3f5f--- /dev/null+++ b/startup-competitors/references/research-wave-2-sentiment-mining.md@@ -0,0 +1,189 @@+# Wave B: Customer Sentiment Mining++Read `research-principles.md` first.++---++## Agent B1: Review Mining++```+Research task: Mine customer reviews for competitors in {product category}+Context: {product summary from intake}+Competitors to analyze: {list from Wave A}++Review mining reveals what customers actually experience — not what competitor marketing promises. The gap between promise and reality is where opportunities live.++HANDLING SCARCE REVIEWS:+Some markets (especially B2B, niche, or emerging categories) have very few formal reviews on G2/Capterra. When this happens:+1. Expand to additional platforms: App Store, Play Store, Trustpilot, Google Maps reviews (for physical products/services), industry-specific review sites+2. Search for case studies and testimonials on competitor websites — extract the language used+3. Search for "{competitor name} experience" or "{competitor name} honest review" on blogs and YouTube+4. Lean more heavily on forum mining (Wave B2) for unfiltered opinions+5. Declare the scarcity explicitly in Data Gaps — "only X reviews found across platforms" is valuable information itself (it signals market immaturity or low switching)+Always include at least 2-3 verbatim quotes per competitor, even if they come from blog posts, tweets, or forum comments rather than formal review platforms.++RESEARCH PROTOCOL:++ROUND 1 — Aggregate review platforms (2 searches per competitor):+- "{competitor name} reviews G2"+- "{competitor name} reviews Capterra" OR "Trustradius"+- "{competitor name} reviews Product Hunt"+- "{competitor name} app store reviews" (if mobile product)++ROUND 2 — Negative review deep-dive (1-2 searches per competitor):+- "{competitor name} complaints"+- "{competitor name} problems reddit"+- "{competitor name} worst things"++ROUND 3 — Feature request patterns (1-2 searches):+- "{competitor name} feature request"+- "{competitor name} missing features"+- "{product category} wishlist"++For EACH competitor, extract:++## {Competitor Name} — Review Analysis++### Review Volume & Ratings+- **G2:** {count} reviews, {avg} stars+- **Capterra:** {count} reviews, {avg} stars+- **TrustRadius:** {count} reviews, {avg} stars+- **Product Hunt:** {upvotes}, {comment sentiment}+- **App Store / Play Store:** {if applicable}++### What People Love (top 3-5 themes)+For each theme:+- **Theme:** {e.g., "Easy onboarding"}+- **Frequency:** mentioned in ~{X}% of positive reviews+- **Verbatim quotes:**+ - "{exact quote}" — {source, date}+ - "{exact quote}" — {source, date}++### What People Hate (top 3-5 themes)+For each theme:+- **Theme:** {e.g., "Pricing feels unfair at scale"}+- **Frequency:** mentioned in ~{X}% of negative reviews+- **Severity:** annoyance / blocker / deal-breaker+- **Verbatim quotes:**+ - "{exact quote}" — {source, date}+ - "{exact quote}" — {source, date}++### Most Requested Features+- {feature 1} — mentioned {X} times+- {feature 2} — mentioned {X} times+- {feature 3} — mentioned {X} times++### Churn Signals+Reasons people leave this competitor:+- {reason 1 — with evidence}+- {reason 2 — with evidence}+- {reason 3 — with evidence}++---++After all competitors:++## Cross-Competitor Pain Patterns+| Pain Theme | {Comp 1} | {Comp 2} | {Comp 3} | {Comp 4} | Opportunity |+|-----------|----------|----------|----------|----------|-------------|+| {pain 1} | severity | severity | severity | severity | {implication} |+| {pain 2} | ... | ... | ... | ... | ... |++Pains shared across multiple competitors = structural market problems = biggest opportunities.++## Data Gaps+- [Competitors with few reviews]+- [Platforms not checked]++Save to: {project-name}/raw/review-mining.md+```++---++## Agent B2: Forum & Community Mining++```+Research task: Mine forums and communities for customer voice about {product category}+Context: {product summary from intake}+Competitors: {list from Wave A}++Forum mining captures unfiltered opinions that people won't write in formal reviews. It also reveals the exact language customers use — gold for positioning and copywriting.++RESEARCH PROTOCOL:++ROUND 1 — Reddit (3-4 searches):+- "site:reddit.com {product category} recommendations"+- "site:reddit.com {competitor name} alternative"+- "site:reddit.com {problem statement} tool"+- "site:reddit.com switching from {competitor name}"++ROUND 2 — Indie communities (2-3 searches):+- "site:indiehackers.com {product category}"+- "site:news.ycombinator.com {product category}"+- "{product category} forum discussion"++ROUND 3 — Q&A and niche (2 searches):+- "site:quora.com best {product category}"+- "{product category} community Slack Discord"++ROUND 4 — Migration stories (1-2 searches):+- "switched from {competitor name} to"+- "migrating from {competitor name}"+- "why I left {competitor name}"++OUTPUT FORMAT:++## Forum & Community Findings++### Discussion Themes+For each major theme found:+- **Theme:** {what people are discussing}+- **Volume:** {approximate number of threads/comments}+- **Sentiment:** positive / negative / mixed+- **Key threads:**+ - [{thread title}]({url}) — {key takeaway}++### Language Map+The exact words customers use — organized for reuse in positioning and copy:++**To describe the problem:**+- "{exact phrase}" — used in {X} threads+- "{exact phrase}" — used in {X} threads++**To describe desired solution:**+- "{exact phrase}"+- "{exact phrase}"++**To describe frustrations with competitors:**+- "{exact phrase}" — about {competitor}+- "{exact phrase}" — about {competitor}++**To describe switching triggers:**+- "{exact phrase}"+- "{exact phrase}"++### "What do you use for X?" Threads+| Thread | Top Recommended | Runner Up | Common Criteria |+|--------|----------------|-----------|-----------------|+| {title} | {tool} ({why}) | {tool} | {what people care about} |++### Migration Stories+For each migration story found:+- **From:** {competitor} → **To:** {competitor}+- **Why they switched:** {reason}+- **What they gained:** {benefit}+- **What they lost:** {trade-off}+- **Would they switch again?** {yes/no and why}++### Churn Signal Summary+Aggregated reasons people leave competitors:+| Reason | Competitors Affected | Frequency | Severity |+|--------|---------------------|-----------|----------|+| {reason} | {which ones} | common / occasional | high / medium |++## Data Gaps+- [Communities not found or not active for this category]+- [Competitors with no forum presence]++Save to: {project-name}/raw/forum-mining.md+```diff --git a/startup-competitors/references/research-wave-3-gtm-signals.md b/startup-competitors/references/research-wave-3-gtm-signals.mdnew file mode 100644index 0000000..a27c2a2--- /dev/null+++ b/startup-competitors/references/research-wave-3-gtm-signals.md@@ -0,0 +1,192 @@+# Wave C: GTM & Strategic Signals++Read `research-principles.md` first.++---++## Agent C1: Go-to-Market Analysis++```+Research task: How competitors in {product category} acquire and retain customers+Context: {product summary from intake}+Competitors: {list from Wave A}++Understanding how competitors grow reveals where the market attention flows — and where there are underexploited channels.++RESEARCH PROTOCOL:++ROUND 1 — Marketing presence (2-3 searches per top competitor):+- Check competitor websites: blog, resources, webinars, case studies+- "{competitor name} marketing strategy"+- "{competitor name} blog" (assess frequency, topics, quality)++ROUND 2 — Advertising signals (2-3 searches):+- "{competitor name} ads" OR check Google Ads transparency center+- "{competitor name} Facebook Ad Library"+- "{product category} sponsored content"++ROUND 3 — Sales motion (2 searches):+- "{competitor name} sales team linkedin"+- Analyze each competitor's CTA: self-serve signup vs demo vs contact sales++ROUND 4 — Partnerships and community (1-2 searches):+- "{competitor name} integrations"+- "{competitor name} partner program"+- "{competitor name} community" OR "{competitor name} forum"++For EACH competitor:++## {Competitor Name} — GTM Breakdown++### Acquisition Model+- **Primary channel:** {SEO / paid ads / outbound sales / partnerships / community / PLG}+- **Secondary channel:** {if identifiable}+- **Sales motion:** {self-serve / sales-assisted / enterprise sales}+- **Signup friction:** {free trial / freemium / demo required / contact sales}++### Content & SEO+- **Blog frequency:** {posts per month, estimated}+- **Content quality:** {surface-level / solid / exceptional}+- **Content topics:** {what they write about}+- **SEO strength:** {do they rank for category terms?}+- **Resource library:** {ebooks, webinars, templates — what kind?}++### Social & Community+- **LinkedIn:** {followers, posting frequency, engagement}+- **Twitter/X:** {followers, posting frequency, engagement}+- **Other platforms:** {YouTube, TikTok, Instagram — if relevant}+- **Community:** {own community? Active? Size?}++### Paid Advertising+- **Google Ads:** {visible? what keywords?}+- **Social ads:** {Facebook, LinkedIn, Twitter — visible?}+- **Messaging in ads:** {what do they emphasize?}++### Partnerships+- **Integration partners:** {key integrations}+- **Channel partners:** {resellers, agencies}+- **Co-marketing:** {joint content, events}++---++After all competitors:++## Channel Opportunity Map+| Channel | Competitor Saturation | Opportunity Level | Est. Effort | Notes |+|---------|----------------------|-------------------|-------------|-------|+| SEO/Content | High / Medium / Low | High / Medium / Low | {S/M/L} | {why} |+| Paid Search | ... | ... | ... | ... |+| Social/Community | ... | ... | ... | ... |+| Outbound Sales | ... | ... | ... | ... |+| Partnerships | ... | ... | ... | ... |+| Product-Led Growth | ... | ... | ... | ... |++## Key Takeaways+- What's working for competitors (proven channels)+- What channels are underexploited (opportunity)+- Where to win with limited budget (quick wins)++## Data Gaps+- [Competitors with no visible marketing]+- [Channels you couldn't assess]++Save to: {project-name}/raw/gtm-analysis.md+```++---++## Agent C2: Strategic & Growth Signals++```+Research task: Strategic signals and growth trajectory for competitors in {product category}+Context: {product summary from intake}+Competitors: {list from Wave A}++Hiring patterns, funding trajectory, and content investments reveal where competitors are heading — not just where they are today.++RESEARCH PROTOCOL:++ROUND 1 — Funding trajectory (1-2 searches per competitor):+- "{competitor name} crunchbase"+- "{competitor name} funding {current year}"+- "{competitor name} acquisition" OR "{competitor name} acquired"++ROUND 2 — Hiring signals (1-2 searches per competitor):+- "{competitor name} careers" OR "{competitor name} jobs"+- "{competitor name} hiring linkedin"+- Note: engineering-heavy = building new features; sales-heavy = scaling; support-heavy = struggling with growth++ROUND 3 — Content & SEO footprint (2-3 searches):+- "site:{competitor domain} blog" (content volume)+- "{product category} {key topic}" (who ranks for important terms?)+- "{product category} comparison" OR "{product category} vs" (who owns comparison content?)++ROUND 4 — Product direction signals (1-2 searches):+- "{competitor name} changelog"+- "{competitor name} roadmap"+- "{competitor name} new features {current year}"+- "{competitor name} AI" (if relevant to the category)++For EACH competitor:++## {Competitor Name} — Strategic Signals++### Funding Trajectory+- **Total raised:** {amount}+- **Last round:** {type, amount, date, lead investor}+- **Funding velocity:** {time between rounds}+- **Signal:** {growing fast / steady / slowing / bootstrapped by choice}+- **Potential exit signals:** {acquisition rumors, IPO filings}++### Hiring Patterns+- **Total job openings:** {count}+- **Engineering roles:** {count} — signal: {building new product / scaling infra / maintaining}+- **Sales/Marketing roles:** {count} — signal: {scaling acquisition / entering new market}+- **Support/CS roles:** {count} — signal: {growing customer base / high churn needing management}+- **Key hires:** {notable recent senior hires and what they signal}+- **Location signals:** {hiring in new markets?}++### SEO & Content Footprint+- **Keywords they rank for:** {top category terms}+- **Content pillars:** {what topics they own}+- **Content gaps:** {category topics they don't cover}+- **Blog authority:** {estimated domain authority / content maturity}++### Product Direction+- **Recent major features:** {what they shipped in last 6 months}+- **Roadmap signals:** {where they're heading based on public info}+- **Tech bets:** {AI, mobile, API, integrations — what are they investing in?}+- **Platform plays:** {trying to become a platform? Building ecosystem?}++---++After all competitors:++## Strategic Landscape Summary++### Where the Market Is Heading+- {trend 1 based on collective competitor signals}+- {trend 2}+- {trend 3}++### Competitor Trajectory Map+| Competitor | Stage | Trajectory | Investing In | Biggest Risk |+|-----------|-------|-----------|-------------|-------------|+| {name} | {stage} | growing / stable / declining | {area} | {risk} |++### Content/SEO Gap Analysis+| Topic/Keyword | {Comp 1} | {Comp 2} | {Comp 3} | Opportunity |+|--------------|----------|----------|----------|-------------|+| {keyword} | ranks / absent | ... | ... | {who could win this} |++### Underexploited Content Pillars+Topics that matter to the market but no competitor covers well:+- {topic 1} — why it matters, why it's uncovered+- {topic 2}++## Data Gaps+- [Competitors with no public hiring data]+- [Private companies with no funding info]++Save to: {project-name}/raw/strategic-signals.md+```diff --git a/todo.md b/todo.mdnew file mode 100644index 0000000..4d85f04--- /dev/null+++ b/todo.md@@ -0,0 +1,66 @@+# Startup Plugin — Skill Roadmap++## Taxonomy++Skills in the `startup` plugin are organized in 3 categories:++| Category | Description | Purpose |+|----------|-------------|---------|+| **Design** | Full process from idea to validated plan | The core engine |+| **Analyze** | Deep analysis of a single dimension | Standalone tools, usable without startup-design |+| **Build** | Tools for executing after validation | Post-design, the idea passed and the founder wants to move forward |++## Skill Map++```+startup (plugin)+│+├── DESIGN+│ └── startup-design ✅ v1.1.0 — full startup design (8 phases)+│+├── ANALYZE+│ ├── startup-competitors ✅ created — deep competitive intelligence+│ └── startup-positioning ⬜ to do — positioning strategy (full April Dunford process)+│+└── BUILD+ └── startup-pitch ⬜ to do — structured pitch deck+```++## Skills to Create++### startup-positioning (ANALYZE)++**What it does:** Dedicated positioning process using April Dunford's complete framework. startup-design uses positioning in a single page as part of the Strategy phase. This skill goes much deeper.++**Why it's valuable standalone:** Positioning is the #1 problem for early-stage startups. Many founders already have a product but don't know how to position it. They don't need 8 phases — they need to understand *who they are, who they're for, and why they're different*.++**What it covers (that startup-design doesn't):**+- Deep interview about product, customers, and competitors+- Competitive alternatives analysis (not just "who are the competitors" but "what happens if you don't exist")+- Unique attributes mapping with evidence+- Value chain: attributes → benefits → customer value+- Target market segmentation with prioritization+- Market category selection (or creation of a new category)+- Positioning statement + messaging framework+- Positioning testing with real scenarios++**Output:** A complete positioning document + reusable messaging framework for landing pages, pitch decks, and ads.++---++### startup-pitch (BUILD)++**What it does:** Generates a structured pitch deck with narrative, data, and slide-by-slide content. Can use data from startup-design if available, or start from scratch.++**Why it's valuable post-design:** After an idea is validated with startup-design, the founder needs to present it — to investors, co-founders, early customers, accelerators. The pitch deck is the most requested deliverable.++**What it covers:**+- Pitch narrative design (problem → solution → traction → ask)+- Slide-by-slide content (title, body, data, speaker notes)+- Support for different formats: investor pitch, customer pitch, accelerator application+- Length adaptation: 5-slide lightning, 10-slide standard, 15-slide detailed+- Data and numbers pulled from research (if startup-design was executed)+- Appendix slides for deep-dives+- Oral presentation script++**Output:** Complete content for every slide in markdown, ready to be transferred to Keynote/Google Slides/Figma.