# Fast engineers for implementation (Sonnet is 5x faster, 80% cheaper)
genie spawn engineer --provider claude --model sonnet

# Thorough reviewer for quality gates (Opus catches subtle bugs)
genie spawn reviewer --provider claude --model opus

# Or use Codex for pure code generation tasks
genie spawn engineer --provider codex --model codex-mini

# Set up a custom provider endpoint
export OPENAI_API_BASE="https://your-custom-model.example.com/v1"
export OPENAI_API_KEY="your-key"

# Spawn an agent using your custom model
genie spawn engineer --provider openai --model your-domain-model

# Mix providers in the same team
genie team create ml-feature --repo . --wish ml-pipeline
genie spawn engineer --provider openai --model your-ml-model   # domain expert
genie spawn reviewer --provider claude --model opus             # general reviewer

# In your WISH.md, structure groups for parallelism:
# Wave 1 (parallel): Group 1, Group 2, Group 3 — no dependencies
# Wave 2 (parallel): Group 4, Group 5 — depends on Wave 1
# Wave 3: Group 6 — integration, depends on all

# The team-lead dispatches Wave 1 agents in parallel
genie team create fast-ship --repo . --wish my-feature
# Team-lead auto-detects independent groups and spawns 3 engineers simultaneously

# Monitor all agents at once
genie status my-feature
# Wave 1:
#   🔄 Group 1: API endpoints        in_progress  (engineer %41)
#   🔄 Group 2: Database migrations   in_progress  (engineer %42)
#   🔄 Group 3: Frontend components   in_progress  (engineer %43)

# Each team gets its own worktree — zero conflicts during development
genie team create auth-team --repo . --wish auth-overhaul
genie team create api-team --repo . --wish api-v2
genie team create ui-team --repo . --wish ui-refresh

# Teams work in isolation:
# ~/.genie/worktrees/myapp/auth-team/  → branch: team/auth-team
# ~/.genie/worktrees/myapp/api-team/   → branch: team/api-team
# ~/.genie/worktrees/myapp/ui-team/    → branch: team/ui-team

# When wishes are SHIP-ready, use /dream to merge in dependency order
# /dream picks SHIP-ready wishes, resolves ordering, merges to dev sequentially

# Queue wishes during the day
/brainstorm    # Explore ideas
/wish          # Crystallize into structured plans
/review        # Get SHIP approval on plans

# At end of day, kick off overnight batch
/dream

# Dream shows you the execution plan:
# DREAM.md — Execution Plan
# ┌─────────┬──────────────────┬─────────────┐
# │ Order   │ Wish             │ Dependencies│
# ├─────────┼──────────────────┼─────────────┤
# │ 1       │ auth-overhaul    │ none        │
# │ 1       │ api-v2           │ none        │
# │ 2       │ ui-refresh       │ api-v2      │
# │ 3       │ integration-test │ all         │
# └─────────┴──────────────────┴─────────────┘
# Confirm? [y/N]

# Wake up to DREAM-REPORT.md:
# ✅ auth-overhaul  — PR #142, merged to dev, QA passed
# ✅ api-v2         — PR #143, merged to dev, QA passed
# ⚠️  ui-refresh     — PR #144, FIX-FIRST (2 issues), fix loop exhausted
# ✅ integration-test — PR #145, merged to dev, QA passed

# Create your custom skill
mkdir -p skills/reset-dev
cat > skills/reset-dev/SKILL.md << 'EOF'
---
name: reset-dev
description: Reset dev environment — migrate, seed, restart
---

# Reset Dev Environment

Run these steps in order:

1. **Stop services:** `docker compose down`
2. **Reset database:** `docker compose run --rm api rails db:reset`
3. **Run migrations:** `docker compose run --rm api rails db:migrate`
4. **Seed data:** `docker compose run --rm api rails db:seed`
5. **Start services:** `docker compose up -d`
6. **Verify:** `curl -s http://localhost:3000/health | jq .status`

Report the health check result when done.
EOF

# Now use it anytime:
# /reset-dev

# In your Claude Code settings (~/.claude/settings.json), add a hook:
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          "bash -c 'if echo \"$CLAUDE_TOOL_INPUT\" | grep -q \"WISH.md\"; then SLUG=$(echo \"$CLAUDE_TOOL_INPUT\" | grep -oP \"wishes/\\K[^/]+\"); genie team create \"auto-$SLUG\" --repo . --wish \"$SLUG\"; fi'"
        ]
      }
    ]
  }
}

# Now when /wish writes a WISH.md file, a team auto-spawns:
# 1. /wish crystallizes your idea into .genie/wishes/my-feature/WISH.md
# 2. PostToolUse:Write fires
# 3. Hook detects WISH.md path, extracts slug
# 4. genie team create auto-my-feature --repo . --wish my-feature
# 5. Team-lead spawns, reads wish, starts dispatching

# Genie already emits these NATS events (built-in hooks):
# genie.tool.{agent}.call    — every tool use
# genie.msg.{recipient}      — every message delivery
# genie.user.{agent}.prompt  — every user prompt
# genie.agent.{agent}.response — every assistant response

# Simple NATS → Slack forwarder (Node.js example):
import { connect } from 'nats'
const nc = await connect({ servers: 'nats://localhost:4222' })

// Subscribe to all agent responses
const sub = nc.subscribe('genie.agent.*.response')
for await (const msg of sub) {
  const event = JSON.parse(new TextDecoder().decode(msg.data))

  // Post to Slack webhook
  await fetch(process.env.SLACK_WEBHOOK_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      text: `🤖 *${event.agent}*: ${event.summary}`,
      channel: '#genie-updates'
    })
  })
}

# Or use the NATS CLI for quick monitoring:
nats sub "genie.agent.>" --raw

### Hack N: Your Hack Title

**Problem:** What situation does this solve? (1-2 sentences)

**Solution:** How does it work? (Brief explanation)

\`\`\`bash
# Concrete commands or code
\`\`\`

**Benefit:** What do you gain? (Quantify if possible)

**When to use:** In what situations should someone reach for this?

# 1. Fork the docs repo
gh repo fork automagik-dev/docs --clone

# 2. Add your hack to genie/hacks.mdx
#    Follow the format above — problem → solution → code → benefit → when

# 3. Create a PR
git add genie/hacks.mdx
git commit -m "hack: your hack title"
gh pr create --base main --title "hack: your hack title" --body "
## New Hack

**Category:** providers | teams | skills | hooks
**Problem:** Brief description
**Tested on:** Genie version, OS, provider
"