Instalacao

Pre-requisitos

• Um projeto com package.json
• Claude Code instalado

Instalar

# 1. Va ate seu projeto
cd /path/to/your-project

# 2. Execute o assistente
npx specialist-agent init

O assistente pergunta:

1. Framework — Vue 3, React (em breve)
2. Modo — Full (Sonnet/Opus) ou Lite (Haiku)
3. Agente starter — Instalar @starter para criacao de projetos?

O Que e Instalado

O instalador copia estes arquivos para o seu projeto:

your-project/
├── .claude/
│   ├── agents/              ← 5 subagentes de IA
│   │   ├── starter.md
│   │   ├── builder.md
│   │   ├── reviewer.md
│   │   ├── migrator.md
│   │   └── doctor.md
│   └── skills/              ← 12 skills
│       ├── dev-create-module/
│       ├── review-review/
│       ├── migration-migrate-module/
│       └── docs-onboard/
├── docs/
│   └── ARCHITECTURE.md      ← Fonte de verdade para padroes
└── CLAUDE.md                 ← Configuracao do projeto para o Claude

Nao-destrutivo

O instalador nunca sobrescreve arquivos ARCHITECTURE.md ou CLAUDE.md existentes. Se eles ja existirem, serao ignorados.

Modo Lite (Custo Menor)

Para uso com orcamento reduzido, instale agentes Lite que rodam no modelo Haiku:

npx specialist-agent init    # selecione "Lite" no assistente

Aspecto	Full	Lite
Modelo	Sonnet/Opus	Haiku
Custo	~5-25k tokens	~2-10k tokens
Validacao	tsc + build + vitest	Ignorada
Primeira acao	Le ARCHITECTURE.md	Regras inline

Mesmos nomes de agentes, mesmas capacidades — apenas mais barato por invocacao.

Verificar Instalacao

# Abra o Claude Code
claude

# Verifique se os agentes foram carregados
/agents

# Teste uma skill rapida
/review-check-architecture

Voce devera ver seus agentes instalados (ex: @starter, @builder, @reviewer, @migrator, @doctor, alem dos agentes especialistas se instalados).

Opcional: Context7 MCP

Para documentacao atualizada de bibliotecas ao perguntar ao Claude sobre APIs, voce pode adicionar o servidor MCP Context7. Isso beneficia voce como desenvolvedor — os agentes funcionam completamente sem ele:

// ~/.claude/mcp.json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Proximos Passos

• Inicio Rapido — Construa algo com os agentes
• Visao Geral da Arquitetura — Entenda os padroes
• Personalizacao — Adapte o kit ao seu projeto