program-router
Skill27 starsChanged 2 months agoApache-2.0View on GitHub
Seleciona a composicao minima de skills e plugins para uma tarefa. Trigger em: "qual skill", "qual plugin", "qual program", "qual workflow", "roteie essa task", "auto orchestrate", "feature grande", "build app", "review PR", "discovery", "legacy", "greenfield".
In this repository91 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- po-feature-specSkill
- ui-ux-designSkill
- backend-apiSkill
- frontend-integrationSkill
- qa-testingSkill
- security-reviewSkill
- deploy-dockerSkill
- context-managerSkill
- orchestratorSkill
- documenterSkill
- reviewerSkill
- motion-designSkill
- marketing-copySkill
- seo-specialistSkill
- mobile-tauriSkill
- image-generatorSkill
- repo-auditorSkill
- asset-librarianSkill
- observability-sreSkill
- data-analyticsSkill
- accessibility-specialistSkill
- migration-refactor-specialistSkill
- release-managerSkill
- ai-integration-architectSkill
- prompt-engineerSkill
- video-integration-specialistSkill
- claude-md-generatorSkill
- design-intelligenceSkill
- cost-trackerSkill
- session-summarySkill
- smart-suggestionsSkill
- detective-specSkill
- static-analysisSkill
- skill-authorSkill
- web-asset-generatorSkill
- tdd-engineerSkill
- architecture-deepenerSkill
- parallel-dispatcherSkill
- blog-publisherSkill
- blog-screenshotSkill
- canary-deploymentSkill
- zoom-outSkill
- handoff-contextSkill
- post-deploy-canary-monitorSkill
- pattern-conformitySkill
- research-prepSkill
- context-budgetSkill
- direct-response-copySkill
- ux-researchSkill
- ui-polishSkill
- doubt-driven-reviewSkill
- video-analysisSkill
- marketing-reporting-analyticsSkill
- responsive-conversionSkill
- mobile-ux-foundationsSkill
- i18n-localizationSkill
- closed-loop-revenueSkill
- app-reference-architectureSkill
- The first 60 shown.
The file
Files
Program 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 --strictCheckpoint: 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.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

