# Program Router

> |

- **Type:** Skill
- **Install:** `agentstack add skill-felvieira-claude-skills-fv-39-program-router`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [felvieira](https://agentstack.voostack.com/s/felvieira)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [felvieira](https://github.com/felvieira)
- **Source:** https://github.com/felvieira/claude-skills-fv/tree/main/skills/39-program-router

## Install

```sh
agentstack add skill-felvieira-claude-skills-fv-39-program-router
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:
```bash
node scripts/run-program.mjs --list
```

Inspecionar program específico antes de propor:
```bash
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](https://github.com/felvieira)
- **Source:** [felvieira/claude-skills-fv](https://github.com/felvieira/claude-skills-fv)
- **License:** Apache-2.0

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-felvieira-claude-skills-fv-39-program-router
- Seller: https://agentstack.voostack.com/s/felvieira
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.