# Spawner MCP Integration for QwenClaw

## Overview

[Spawner](https://spawner.vibeship.co/) is a skill-based agent system that extends AI capabilities by automatically spawning specialist agents for your specific project needs.

## Features

- **50+ Expert Skills** - Specialists for frameworks, development, integrations, design, marketing, product, and startup strategy
- **YAML-Powered Skills** - Structured 4-file YAML packages (skill.yaml, sharp-edges.yaml, validations.yaml, collaboration.yaml)
- **Sharp Edges Detection** - Warns about real pitfalls before you hit them
- **Automated Validation** - Catches bugs and anti-patterns before shipping
- **Auto-Spawning** - Skills are automatically matched to your stack
- **Memory & Persistence** - Remembers project structure, conventions, and domain rules

## Integration with QwenClaw

### Option 1: MCP Server (Recommended)

Add Spawner as an MCP server to QwenClaw Rig service:

1. **Install Spawner MCP:**
```bash
npx github:vibeforge1111/vibeship-spawner-skills install --mcp
```

2. **Configure in Rig service:**
```json
{
  "mcpServers": {
    "spawner": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vibeship.co"]
    }
  }
}
```

3. **Use in QwenClaw:**
```typescript
// In your QwenClaw code
import { RigClient } from "./rig";

const rig = new RigClient({ host: "127.0.0.1", port: 8080 });

// Use Spawner for project planning
const plan = await rig.executePrompt(sessionId, `
Use Spawner to plan this project:
Build me an invoice tracking SaaS
`);
```

### Option 2: Skills Integration

Copy Spawner skills to QwenClaw skills directory:

```bash
# Clone Spawner skills
git clone https://github.com/vibeforge1111/vibeship-spawner-skills.git

# Copy to QwenClaw
cp -r vibeship-spawner-skills/skills/* qwenclaw/skills/spawner/
```

### Available Spawner Skills

#### Development Skills
- `frontend-developer` - React, Vue, Svelte, Next.js, Nuxt
- `backend-developer` - Node.js, Python, Go, Rust
- `fullstack-developer` - End-to-end development
- `devops-engineer` - CI/CD, Docker, Kubernetes
- `security-engineer` - Security best practices

#### Framework Skills
- `nextjs-expert` - Next.js 14+ App Router
- `react-expert` - React 18+ patterns
- `supabase-expert` - Supabase integration
- `stripe-expert` - Stripe payments
- `tailwind-expert` - Tailwind CSS

#### Design Skills
- `ui-designer` - UI design principles
- `ux-researcher` - User research
- `design-system-architect` - Design systems

#### Product & Business
- `product-manager` - Product strategy
- `startup-advisor` - Startup guidance
- `marketing-strategist` - Marketing strategy

## Usage Examples

### New Project Planning
```
Use Spawner to plan: Build a SaaS for invoice tracking
```

### Existing Codebase Analysis
```
Analyze this codebase with Spawner and suggest improvements
```

### Stack Detection
```
Detect my stack and spawn appropriate specialist agents
```

## Configuration

Add to `rig-service/.env`:
```env
# Spawner MCP Configuration
SPAWNER_MCP_URL=https://mcp.vibeship.co
SPAWNER_ENABLED=true
```

## Resources

- **Website**: https://spawner.vibeship.co/
- **GitHub**: https://github.com/vibeforge1111/vibeship-spawner-skills
- **MCP Server**: https://mcp.vibeship.co
