Program Router
Escolha o menor conjunto capaz de resolver a task. O router possui duas camadas complementares:
- Composicao:
plugins/catalog/*.json mapeia a linguagem da task para skills existentes.
- Execucao estruturada:
programs/*.yml entra apenas quando a task precisa de um pipeline completo.
O hook intent-classifier aplica a mesma composicao automaticamente em prompts nao triviais. Esta skill confirma, ajusta ou explica a decisao.
Ordem de decisao
- Um comando, skill ou program explicitamente pedido pelo usuario vence o catalogo.
- Rode
node scripts/route-task.mjs "<task>" para obter plugins, skills, policies e risco.
- Carregue somente as skills retornadas, ate tres plugins e seis skills por padrao.
- Se houver um sinal forte de pipeline, selecione um program. Caso contrario, execute a composicao diretamente.
- Sem rota confiavel, entregue para a skill 09 (
orchestrator) montar um fluxo ad-hoc.
Programs
| Program |
Quando usar |
pipeline-discovery |
ideia vaga, PRD ou discovery formal |
spec-driven-development |
feature nova com criterios e gates |
loop-polishing |
trabalho autonomo com polishing pre-commit |
detective-spec |
legado, contratos desconhecidos, sem documentacao |
adversarial-dev |
aplicativo greenfield do zero |
comprehensive-review |
review profundo de PR |
refactor-safely |
refactor com preservacao de comportamento |
Composicoes bundladas
| Plugin |
Cobertura |
core-discovery |
especificacao, legado, arquitetura, pesquisa |
development |
backend, frontend, testes, seguranca, review |
design-quality |
UI/UX, acessibilidade, motion, acabamento visual |
product-marketing |
copy, landing, SEO, blog e conversao |
ai-integration |
LLM, prompts, imagens, assets e video |
release-ops |
deploy, release, observabilidade e canary |
Recomendacoes externas
| Plugin |
Quando recomendar |
Limite |
finance-workflows |
demonstracoes, conciliacao, faturamento, payroll, auditoria financeira |
usuario instala o plugin; revisao humana obrigatoria |
legal-workflows |
contratos, NDA e compliance legal |
usuario instala o plugin; revisao juridica qualificada obrigatoria |
context7-docs |
documentacao atualizada, API reference e versao de framework/biblioteca |
usuario instala ou autoriza o MCP; citar a fonte retornada |
Esses dois itens sao metadados de descoberta, nao dependencias do kit. O router pode sugeri-los, mas nunca tenta invoca-los, instala-los ou apresenta seu resultado como conselho profissional.
Marketing e design sao composicoes de primeira classe: uma landing normalmente combina product-marketing e design-quality, e so inclui development quando houver implementacao de codigo.
Safety gates
release-ops e qualquer rota high exigem revisao humana antes de acao externa.- O catalogo nao instala plugins externos nem autoriza conectores.
- Nao carregue skills extras por precaucao; use o catalogo e
policies/progressive-skill-loading.md.
- Respeite
policies/tool-safety.md e policies/evals.md quando a task usa tools ou muda comportamento.
Verificacao
node scripts/route-task.mjs "crie a copy e o design de uma landing page"
node scripts/validate-plugin-catalog.mjs
node scripts/eval-plugin-routing.mjs --strict
node scripts/devkit-doctor.mjs --strict
Checkpoint: se eval-plugin-routing.mjs --strict falhar após editar o catálogo, o roteamento mudou pra pior em algum caso conhecido — reverter a edição no catálogo (não relaxar o --strict pra passar) e ajustar de novo até o eval confirmar que os casos antigos continuam roteando certo, não só o caso novo que motivou a mudança.
1---2name: program-router3description: Decide a composicao minima de plugins, skills e, quando necessario, programs declarativos para uma task. Use antes de improvisar um pipeline ou quando o usuario perguntar qual skill, plugin, workflow ou program usar. Trigger em: "qual skill", "qual plugin", "qual program", "qual workflow", "roteie essa task", "auto orchestrate", "feature grande", "build app", "review PR", "discovery", "legacy", "greenfield".4---56# Program Router78Escolha o menor conjunto capaz de resolver a task. O router possui duas camadas complementares:9101. **Composicao**: `plugins/catalog/*.json` mapeia a linguagem da task para skills existentes.112. **Execucao estruturada**: `programs/*.yml` entra apenas quando a task precisa de um pipeline completo.1213O hook `intent-classifier` aplica a mesma composicao automaticamente em prompts nao triviais. Esta skill confirma, ajusta ou explica a decisao.1415## Ordem de decisao16171. Um comando, skill ou program explicitamente pedido pelo usuario vence o catalogo.182. Rode `node scripts/route-task.mjs "<task>"` para obter plugins, skills, policies e risco.193. Carregue somente as skills retornadas, ate tres plugins e seis skills por padrao.204. Se houver um sinal forte de pipeline, selecione um program. Caso contrario, execute a composicao diretamente.215. Sem rota confiavel, entregue para a skill 09 (`orchestrator`) montar um fluxo ad-hoc.2223## Programs2425| Program | Quando usar |26|---|---|27| `pipeline-discovery` | ideia vaga, PRD ou discovery formal |28| `spec-driven-development` | feature nova com criterios e gates |29| `loop-polishing` | trabalho autonomo com polishing pre-commit |30| `detective-spec` | legado, contratos desconhecidos, sem documentacao |31| `adversarial-dev` | aplicativo greenfield do zero |32| `comprehensive-review` | review profundo de PR |33| `refactor-safely` | refactor com preservacao de comportamento |3435## Composicoes bundladas3637| Plugin | Cobertura |38|---|---|39| `core-discovery` | especificacao, legado, arquitetura, pesquisa |40| `development` | backend, frontend, testes, seguranca, review |41| `design-quality` | UI/UX, acessibilidade, motion, acabamento visual |42| `product-marketing` | copy, landing, SEO, blog e conversao |43| `ai-integration` | LLM, prompts, imagens, assets e video |44| `release-ops` | deploy, release, observabilidade e canary |4546## Recomendacoes externas4748| Plugin | Quando recomendar | Limite |49|---|---|---|50| `finance-workflows` | demonstracoes, conciliacao, faturamento, payroll, auditoria financeira | usuario instala o plugin; revisao humana obrigatoria |51| `legal-workflows` | contratos, NDA e compliance legal | usuario instala o plugin; revisao juridica qualificada obrigatoria |52| `context7-docs` | documentacao atualizada, API reference e versao de framework/biblioteca | usuario instala ou autoriza o MCP; citar a fonte retornada |5354Esses dois itens sao metadados de descoberta, nao dependencias do kit. O router pode sugeri-los, mas nunca tenta invoca-los, instala-los ou apresenta seu resultado como conselho profissional.5556Marketing e design sao composicoes de primeira classe: uma landing normalmente combina `product-marketing` e `design-quality`, e so inclui `development` quando houver implementacao de codigo.5758## Safety gates5960- `release-ops` e qualquer rota `high` exigem revisao humana antes de acao externa.61- O catalogo nao instala plugins externos nem autoriza conectores.62- Nao carregue skills extras por precaucao; use o catalogo e `policies/progressive-skill-loading.md`.63- Respeite `policies/tool-safety.md` e `policies/evals.md` quando a task usa tools ou muda comportamento.6465## Verificacao6667```bash68node scripts/route-task.mjs "crie a copy e o design de uma landing page"69node scripts/validate-plugin-catalog.mjs70node scripts/eval-plugin-routing.mjs --strict71node scripts/devkit-doctor.mjs --strict72```7374**Checkpoint:** se `eval-plugin-routing.mjs --strict` falhar após editar o catálogo, o roteamento mudou pra pior em algum caso conhecido — reverter a edição no catálogo (não relaxar o `--strict` pra passar) e ajustar de novo até o eval confirmar que os casos antigos continuam roteando certo, não só o caso novo que motivou a mudança.
felvieira