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.md

GitHub

Program Router

Escolha o menor conjunto capaz de resolver a task. O router possui duas camadas complementares:

  1. Composicao: plugins/catalog/*.json mapeia a linguagem da task para skills existentes.
  2. 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

  1. Um comando, skill ou program explicitamente pedido pelo usuario vence o catalogo.
  2. Rode node scripts/route-task.mjs "<task>" para obter plugins, skills, policies e risco.
  3. Carregue somente as skills retornadas, ate tres plugins e seis skills por padrao.
  4. Se houver um sinal forte de pipeline, selecione um program. Caso contrario, execute a composicao diretamente.
  5. 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.