felvieira/program-router
skills/39-program-router/SKILL.md
Skill que decide qual program (programs/*.yml) rodar baseado em classificação da task. Funciona em paralelo com o hook intent-classifier (que sugere) e a skill 09 (orchestrator, que monta pipelines ad-hoc). Use quando o usuário pede algo que pode mapear pra um program existente — antes de improvisar pipeline. Trigger em: "qual program", "rodar program", "auto orchestrate", "program apropriado", "qual workflow", "what program", "feature grande", "build app", "review PR", "discovery", "legacy", "from scratch", "greenfield", "constitution", "spec driven", "adversarial".
$ install --global
skillsauthnpx skillsauth add felvieira/claude-skills-fv program-routerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 25, 2026, 3:18 AM51.8s1 file scanned
SKILL.md
- name:
- program-router
- description:
- |
- Trigger em:
- qual program", "rodar program", "auto orchestrate", "program apropriado", "qual workflow",
- allowed-tools:
- Read, Glob, AskUserQuestion, Bash(node scripts/run-program.mjs *)
Program Router
Decide qual program declarativo rodar baseado em classificação da task. Trabalha em par com:
- Hook
intent-classifier(auto-sugere antes do agente começar) - Skill 09 (orchestrator) (monta pipelines ad-hoc quando não há program adequado)
Governanca Global
Esta skill segue GLOBAL.md, policies/auto-orchestration.md, policies/handoffs.md, policies/execution.md e policies/programs-schema.md.
Hierarquia de decisão
- Usuário invocou
/run-program <nome>explícito → rodar exatamente isso. Skill não interfere. - Hook
intent-classifiersugeriu program e usuário concordou → essa skill confirma e dispatcha. - Hook não sugeriu mas task parece grande/estruturada → essa skill classifica e propõe.
- Task é simples/ad-hoc → essa skill recusa, devolve para skill 09 (orchestrator) montar pipeline informal.
Quando Usar
- usuário pergunta "qual program devo rodar pra X"
- usuário pede feature/review/discovery sem invocar slash explícito
- hook intent-classifier sugeriu e usuário pediu confirmação
- entre tasks, ao planejar próximo passo
Quando Nao Usar
- usuário já invocou
/run-programexplícito - task trivial (typo, rename, format) — devolve para skill 09 ou ação direta
- pergunta informacional ("o que é X program") — devolve para WIKI
Entradas Esperadas
- descrição da task (pode estar implícita no contexto)
- (opcional) confidence do hook intent-classifier (se já disparou)
- (opcional)
memory/constitution.md— pode forçar pipeline específico
Saidas Esperadas
- decisão
routed: program + inputs sugeridos - OU decisão
decline: razão + handoff para skill 09 ou ação direta
Catálogo de programs (atualizado pra v1.8.0)
| Program | Use case | Confidence sinais |
|---|---|---|
| pipeline-discovery | Ideia vaga → discovery formal → issues | "ideia vaga", "preciso de PRD", "grill-me" |
| spec-driven-development | Feature em projeto maduro com constitution | "nova feature", "constitution", "spec-driven" |
| loop-polishing | Task autônoma com polish pré-commit | "auto-loop", "autônomo", "fire and forget" |
| detective-spec | Reverse-engineering de legado | "legacy", "sem docs", "extrair contratos" |
| adversarial-dev | App from-scratch com GAN-style adversarial loop | "from scratch", "greenfield", "construir app" |
| comprehensive-review | PR review profundo (5 agents) | "review crítico", "5-agent", "comprehensive review" |
Processo
Passo 1 — Coletar sinais
- Ler último prompt do usuário
- Verificar se há
additionalContextdo hookintent-classifier(geralmente sim, então a decisão é confirmar) - Detectar palavras-gatilho na conversa atual + repo audit + git log recente
Passo 2 — Classificar
Match heurístico em ordem de prioridade:
- Constitution força pipeline? — Ler
memory/constitution.md. Se declara "todo feature passa por spec-driven-development", forçar. - Task tipo "build greenfield" — sinais: "from scratch", repo vazio, sem ADRs →
adversarial-dev - Task tipo "feature em projeto existente" — sinais: ADRs presentes, codebase > 100 files, palavras "feature" + "criar" →
spec-driven-development - Task tipo "ideia vaga" — sinais: "não sei", "talvez", < 100 chars no prompt →
pipeline-discovery - Task tipo "review PR" — sinais: número de PR mencionado, "review", "auto-fix" →
comprehensive-review - Task tipo "reverse engineering" — sinais: codebase sem CLAUDE.md, sem testes, "legacy" →
detective-spec - Task tipo "autônoma" — sinais: "rodar até funcionar", "deixa ele trabalhar", "auto" →
loop-polishing
Se nenhum match: decline → handoff skill 09.
Passo 3 — Confirmar com usuário (via AskUserQuestion)
Vou rotear esta task para o program `<nome>` porque <razão concreta>.
Opções:
- ✅ Rodar dry-run primeiro (recomendado) — mostra plano antes de executar
- ▶️ Rodar direto (gates humanos pausam mid-flow)
- 🛠️ Pipeline ad-hoc (devolve para skill 09 montar fluxo custom)
- ❌ Cancelar
Passo 4 — Dispatch
Se "dry-run":
node scripts/run-program.mjs <program-id> --dry-run --input key=value
Apresentar plano resolvido. Esperar nova confirmação.
Se "direto":
Invocar /run-program <program-id> com inputs colhidos.
Se "ad-hoc": Handoff para skill 09 (orchestrator). Skill 09 monta pipeline informal.
Se "cancelar": Devolver controle para conversa normal.
Anti-padrões
- Forçar program quando task é exploratória — exploração merece skill 09 informal
- Sugerir program sem contexto suficiente — preferir "decline + pergunta" do que "match errado"
- Múltiplos programs em sequência sem gate — gates entre programs são essenciais
- Roteamento sem ler constitution — pode propor program que viola princípio do projeto
Handoff
- Para
/run-program <name>— caminho default quando match high confidence - Para skill 09 — quando match low/decline; orchestrator monta fluxo informal
- Para conversa — quando user cancela ou task realmente é trivial
Integração com Pipeline
- Skill 09 (Orchestrator) — para tasks sem program adequado, devolve aqui
- Skill 18 (Repo Auditor) — input sobre maturidade do codebase ajuda decidir greenfield vs spec-driven
- Hook intent-classifier — sugestão pre-skill; aqui confirma ou refuta
- Constitution — pode forçar pipeline; skill 39 respeita
Verificação
Listar programs disponíveis sem rotear:
node scripts/run-program.mjs --list
Inspecionar program específico antes de propor:
node scripts/run-program.mjs --describe <program-id>
Related Skills
felvieira/41-blog-publisher
development
VerifiedTrustedCommunity
Skill compositora que pega texto/assunto e gera post de blog HTML completo no repo {blog_repo_path} ({github_user_repo_url}), com imagens (via skill 17 fal.ai ou skill 42 Playwright screenshot), commit+push automático, retorna URL pública via GitHub Pages. Trigger em: "post no blog", "publicar post", "escrever post", "blog post", "publish blog", "gera post", "criar post", "novo post no meu blog".
19SKILL.mdUpdated May 25, 2026
felvieira/context-budget
tools
VerifiedTrustedCommunity
Audita o peso de contexto carregado na sessão — CLAUDE.md, agents, MCP descriptions, rules ativas, skills invocadas e histórico acumulado. Estima tokens por componente, reporta headroom disponível e emite alertas de overflow. Distinto do cost-tracker (skill 30) que rastreia tokens gastos em completions runtime. Trigger em: "contexto inchado", "context overflow", "quanto contexto estou usando", "peso do contexto", "context budget", "tokens carregados", "sessao lenta", "respostas degradadas", "headroom de contexto", "custo fixo de contexto", "overhead de rules", "overhead dos agents", "impacto do MCP no contexto", "espaco no context window", "quanto cabe no context window"
18SKILL.mdUpdated May 29, 2026
felvieira/research-prep
development
VerifiedTrustedCommunity
Coleta e organiza informacao tecnica multi-fonte antes de escrever docs, PRDs, ADRs ou artigos. Busca em: docs oficiais, GitHub (repos + issues), Stack Overflow, papers e blogs de referencia. Ranqueia fontes por autoridade (oficial 40% + recencia 30% + profundidade 20% + comunidade 10%). Output: memory/research/<slug>.md pronto para alimentar skill 10 (documenter), skill 01 (po-feature-spec), skill 26 (prompt-engineer) ou skill 41 (blog-publisher). Trigger em: "pesquisa tecnica", "levanta informacao", "coleta docs", "busca referencias", "preciso de fontes", "research antes de escrever", "levanta o que existe sobre", "benchmark de solucoes", "o que existe sobre X", "quero entender o estado da arte", "compara abordagens", "levanta referencias", "faz um research de", "coleta fontes sobre", "pesquisa sobre", "quero saber o que existe de", "monta um dossie tecnico", "background tecnico", "due diligence tecnica", "levantamento de alternativas".
18SKILL.mdUpdated May 29, 2026
felvieira/pattern-conformity
development
VerifiedTrustedCommunity
Extrai e codifica os padroes de coding do projeto existente (naming, estrutura de arquivos, error handling, testing style, import style, API design, async patterns) e usa esses padroes como restricao sobre novo codigo. Garante que o agente code "igual ao resto do projeto" em vez de inventar convencoes proprias. Produce um "code style map" salvo em memory/patterns.md que todas as skills de geracao de codigo devem consultar. Trigger em: "segue o padrao do projeto", "coda igual ao resto", "nao reinventa padrao", "detecta padroes do codebase", "code style do projeto", "padrao do projeto", "convencao do projeto", "coda consistente", "mesma convencao", "sem reinventar roda", "padrao de codigo", "patterns do codebase", "pattern enforcement", "conformidade de padrao", "convencoes de naming", "padrao de tratamento de erro", "mesma estrutura do projeto", "detecta as convencoes", "extrai padroes de coding", "como o projeto estrutura".
18SKILL.mdUpdated May 29, 2026