EvandroandClaude Opus 5.5
f2db2d69da
Each workflow was ~300 lines of grep-count "VERIFICAR" steps and ran every phase for every request. Phases now state their minimum tier, checks are the quality gate plus real tools, detail moved to references/, and machine-specific paths and non-public skills are gone. Security references move to OWASP Top 10:2025, ASVS 5.0 and the OWASP LLM Top 10. Co-Authored-By: Claude Opus 5.5 <[email protected]>
4.0 KiB
name, description, license, metadata
| name | description | license | metadata | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dev-router | Use no início de qualquer pedido de código (feature, bug, refactor, UI, API, migração, review; "implement", "fix", "build", "add", "change"). Classifica o pedido em nível 0 a 3 e decide quais workflows, agentes e checagens rodar, para um pedido pequeno não pagar o custo de um grande. | MIT |
|
Dev Router
A primeira linha da resposta declara o nível: Nível N: <motivo em uma frase>.
1. Classificar
| Nível | Quando | Exemplos |
|---|---|---|
| 0, trivial | nenhum comportamento muda; 1 arquivo | texto, cor, typo, renomear variável local |
| 1, pequeno | comportamento muda em 1 a 3 arquivos, sem superfície pública nova | bug localizado, ajuste de validação, refactor local |
| 2, feature | superfície nova ou contrato alterado; 4+ arquivos; dependência nova | endpoint, tela, módulo, integração |
| 3, grande ou de risco | vários módulos ou serviços, dados existentes, arquitetura, release | migração com dados, troca de auth, novo serviço |
Na dúvida entre dois níveis, escolha o menor e suba quando aparecer um gatilho.
2. Gatilhos que sobem o nível a qualquer momento
| Gatilho | Mínimo | Soma |
|---|---|---|
| autenticação, autorização, sessão, tokens, criptografia | 2 | security-auditor |
| dinheiro, cobrança, dados pessoais (LGPD) | 2 | security-auditor |
| upload, SQL montado à mão, shell/exec, desserialização, template com entrada do usuário | 2 | security-auditor |
| dependência nova | 1 | safedeps antes de instalar |
| migração de schema | 2 (3 se mexe em dado existente) | rollback testado |
| feature que chama um LLM | 2 | OWASP LLM Top 10 no security-auditor |
Depois que um gatilho disparou, não rebaixe por conta própria.
O usuário pode forçar: "modo rápido" vira nível 0 ou 1, mas gatilho de segurança continua valendo (avise); "modo completo" vira nível 3.
3. O que cada nível roda
| Nível | Fluxo | Workflow | Agentes |
|---|---|---|---|
| 0 | fazer, rodar o gate | nenhum | nenhum |
| 1 | entender ou reproduzir, mudar, teste de regressão, gate | wf-bugfix ou wf-refactor |
explorer só se não souber onde está o código |
| 2 | explorar, plano curto, TDD, revisão independente, gate | wf-backend e/ou wf-frontend; full-stack começa pelo contrato do backend |
explorer, implementer, reviewer; security-auditor com gatilho; ui-critic com UI |
| 3 | spec EARS com IDs e ADR, aprovação do usuário, tarefas pequenas com TDD, revisões, gate | wf-architecture antes; wf-backend/wf-frontend na execução; wf-security-review no fim |
planner, implementer, reviewer, security-auditor, ui-critic com UI, verifier |
Em todo nível: aplique lean-code. Peça aprovação do usuário só quando houver uma decisão que é dele (produto, custo, dado existente); no nível 3, a spec sempre passa por ele.
Delegue a um agente quando o trabalho dele não precisa voltar inteiro para esta conversa (mapear código, revisar um diff). Tarefa que cabe em poucos passos você mesmo faz.
4. Gate de qualidade
Antes de dizer que terminou, rode:
"${CLAUDE_PLUGIN_ROOT}/scripts/quality-gate" --tier N
fail: corrija. Se não der, explique ao usuário o que falhou e por quê.incomplete: diga ao usuário quais checagens ficaram "não verificado" (ferramenta ausente). Nunca chame de testado o que não rodou.dependências novas: justifique cada uma (verlean-code).
O hook de Stop bloqueia o encerramento enquanto houver código alterado sem gate atualizado ou com gate falho. Configuração por projeto e lista de checagens: references/quality-gate.md.
5. Relatório final (nível 1 ou mais)
- Nível e motivo.
- O que mudou: arquivos e linhas líquidas (
diffdo gate). - Evidência: veredito do gate; checagens ok, falhas e não verificadas.
- O que ficou de fora ou é risco conhecido.