🐾 Neko Task Router

Routes tasks to appropriate 9-personality teams automatically.

Installation

npm install

Usage

CLI

# Route a task
node src/cli.js "Implement user authentication with OAuth2"

# View formations
node src/cli.js --formations

# View personalities
node src/cli.js --personalities

# View task matrix
node src/cli.js --matrix

REST API

# Start server (port 3005)
npm start

# Route a task
curl -X POST http://localhost:3005/api/route \
  -H "Content-Type: application/json" \
  -d '{"task": "Implement user authentication"}'

# Get formations
curl http://localhost:3005/api/formations

# Get personalities
curl http://localhost:3005/api/personalities

# Get analytics
curl http://localhost:3005/api/analytics

MCP Server

Add to Claude Code settings:

{
  "mcpServers": {
    "task-router": {
      "command": "node",
      "args": ["/path/to/neko-task-router/mcp/server.js"]
    }
  }
}

Team Formations

| Formation | Use Case | Team | |-----------|----------|------| | 🚀 Strike | Quick fixes | Neko → Noel → Mario | | 🔬 Research | Deep investigation | Hannibal → Amaniya → Lain → Neko | | 🏗️ Architecture | New features | Tetora → Glam → Mario → Neko | | 📦 Data | Migrations | Miwa → Lain → Noel → Neko | | 🛡️ Security | Threat analysis | Lain → Amaniya → Hannibal → Neko | | 📋 Full | Major decisions | All 9 → Tetora synthesizes |

9 Personalities

| Personality | Role | Strengths | |-------------|------|-----------| | 🐾 Neko-Arc | Tech Lead | coding, performance, security | | 🎭 Mario | Orchestrator | automation, documentation | | 🗡️ Noel | QA Lead | testing, validation | | 🎸 Glam | Ethics Officer | ethics, cultural, accessibility | | 🧠 Hannibal | Forensic Analyst | forensics, debugging | | 🧠 Tetora | Synthesizer | architecture, decisions | | 🔍 Amaniya | Pattern Hunter | investigation, hidden patterns | | 🔪 Miwa | Data Engineer | migration, transformation | | 🌐 Lain | Network Analyst | network, security, tracing |

API Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /api/route | Route a task | | GET | /api/formations | Get all formations | | GET | /api/personalities | Get all personalities | | GET | /api/matrix | Get task matrix | | GET | /api/analytics | Get analytics | | GET | /api/history | Get routing history | | GET | /api/health | Health check |

MCP Tools

• task_router_route - Route a task
• task_router_formations - Get formations
• task_router_personalities - Get personalities
• task_router_matrix - Get task matrix
• task_router_analytics - Get analytics

Architecture

neko-task-router/
├── src/
│   ├── index.js              # REST API server
│   ├── cli.js                # CLI interface
│   ├── task-router.module.js # Orchestration (RULE 5)
│   ├── task-router.service.js # External (RULE 5)
│   └── task-router.validation.js # Validation (RULE 5)
├── mcp/
│   └── server.js             # MCP server
└── package.json

Version

v1.0.0 - Compatible with CLAUDE.md v3.13.0

License

MIT