# Skill Map — Qual skill usar em cada situação

## Por tipo de tarefa

### Arquitetura / planejamento técnico
- `/arquitetura-imperatriz` — aplica 6 padrões Atlassian em Node/TS
- Agente `Plan` — desenha implementação step-by-step antes de codar
- `/saas-arquitetura` — quando o projeto é um SaaS com IA no centro

### Build paralelo (múltiplas partes independentes)
- `/multi-terminal` — gera plano paralelo com contratos por terminal
- Usar quando a fatia tem ≥3 blocos independentes (ex: schema + lib + UI)

### Verificação pós-build
- `/verify` — roda o app e observa comportamento real (não só testes)
- `/code-review` — revisa diff para bugs e simplificações
- `/run` — sobe o servidor e confirma que a feature funciona no browser

### Configuração de permissões / hooks
- `/update-config` — adiciona ao allowlist do settings.json, configura hooks
- `/fewer-permission-prompts` — analisa transcrições e monta allowlist ideal

### Deploy em VPS
- `/skill-deploy-vps` — padrão de deploy Node + PM2 + nginx + SSL

### Qualidade de código
- `/qa-expert` — revisão orientada a qualidade e cobertura
- `/security-audit` — quando há auth, dados sensíveis ou APIs externas

### Documentação de processo
- Agente `Plan` com output em `.build-scope.md` — mantém rastreabilidade

---

## Por projeto (referência rápida)

| Projeto | Skills prioritárias |
|---------|---------------------|
| Agência OS | `Plan` → `/multi-terminal` → `/verify` → `/code-review` |
| Apps Node/VPS | `/arquitetura-imperatriz` → `/skill-deploy-vps` → `/verify` |
| SaaS novo | `/saas-context-doc` → `/saas-arquitetura` → `/saas-build-planner` |
| Skill nova | `/skill-creator` → `/update-config` (adicionar ao MEMORY.md) |
| Landing page / copy | `/briefing-copy-360` → skill de copy relevante → `/voz-humana-br` |
| Ads / criativos | `/analise-anuncio-1000` → skill de criativo → `/skill-relatorio-ads` |

---

## Ordem padrão de orquestração

```
1. PLANEJAR   → agente Plan  (ou /arquitetura-imperatriz para Node/TS)
2. PARALELIZAR → /multi-terminal  (se ≥3 blocos independentes)
3. CONSTRUIR  → Claude direto com .build-scope.md como âncora
4. VERIFICAR  → /verify + /code-review
5. DEPLOY     → /skill-deploy-vps  (se for pra VPS)
6. REPORTAR   → diff final vs .build-scope.md
```

## Quando NÃO usar skills adicionais

- Tarefa é uma única edição de arquivo → Claude direto, sem skill
- Já existe plano aprovado e escopo claro → pula Fase de planejamento
- Projeto tem CLAUDE.md detalhado → lê CLAUDE.md, não chama /arquitetura-imperatriz
