router-startup

name	router-startup
description	Master orchestration for routing startup problems through 60+ skills for comprehensive analysis and validation
version	1.2

Router: Startup

Master orchestrator that routes startup problems, ideas, and opportunities through the complete skill set for comprehensive analysis.

Cross-Router Architecture: This router handles business/startup concerns. For technical implementation, hand off to router-engineering. For QA/DevOps/testing, hand off to router-operations.

---

Decision Tree: Where to Start?

USER INPUT
    │
    ├─► "I have an idea" ───────────────► startup-idea-validation
    │                                      └─► 9-dimension scoring
    │
    ├─► "Find opportunities in X" ──────► startup-review-mining
    │                                      └─► Pain extraction from reviews
    │
    ├─► "What's trending in X" ─────────► startup-trend-prediction
    │                                      └─► 2-3yr lookback → 1-2yr forward
    │
    ├─► "Analyze competitors" ──────────► startup-competitive-analysis
    │                                      └─► Positioning, moats, battlecards
    │
    ├─► "Pricing / business model" ─────► startup-business-models
    │                                      └─► Unit economics, pricing tiers
    │
    ├─► "Build X feature/product" ──────► router-engineering (HANDOFF)
    │                                      └─► Architecture → Implementation
    │
    ├─► "Go to market with X" ──────────► startup-go-to-market
    │                                      └─► Positioning → Channels → Launch
    │
    ├─► "Raise funding" ────────────────► startup-fundraising
    │                                      └─► Pitch, valuation, term sheets
    │
    ├─► "Scale agent fleet" ────────────► agent-fleet-operations
    │                                      └─► Orchestration, monitoring, costs
    │
    ├─► "UX research / user feedback" ──► software-ux-research
    │                                      └─► Pain patterns, feedback mining
    │
    ├─► "UI design / design system" ────► software-ui-ux-design
    │                                      └─► Components, accessibility, patterns
    │
    │   ═══════════════════════════════════════════════════════════
    │   MARKETING & CONTENT (NEW - Explicit Routing)
    │   ═══════════════════════════════════════════════════════════
    │
    ├─► "Social media strategy" ────────► marketing-social-media
    │                                      └─► Content, paid social, LinkedIn
    │
    ├─► "Lead generation" ──────────────► marketing-leads-generation
    │                                      └─► ICP, outbound, landing pages
    │
    ├─► "SEO / organic traffic" ────────► marketing-seo-technical
    │                                      └─► Core Web Vitals, crawlability
    │
    ├─► "AI search optimization" ───────► marketing-ai-search-optimization
    │                                      └─► ChatGPT, Perplexity, Claude SEO
    │
    │   ═══════════════════════════════════════════════════════════
    │   DOCUMENTS & PRESENTATIONS (NEW - Explicit Routing)
    │   ═══════════════════════════════════════════════════════════
    │
    ├─► "Create pitch deck" ────────────► document-pptx
    │                                      └─► PowerPoint, slides, charts
    │
    ├─► "Create investor memo" ─────────► document-docx
    │                                      └─► Word docs, formatting
    │
    ├─► "Financial model / spreadsheet" ► document-xlsx
    │                                      └─► Excel, formulas, charts
    │
    ├─► "Create PDF report" ────────────► document-pdf
    │                                      └─► PDF generation, manipulation
    │
    │   ═══════════════════════════════════════════════════════════
    │   CROSS-ROUTER HANDOFFS
    │   ═══════════════════════════════════════════════════════════
    │
    ├─► "Build / implement / code" ─────► router-engineering
    │                                      └─► All technical skills
    │
    ├─► "Test / deploy / monitor" ──────► router-operations
    │                                      └─► QA, DevOps, observability
    │
    └─► "Full analysis of X" ───────────► COMPREHENSIVE ANALYSIS
                                           └─► All relevant skills in parallel

---

Stage Detection

Stage 1: OPPORTUNITY DISCOVERY

Triggers: "opportunity", "gap", "problem", "pain point", "market", "whitespace"

Primary Skills:

• startup-review-mining - Extract pain from reviews
• startup-trend-prediction - Identify rising trends
• software-ux-research - User research methods

Skill Chain:

Review Mining --> Pain Points --> Trend Alignment --> Opportunity Score

Stage 2: IDEA VALIDATION

Triggers: "idea", "validate", "test", "hypothesis", "should I build"

Primary Skills:

• startup-idea-validation - 9-dimension scoring
• product-management - Discovery, OST, customer interviews

Skill Chain:

Hypothesis Canvas --> RAT Testing --> Scorecard --> Go/No-Go

Stage 3: MARKET & COMPETITIVE ANALYSIS

Triggers: "market size", "competitors", "TAM", "landscape", "industry", "positioning"

Primary Skills:

• startup-competitive-analysis - Competitive intelligence, positioning
• startup-idea-validation - Market sizing worksheet
• startup-trend-prediction - Market cycle patterns

Skill Chain:

Market Sizing --> Competitive Analysis --> Positioning --> Battlecards

Stage 4: BUSINESS MODEL & PRICING

Triggers: "pricing", "monetization", "revenue model", "unit economics", "business model"

Primary Skills:

• startup-business-models - Revenue models, unit economics
• startup-competitive-analysis - Competitive pricing analysis

Skill Chain:

Revenue Model Selection --> Unit Economics --> Pricing Strategy --> Tier Design

Stage 5: TECHNICAL PLANNING

Triggers: "build", "architecture", "implement", "technical", "stack"

Primary Skills:

• software-architecture - System design
• software-backend-* - Backend frameworks
• software-frontend-* - Frontend frameworks
• ai-* skills - AI/ML components

Skill Chain:

Requirements --> Architecture --> Technology Selection --> Implementation Plan

Stage 6: UX & DESIGN

Triggers: "UX", "user experience", "design", "UI", "interface", "usability", "accessibility"

Primary Skills:

• software-ux-research - User research, pain pattern extraction
• software-ui-ux-design - Design systems, components, accessibility

Skill Chain:

User Research --> Pain Patterns --> Design System --> Components --> Testing

Stage 7: GO-TO-MARKET

Triggers: "launch", "GTM", "marketing", "sales", "growth", "channels"

Primary Skills:

• startup-go-to-market - GTM strategy, channels, launch planning
• product-management - Positioning, roadmap
• marketing-* skills - Channels, content

Skill Chain:

ICP Definition --> Positioning --> Channel Strategy --> Launch Plan --> Growth Loops

Stage 8: FUNDRAISING

Triggers: "funding", "raise", "investors", "pitch", "term sheet", "valuation"

Primary Skills:

• startup-fundraising - Pitch prep, valuation, term sheets
• startup-business-models - Unit economics for investors

Skill Chain:

Stage Assessment --> Materials Prep --> Investor Targeting --> Pitch --> Negotiation

Stage 9: AGENT OPERATIONS

Triggers: "agent fleet", "multi-agent", "agent service", "orchestration", "agent costs"

Primary Skills:

• agent-fleet-operations - Fleet management, economics
• ai-agents - Agent architecture

Skill Chain:

Service Design --> Agent Config --> Orchestration --> Monitoring --> Cost Optimization

Stage 10: MARKETING & GROWTH

Triggers: "marketing", "social media", "LinkedIn", "SEO", "leads", "acquisition", "content", "AI search"

Primary Skills:

Skill	When to Use
marketing-social-media	Social strategy, content calendar, paid social, LinkedIn
marketing-leads-generation	ICP definition, outbound cadences, landing pages, lead scoring
marketing-seo-technical	Core Web Vitals, crawlability, structured data
marketing-ai-search-optimization	ChatGPT/Perplexity/Claude SEO, AEO/GEO/LLMO

Skill Chain:

ICP Definition --> Content Strategy --> Channel Selection --> Execution --> Measurement

Stage 11: DOCUMENTS & COLLATERAL

Triggers: "pitch deck", "investor memo", "financial model", "spreadsheet", "PDF", "presentation", "Word doc"

Primary Skills:

Skill	When to Use
document-pptx	Pitch decks, investor presentations, slides
document-docx	Investor memos, contracts, reports
document-xlsx	Financial models, projections, data analysis
document-pdf	Reports, combined documents, extraction

Skill Chain:

Content Planning --> Template Selection --> Document Creation --> Review --> Export

Common Startup Document Workflows:

Document	Primary Skill	Supporting Skills
Pitch deck	document-pptx	startup-fundraising, startup-business-models
Financial model	document-xlsx	startup-business-models
Investor memo	document-docx	startup-fundraising
Market research report	document-pdf	startup-competitive-analysis, startup-trend-prediction

---

Three-Router Architecture

This framework uses three domain-specific routers for intelligent skill orchestration:

┌───────────────────────┐  ┌───────────────────────┐  ┌───────────────────────┐
│    router-startup     │  │  router-engineering   │  │  router-operations    │
│                       │  │                       │  │                       │
│  Business & Startup   │  │  Technical & AI/ML    │  │   QA & DevOps         │
│  8 startup skills     │  │  29 engineering skills│  │   15 operations skills│
│  4 marketing skills   │  │  6 claude-code skills │  │                       │
│  4 document skills    │  │                       │  │                       │
│  + product mgmt       │  │                       │  │                       │
└───────────────────────┘  └───────────────────────┘  └───────────────────────┘

Router Inventory

Router	Skills	Domain
router-startup	17	Business, validation, marketing, documents
router-engineering	29	Software, AI/ML, data, Claude Code framework
router-operations	15	QA, testing, DevOps, git, docs
Total	60+	Full coverage

Cross-Router Handoff Rules

From Router	To Router	Trigger Keywords
router-startup	router-engineering	"build", "implement", "code", "API", "frontend"
router-startup	router-operations	"test", "deploy", "CI/CD", "monitor"
router-engineering	router-startup	"pricing", "market", "competitors", "GTM"
router-engineering	router-operations	"test", "deploy", "debug", "monitor"
router-operations	router-startup	"launch", "pricing", "business model"
router-operations	router-engineering	"build fix", "implement", "architecture"

---

Cross-Router Workflow Patterns

Pattern 1: Startup to Production

router-startup                router-engineering              router-operations
        │                                    │                                    │
        ▼                                    │                                    │
startup-idea-validation ──────────────────►  │                                    │
        │                                    │                                    │
        ▼                                    │                                    │
startup-business-models ──────────────────►  │                                    │
        │                                    │                                    │
        │                                    ▼                                    │
        │ ◄─────────────────── software-architecture-design                       │
        │                                    │                                    │
        │                                    ▼                                    │
        │ ◄─────────────────── software-backend + software-frontend               │
        │                                    │                                    │
        │                                    │                                    ▼
        │                                    │ ◄─────────────── qa-testing-strategy
        │                                    │                                    │
        │                                    │                                    ▼
        │                                    │ ◄─────────────── ops-devops-platform
        │                                    │                                    │
        ▼                                    │                                    │
startup-go-to-market ◄────────────────────── │ ◄──────────────────────────────────┘
        │
        ▼
    LAUNCHED

Pattern 2: Technical Product with Business Validation

User: "Build an AI-powered CRM with competitive pricing"

Step 1: router-startup
        └─► startup-competitive-analysis (understand market)
        └─► startup-business-models (pricing strategy)

Step 2: HANDOFF → router-engineering
        └─► ai-agents (agent architecture)
        └─► software-backend (API design)
        └─► software-frontend (UI)

Step 3: HANDOFF → router-operations
        └─► qa-testing-strategy (test plan)
        └─► qa-agent-testing (LLM agent tests)
        └─► ops-devops-platform (deployment)

Step 4: HANDOFF → router-startup
        └─► startup-go-to-market (launch)
        └─► marketing-* (acquisition)

Pattern 3: Document + Technical + Operations (Parallel)

User: "Create pitch deck with working demo and deployment"

Parallel Execution:
├─► router-startup
│   └─► startup-fundraising (pitch content)
│   └─► document-pptx (slide creation)
│
├─► router-engineering
│   └─► software-frontend (demo UI)
│   └─► software-backend (demo API)
│
└─► router-operations
    └─► ops-devops-platform (demo deployment)
    └─► qa-testing-playwright (demo testing)

Aggregation → Complete pitch with live demo

---

Comprehensive Analysis Mode

For full opportunity analysis, invoke skills in parallel:

Layer 1: Discovery (Parallel)

Skill	Output	Purpose
startup-review-mining	Pain points, feature gaps	What customers hate
startup-trend-prediction	Rising/peaking trends	Market timing
software-ux-research	User research insights	Deep user understanding
startup-competitive-analysis	Competitor weaknesses	Where to attack

Layer 2: Validation (Sequential)

Skill	Input From	Output
startup-idea-validation	Layer 1 outputs	Validation scorecard
startup-business-models	Validation	Unit economics model

Layer 3: Planning (Based on Verdict)

If GO (80+):

• startup-business-models - Revenue model design
• startup-go-to-market - GTM strategy
• product-management - Roadmap
• software-architecture - Technical plan
• Technical implementation skills

If Conditional (60-79):

• Focus on riskiest assumptions
• Targeted experiments
• startup-competitive-analysis - Deeper competitive intel

If Pivot/No-Go (<60):

• Alternative direction analysis
• New opportunity discovery
• startup-review-mining - Different market

---

Skill Registry

Startup Validation Suite (9 skills)

Skill	Purpose	Key Outputs
router-startup	Orchestration	Routing decisions, skill chains
startup-idea-validation	Systematic scoring	9-dimension scorecard, Go/No-Go
startup-review-mining	Pain extraction	Pain points, opportunities
startup-trend-prediction	Future prediction	Trend analysis, timing
startup-competitive-analysis	Competitive intel	Positioning, moats, battlecards
startup-business-models	Revenue design	Unit economics, pricing
startup-go-to-market	GTM strategy	Channels, launch, growth
startup-fundraising	Capital raising	Pitch, valuation, terms
agent-fleet-operations	Agent services	Fleet management, economics

Product & UX (3 skills)

Skill	Purpose	Key Outputs
product-management	Product strategy	Discovery, OST, roadmaps
software-ux-research	User research	Pain patterns, feedback mining
software-ui-ux-design	Design systems	UI patterns, accessibility

Technical Implementation (15+ skills)

Category	Skills
Backend	software-backend-nodejs, software-backend-python, software-backend-go, etc.
Frontend	software-frontend-nextjs, software-frontend-nuxt, software-frontend-angular, etc.
Mobile	software-mobile (iOS, Android, React Native)
Data	software-database-sql, software-data-engineering
DevOps	software-devops, software-cicd

AI/ML (5+ skills)

Skill	Purpose
ai-agents	Multi-agent systems
ai-llm-development	LLM applications, RAG
ai-ml-data-science	ML workflows, modeling
ai-prompt-engineering	Prompt design
ai-fine-tuning	Model customization

Marketing & Growth (4 skills)

Skill	Purpose	Key Outputs
marketing-social-media	Social strategy	Content calendars, paid social, LinkedIn
marketing-leads-generation	Lead acquisition	ICP, outbound cadences, landing pages
marketing-seo-technical	Technical SEO	Core Web Vitals, crawlability, structured data
marketing-ai-search-optimization	AI search (AEO/GEO)	ChatGPT, Perplexity, Claude optimization

Document Creation (4 skills)

Skill	Purpose	Key Outputs
document-pptx	Presentations	Pitch decks, investor slides
document-docx	Word documents	Investor memos, contracts
document-xlsx	Spreadsheets	Financial models, projections
document-pdf	PDF handling	Reports, document merging

Cross-Router References

Router	Purpose	When to Hand Off
router-engineering	Technical implementation	Build, code, architecture
router-operations	QA, DevOps, testing	Test, deploy, monitor

See data/skill-registry.json for complete registry.

---

Routing Logic

Keyword-Based Routing

KEYWORDS -> SKILL MAPPING

"pain point", "frustration", "complaint" -> startup-review-mining
"trend", "predict", "future", "rising" -> startup-trend-prediction
"validate", "test", "hypothesis", "idea" -> startup-idea-validation
"competitor", "competitive", "positioning", "moat" -> startup-competitive-analysis
"pricing", "revenue model", "unit economics" -> startup-business-models
"GTM", "go to market", "launch", "channels" -> startup-go-to-market
"funding", "raise", "investors", "pitch" -> startup-fundraising
"agent fleet", "orchestration", "agent service" -> agent-fleet-operations
"discovery", "interview", "OST" -> product-management
"user research", "feedback", "pain patterns" -> software-ux-research
"design", "UI", "components", "accessibility" -> software-ui-ux-design

# Marketing Skills (Explicit Routing)
"social media", "LinkedIn", "content calendar", "paid social" -> marketing-social-media
"leads", "lead generation", "outbound", "ICP", "landing page" -> marketing-leads-generation
"SEO", "Core Web Vitals", "crawlability", "structured data" -> marketing-seo-technical
"AI search", "AEO", "GEO", "LLMO", "ChatGPT SEO", "Perplexity" -> marketing-ai-search-optimization

# Document Skills (Explicit Routing)
"pitch deck", "slides", "presentation", "PowerPoint" -> document-pptx
"investor memo", "Word doc", "contract", "report" -> document-docx
"financial model", "spreadsheet", "Excel", "projections" -> document-xlsx
"PDF", "report", "merge documents" -> document-pdf

# Cross-Router Handoffs
"build", "implement", "code", "architecture" -> router-engineering
"API", "backend", "frontend", "mobile", "AI agent" -> router-engineering
"test", "deploy", "CI/CD", "monitor", "debug" -> router-operations

Context-Based Routing

User Context	Primary Skill	Supporting Skills
Pre-idea (exploring)	startup-review-mining	startup-trend-prediction, software-ux-research
Has idea (validating)	startup-idea-validation	product-management, startup-competitive-analysis
Validated (planning)	startup-business-models	startup-go-to-market
Planning (building)	Technical skills	software-architecture, software-ui-ux-design
Built (launching)	startup-go-to-market	marketing-*
Growing (scaling)	All relevant	Based on bottleneck
Raising (funding)	startup-fundraising	startup-business-models
Scaling agents	agent-fleet-operations	ai-agents

---

Skill Chain Patterns

Pattern 1: Idea-to-Validation

START
  |
  v
startup-review-mining -----> Pain Points Extracted
  |
  v
startup-trend-prediction --> Timing Assessment
  |
  v
startup-competitive-analysis -> Competitive Position
  |
  v
startup-idea-validation ----> 9-Dimension Score
  |
  v
GO/NO-GO DECISION

Pattern 2: Opportunity-to-Product

START
  |
  v
startup-review-mining ------> Opportunity Identified
  |
  v
startup-competitive-analysis -> Positioning
  |
  v
startup-business-models -----> Revenue Model
  |
  v
product-management ----------> PRD + Roadmap
  |
  v
software-ui-ux-design -------> Design System
  |
  v
software-architecture -------> Technical Design
  |
  v
Implementation Skills -------> Built Product

Pattern 3: Market-to-Launch

START
  |
  v
startup-trend-prediction ----> Market Timing
  |
  v
startup-idea-validation -----> Market Sizing
  |
  v
startup-competitive-analysis -> Positioning
  |
  v
startup-business-models -----> Pricing Strategy
  |
  v
startup-go-to-market --------> GTM Plan
  |
  v
marketing-* skills ----------> GTM Execution

Pattern 4: Validation-to-Funding

START
  |
  v
startup-idea-validation -----> Validated Idea
  |
  v
startup-business-models -----> Unit Economics
  |
  v
startup-competitive-analysis -> Moat Analysis
  |
  v
startup-fundraising ---------> Pitch Materials
  |
  v
INVESTOR MEETINGS

Pattern 5: Agent Service Launch

START
  |
  v
ai-agents -------------------> Agent Architecture
  |
  v
agent-fleet-operations ------> Service Design
  |
  v
startup-business-models -----> Pricing Model
  |
  v
startup-go-to-market --------> Launch Strategy
  |
  v
AGENT SERVICE LIVE

---

Output Templates

Quick Analysis Output

## Analysis: {{TOPIC}}

**Stage Detected**: {{STAGE}}
**Primary Skill**: {{SKILL}}
**Supporting Skills**: {{LIST}}

### Key Findings
1. {{FINDING_1}}
2. {{FINDING_2}}
3. {{FINDING_3}}

### Recommended Next Steps
1. {{ACTION_1}} - Use {{SKILL}}
2. {{ACTION_2}} - Use {{SKILL}}

### Skills to Invoke Next
- {{SKILL_1}}: {{WHY}}
- {{SKILL_2}}: {{WHY}}

Comprehensive Analysis Output

See templates/comprehensive-analysis-report.md

---

Resources

Resource	Purpose
routing-logic.md	Detailed decision trees
skill-chain-patterns.md	Sequential/parallel patterns
opportunity-detection-rules.md	Opportunity scoring

Templates

Template	Purpose
comprehensive-analysis-report.md	Full analysis
skill-routing-decision.md	Routing documentation
hypothesis-test-plan.md	Experiment planning

Data

File	Purpose
skill-registry.json	Complete skill index
sources.json	Reference sources