specialist-agent

<p align="center">
  <img src="docs/public/logo-animated.svg" alt="Specialist Agent" width="180" />
</p>

<h1 align="center">Specialist Agent</h1>

<p align="center">Your AI development team. 36 agents. 32 skills. Ship faster.</p>

<p align="center">
  <a href="https://github.com/HerbertJulio/specialist-agent/actions/workflows/ci.yml"><img src="https://github.com/HerbertJulio/specialist-agent/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
  <a href="https://www.npmjs.com/package/specialist-agent"><img src="https://img.shields.io/npm/v/specialist-agent" alt="npm" /></a>
  <a href="https://www.npmjs.com/package/specialist-agent"><img src="https://img.shields.io/npm/dm/specialist-agent" alt="downloads" /></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT" /></a>
  <a href="https://specialistagent.com.br"><img src="https://img.shields.io/badge/Docs-specialistagent.com.br-646cff.svg" alt="Docs" /></a>
</p>

---

```bash
npx specialist-agent init
```

```bash
"Use @builder to create a payments module with CRUD"
"Use @reviewer to review the auth module"
/tdd implement calculateDiscount function
```

---

## Core Agents

The foundation. Build, review, debug, migrate.

| Agent | What it does | Example |
|-------|-------------|---------|
| `@starter` | Scaffold new projects from scratch | `"Create a Next.js + Prisma + Stripe app"` |
| `@builder` | Build modules, components, services | `"Create a products module with CRUD"` |
| `@reviewer` | 3-in-1 review: spec + quality + architecture | `"Review the auth module"` |
| `@doctor` | Systematic 4-phase debugging | `"Investigate the 500 error on login"` |
| `@migrator` | Modernize legacy code | `"Migrate src/legacy/ to TypeScript"` |

## Workflow Agents

Plan, execute, coordinate, remember.

| Agent | What it does | Example |
|-------|-------------|---------|
| `@planner` | Adaptive planning by complexity | `"Plan the checkout flow"` |
| `@executor` | Execute plans with checkpoints a