# Clone
git clone https://github.com/YOUR_USER/ai-orchestrator.git
cd ai-orchestrator

# Install
npm install
npm run build

# Configure at least one provider
export OPENAI_API_KEY="sk-..."
# OR
export ANTHROPIC_API_KEY="sk-ant-..."
# OR run Ollama locally: ollama serve

// opencode.json
{
  "mcpServers": {
    "ai-orchestrator": {
      "command": "node",
      "args": ["/path/to/ai-orchestrator/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
      }
    }
  }
}

// .claude/mcp.json
{
  "mcpServers": {
    "ai-orchestrator": {
      "command": "node",
      "args": ["/path/to/ai-orchestrator/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "ai-orchestrator": {
      "command": "node",
      "args": ["/absolute/path/to/ai-orchestrator/dist/index.js"]
    }
  }
}

Use the orchestrate tool to review: "Should we rewrite our Bootstrap themes to Tailwind?"

Strategy: council
Council: executive_board

Orchestrate a debate on: "Should we adopt microservices?"

Strategy: debate
Rounds: 3

Brainstorm ideas for: "How to improve developer onboarding?"

Strategy: brainstorm

Evaluate these database options: PostgreSQL, MongoDB, Supabase
Criteria: Performance (0.4), Ease of Use (0.3), Cost (0.3)

Strategy: evaluate

Review this architecture spec from security, performance, and UX perspectives.

Strategy: spec-review

Evaluate: "Should we migrate to microservices?"

Strategy: council
Council: executive_board
Advisors:
  - id: skeptic
    provider: deepseek
  - id: visionary
    provider: anthropic
  - id: pragmatist
    provider: openai
    model: gpt-4o
  - id: security_auditor
    provider: groq
  - id: business_analyst
    provider: google
  - id: ux_advocate
    provider: openrouter

src/
├── index.ts          # MCP Server entry point (4 tools exposed)
├── types.ts          # TypeScript type definitions
├── personas.ts       # 15+ advisor personas + 5 council presets
├── providers.ts      # LLM provider layer (7 providers)
└── strategies/
    ├── council.ts    # Karpathy 3-stage multi-advisor council
    ├── debate.ts     # Structured pro/con debate with judge
    ├── brainstorm.ts # Creative brainstorming with clustering
    └── evaluate.ts   # Multi-criteria evaluation + spec review

                    ┌─────────────┐
                    │  Question   │
                    └──────┬──────┘
            ┌──────────────┼──────────────┐
      ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐
      │ Advisor A │ │ Advisor B │ │ Advisor N │  ← Parallel (isolated)
      │ (Skeptic) │ │(Visionary)│ │  (...)    │
      └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
            └──────────────┼──────────────┘
                     ┌─────▼─────┐
                     │ Anonymize │              ← Anonymous review
                     └─────┬─────┘
            ┌──────────────┼──────────────┐
      ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐
      │ Peer Rev A│ │ Peer Rev B│ │ Peer Rev N│
      └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
            └──────────────┼──────────────┘
                     ┌─────▼─────┐
                     │ Chairman  │              ← Synthesis
                     │ Verdict   │
                     └───────────┘

npm install        # Install dependencies
npm run build      # Compile TypeScript
npm run dev        # Watch mode
npm start          # Run server directly