---

name: router-main description: Universal entry point that routes any query to the appropriate domain router (startup, engineering, operations) - orchestrates 80 skills metadata: version: "1.4"

Router: Main

Universal entry point for the Claude Code Kit framework. This router analyzes your query and hands off to the appropriate domain router.

---

How It Works

CopyYOUR QUERY
    │
    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                              router-main                                     │
│                         (Universal Entry Point)                              │
└─────────────────────────────────┬───────────────────────────────────────────┘
                                  │
            ┌─────────────────────┼─────────────────────┐
            │                     │                     │
            ▼                     ▼                     ▼
┌───────────────────┐  ┌───────────────────┐  ┌───────────────────┐
│  router-startup   │  │ router-engineering│  │ router-operations │
│  23 skills        │  │  33 skills        │  │   20 skills       │
│                   │  │                   │  │                   │
│  Business         │  │  Technical        │  │  QA & DevOps      │
│  Marketing (9)    │  │  AI/ML            │  │  Testing          │
│  Documents        │  │  Software         │  │  Deployment       │
│  Startup          │  │  Data             │  │  Git              │
└───────────────────┘  └───────────────────┘  └───────────────────┘

---

Quick Routing

---

Routing Decision Tree

CopyQUERY ANALYSIS
    │
    ├─► Business keywords detected?
    │   • "idea", "validate", "market", "pricing", "funding"
    │   • "competitor", "GTM", "launch", "startup"
    │   • "pitch deck", "investor", "business model"
    │   • "marketing", "SEO", "social media", "leads"
    │   • "spreadsheet", "presentation", "document"
    │   └─► router-startup
    │
    ├─► Technical keywords detected?
    │   • "build", "implement", "code", "develop"
    │   • "API", "frontend", "backend", "mobile", "database"
    │   • "AI", "LLM", "agent", "RAG", "ML", "fine-tune"
    │   • "architecture", "design system", "component"
    │   • "Claude Code", "skill", "command", "hook"
    │   └─► router-engineering
    │
    ├─► Operations keywords detected?
    │   • "test", "QA", "testing", "Playwright", "E2E"
    │   • "deploy", "CI/CD", "Kubernetes", "Docker"
    │   • "monitor", "observability", "metrics", "logs"
    │   • "debug", "error", "fix", "troubleshoot"
    │   • "git", "commit", "PR", "branch", "merge"
    │   • "CLAUDE.md", "AGENTS.md", "large codebase", "documentation setup"
    │   └─► router-operations
    │
    └─► Ambiguous or multi-domain?
        └─► Ask clarifying question OR invoke multiple routers

---

Domain Routers

router-startup (23 skills)

Focus: Business validation, marketing, documents, product management

NEW in January 2026:

• marketing-product-analytics - PostHog/Pendo/Amplitude instrumentation, event taxonomy, LLM analytics, attribution

Use when: You have a business idea, need market validation, want to create business documents, plan your GTM strategy, need traffic/leads, or want to track product metrics.

router-engineering (33 skills)

Focus: Technical implementation, AI/ML, software development, Claude Code

Use when: You need to build something technical, implement an AI agent, design an API, or work with code.

router-operations (20 skills)

Focus: QA, testing, DevOps, deployment, git workflows, documentation

Use when: You need to test code, deploy to production, set up CI/CD, debug issues, manage git workflows, or set up documentation for large codebases (100K-1M LOC).

---

Cross-Router Workflows

The routers hand off to each other automatically. Common flows:

Flow 1: Idea → Product → Launch

Copyrouter-startup (validate idea)
       ↓
router-engineering (build MVP)
       ↓
router-operations (test & deploy)
       ↓
router-startup (GTM & launch)

Flow 2: Technical Product

Copyrouter-engineering (architecture)
       ↓
router-engineering (implementation)
       ↓
router-operations (testing)
       ↓
router-operations (deployment)
       ↓
router-startup (pricing & launch)

Flow 3: Quick Fix

Copyrouter-operations (debug issue)
       ↓
router-engineering (implement fix)
       ↓
router-operations (test & deploy)

---

Example Queries

---

Error Handling & Fallbacks

CopyROUTING FAILURE HANDLING
    │
    ├─► No route matched?
    │   └─► Ask clarifying question
    │   └─► "Could you clarify: is this a business, technical, or operations question?"
    │
    ├─► Multiple routes matched equally?
    │   └─► Invoke multiple routers in parallel
    │   └─► Synthesize combined results
    │
    ├─► Sub-router failed?
    │   └─► Retry with exponential backoff
    │   └─► Fallback to broader skill if specialized fails
    │
    └─► Critical failure?
        └─► Human escalation path
        └─► Log for observability

Best Practices:

• Implement retry logic with exponential backoff for transient failures
• Use circuit breakers to prevent cascading failures across routers
• Always have fallback paths for critical workflows

---

Observability

For production deployments, trace routing decisions:

Key metrics to track:

• Routing latency (target: <100ms)
• Route distribution (detect drift)
• Fallback rate (should be <5%)

See qa-observability skill for full instrumentation guide.

---

Getting Started

Just describe what you need. This router will figure out where to send you.

Examples:

• "Help me validate my startup idea"
• "I need to build a mobile app"
• "Set up testing for my project"
• "Create a financial model"
• "Implement an AI agent"

The framework has 80 specialized skills ready to help across all domains.