program-router
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
SKILL.mdskills/39-program-router/SKILL.md
GitHubProgram Router
Escolha o menor conjunto capaz de resolver a task. O router possui duas camadas complementares:
- Composicao:
plugins/catalog/*.jsonmapeia a linguagem da task para skills existentes. - Execucao estruturada:
programs/*.ymlentra 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-opse qualquer rotahighexigem 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.mdepolicies/evals.mdquando 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.