Program Router

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

1. Usuário invocou /run-program explícito → rodar exatamente isso. Skill não interfere.
2. Hook intent-classifier sugeriu program e usuário concordou → essa skill confirma e dispatcha.
3. Hook não sugeriu mas task parece grande/estruturada → essa skill classifica e propõe.
4. 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-program explí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á additionalContext do hook intent-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:

1. Constitution força pipeline? — Ler memory/constitution.md. Se declara "todo feature passa por spec-driven-development", forçar.
2. Task tipo "build greenfield" — sinais: "from scratch", repo vazio, sem ADRs → adversarial-dev
3. Task tipo "feature em projeto existente" — sinais: ADRs presentes, codebase > 100 files, palavras "feature" + "criar" → spec-driven-development
4. Task tipo "ideia vaga" — sinais: "não sei", "talvez", ` porque .

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":**
```bash
node scripts/run-program.mjs  --dry-run --input key=value

Apresentar plano resolvido. Esperar nova confirmação.

Se "direto": Invocar /run-program 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 — 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 

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: felvieira
• Source: felvieira/claude-skills-fv
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.