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.

program-router