@luanpdd/kit-mcp 1.34.0 → 1.36.0

package/kit/commands/caracterizar-prompt.md

@@ -1,195 +1,195 @@
----
-name: caracterizar-prompt
-description: Characterization de prompts/tools LLM em produção — temperature=0 + seed fixo + sanitização específica. Trata prompts como código legacy. Modernização 2026 sem precedente em 2004.
-argument-hint: "<prompt_file> [--inputs-dir PATH] [--provider openai|anthropic] [--seed N] [--max-tokens N] [--num-intents N]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Grep
-  - Glob
-  - Task
----
-
-<objective>
-Caracterizar **prompt LLM ou tool definition** capturando outputs determinísticos como golden snapshots. Aplica skill [`ai-prompt-characterization`](../skills/ai-prompt-characterization/SKILL.md) — `temperature=0`, `seed` fixo, sanitização de timestamps/UUIDs/datas relativas, 5+ intents distintas. Trata prompt como **código legacy também** — versionado, testado, code-reviewed.
-
-**Cria/Atualiza:**
-- `tests/characterization/prompts/<prompt-stem>.test.ts` (ou `.py`/`.go` conforme runtime)
-- `tests/characterization/prompts/__snapshots__/<prompt-stem>.test.ts.snap`
-- `tests/characterization/prompts/<prompt-stem>/inputs/<intent>.json` — inputs canônicos por intent
-
-**Após:** mudança em prompt deve manter snapshot diff = 0 (ou mudança documentada). Detecta drift de model upstream automaticamente.
-</objective>
-
-<context>
-**Argumentos:**
-- `<prompt_file>` — arquivo do prompt (e.g., `prompts/generate-summary.md`) — OBRIGATÓRIO
-- `--inputs-dir <path>` — diretório com inputs canônicos por intent (default: agent gera 5 sintéticos cobrindo concise/detailed/code/edge/adversarial)
-- `--provider openai|anthropic` — provider de LLM (default: detecta via deps)
-- `--seed N` — seed para determinismo (default: 42)
-- `--max-tokens N` — limite output (default: 500)
-- `--num-intents N` — número de intents a cobrir (default: 5; mínimo: 5)
-- `--system-prompt <text>` — system prompt se aplicável
-
-**Exemplos:**
-```
-/caracterizar-prompt prompts/generate-summary.md
-/caracterizar-prompt prompts/code-reviewer.md --num-intents 7 --max-tokens 1000
-/caracterizar-prompt prompts/intent-classifier.md --inputs-dir test-data/classifier-intents
-/caracterizar-prompt prompts/customer-support.md --provider anthropic --seed 123
-```
-
-**Pré-requisitos:**
-- ANTHROPIC_API_KEY ou OPENAI_API_KEY em env
-- Test framework (Vitest, Jest, pytest, ...)
-- Provider escolhido suporta `temperature=0` + `seed`
-
-**Quando este comando é o caminho:**
-- Prompt em produção > 50 linhas
-- Mudanças em prompt quebraram silenciosamente no passado
-- Equipe quer baseline antes de refactor de prompt
-- CI deve detectar drift de model upstream (Claude 4.7 → 4.8)
-</context>
-
-<process>
-
-## 1. Parsear argumentos
-
-```bash
-PROMPT_FILE=$(echo "$ARGUMENTS" | awk '{print $1}')
-INPUTS_DIR=$(echo "$ARGUMENTS" | grep -oE -- '--inputs-dir [^ ]+' | awk '{print $2}')
-PROVIDER=$(echo "$ARGUMENTS" | grep -oE -- '--provider [^ ]+' | awk '{print $2}')
-SEED=$(echo "$ARGUMENTS" | grep -oE -- '--seed [0-9]+' | awk '{print $2}')
-MAX_TOKENS=$(echo "$ARGUMENTS" | grep -oE -- '--max-tokens [0-9]+' | awk '{print $2}')
-NUM_INTENTS=$(echo "$ARGUMENTS" | grep -oE -- '--num-intents [0-9]+' | awk '{print $2}')
-
-[ -z "$SEED" ]         && SEED=42
-[ -z "$MAX_TOKENS" ]   && MAX_TOKENS=500
-[ -z "$NUM_INTENTS" ]  && NUM_INTENTS=5
-
-if [ -z "$PROMPT_FILE" ]; then
-  echo "ERROR: prompt_file obrigatório"
-  exit 1
-fi
-
-if [ ! -f "$PROMPT_FILE" ]; then
-  echo "ERROR: arquivo não encontrado: $PROMPT_FILE"
-  exit 1
-fi
-```
-
-## 2. Detectar provider + framework
-
-```bash
-# auto-detect provider
-if [ -z "$PROVIDER" ]; then
-  if [ -n "$ANTHROPIC_API_KEY" ]; then
-    PROVIDER="anthropic"
-  elif [ -n "$OPENAI_API_KEY" ]; then
-    PROVIDER="openai"
-  else
-    echo "ERROR: nenhum provider detectado. Setar ANTHROPIC_API_KEY ou OPENAI_API_KEY"
-    exit 1
-  fi
-fi
-
-# detectar test framework
-FRAMEWORK=""
-if [ -f "package.json" ]; then
-  if jq -re '.devDependencies.vitest' package.json >/dev/null 2>&1; then FRAMEWORK="vitest"
-  elif jq -re '.devDependencies.jest' package.json >/dev/null 2>&1; then FRAMEWORK="jest"
-  fi
-elif [ -f "pyproject.toml" ]; then
-  FRAMEWORK="pytest"
-fi
-
-[ -z "$FRAMEWORK" ] && FRAMEWORK="vitest"  # default sane
-```
-
-## 3. Dispatch para `legacy-characterizer` (modo prompt)
-
-```text
-Task(
-  subagent_type="legacy-characterizer",
-  prompt="
-target_file: ${PROMPT_FILE}
-target_kind: prompt
-provider: ${PROVIDER}
-seed: ${SEED}
-max_tokens: ${MAX_TOKENS}
-num_intents: ${NUM_INTENTS}
-${INPUTS_DIR:+inputs_dir: ${INPUTS_DIR}}
-framework: ${FRAMEWORK}
-
-Aplicar skill ai-prompt-characterization. Etapas:
-1. Ler prompt + identificar inputs esperados (system prompt? user message format? tools?)
-2. Gerar (ou ler de inputs-dir) ${NUM_INTENTS}+ inputs cobrindo intents distintas:
-   - concise: pedido curto, output esperado curto
-   - detailed: pedido elaborado, output esperado longo
-   - code-heavy: input/output com código
-   - edge case: input ambíguo
-   - adversarial: prompt injection attempt
-3. Para cada intent: rodar LLM com temperature=0 + seed=${SEED}
-4. Capturar text + finishReason + toolCalls (se function calling) + inputTokens + outputTokens + modelVersion
-5. Sanitizar: timestamps, UUIDs, datas relativas, valores monetários, versões
-6. Salvar como snapshot tests usando ${FRAMEWORK}
-7. Cobertura behavioral = % intents cobertas (não % linhas)
-"
-)
-```
-
-## 4. Pós-output
-
-```
-═══════════════════════════════════════════════════════════
- framework ► CARACTERIZAR-PROMPT ▸ tests/characterization/prompts/...
-═══════════════════════════════════════════════════════════
-
-[output do legacy-characterizer em modo prompt]
-
-## ⚠ REVISÃO MANUAL OBRIGATÓRIA
-
-Snapshots gerados — leia cada um antes de commit:
-1. Verificar nenhum PII/secret persiste pós-sanitização
-2. Verificar nenhum timestamp/UUID/data relativa unredacted
-3. Confirmar finishReason esperado (stop vs length vs tool_use)
-4. Para tool_uses: confirmar tool name + input shape
-
-## Próximos passos
-
-1. **Revisar snapshots** manualmente
-2. **Rodar suite local:**
-   - JS/TS: `npm test -- tests/characterization/prompts`
-   - Python: `pytest tests/characterization/prompts`
-3. **Commit** como `chore: characterize <prompt-name>`
-4. **Configurar CI:**
-   - `tests/characterization/prompts/**` rodam em PR que toca `prompts/**`
-   - Diff vermelho = mudança comportamental detectada → review humano
-5. **Configurar nightly** para detectar drift de model upstream:
-   - Anthropic publica Claude 4.8 → re-run characterization → snapshot diff
-6. **Custo:** ~${NUM_INTENTS} × ($0.015/1k input tokens × 2k = $0.03 + output) ≈ $0.10-0.50/run
-
-## Cross-suite
-
-- **/caracterizar** (v1.12) — characterization de código (não prompt) — análogo
-- **`llm-as-dependency`** skill — fakear LLM em business logic tests (não esses tests)
-- **`legacy-api-only-applications`** skill — LLM provider é caso especial de API external
-- **/instrumentar-fase** (v1.9) — instrumenta consumer de prompt (latency, tokens)
-```
-
-</process>
-
-<success_criteria>
-- [ ] $ARGUMENTS parseados
-- [ ] Provider detectado automaticamente OU especificado
-- [ ] Framework de teste detectado
-- [ ] `legacy-characterizer` invocado em modo prompt
-- [ ] ≥ 5 intents cobrindo grupos canônicos (concise/detailed/code/edge/adversarial)
-- [ ] temperature=0 + seed=fixo aplicado
-- [ ] Sanitização específica para outputs LLM aplicada
-- [ ] Tests rodam contra LLM real apenas em characterization (não em business logic tests)
-- [ ] Próximos passos: review, commit, CI config, nightly drift detection
-- [ ] Cross-suite com llm-as-dependency e legacy-api-only-applications
-</success_criteria>
+---
+name: caracterizar-prompt
+description: Characterization de prompts/tools LLM em produção — temperature=0 + seed fixo + sanitização específica. Trata prompts como código legacy. Modernização 2026 sem precedente em 2004.
+argument-hint: "<prompt_file> [--inputs-dir PATH] [--provider openai|anthropic] [--seed N] [--max-tokens N] [--num-intents N]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Grep
+  - Glob
+  - Task
+---
+
+<objective>
+Caracterizar **prompt LLM ou tool definition** capturando outputs determinísticos como golden snapshots. Aplica skill [`ai-prompt-characterization`](../skills/ai-prompt-characterization/SKILL.md) — `temperature=0`, `seed` fixo, sanitização de timestamps/UUIDs/datas relativas, 5+ intents distintas. Trata prompt como **código legacy também** — versionado, testado, code-reviewed.
+
+**Cria/Atualiza:**
+- `tests/characterization/prompts/<prompt-stem>.test.ts` (ou `.py`/`.go` conforme runtime)
+- `tests/characterization/prompts/__snapshots__/<prompt-stem>.test.ts.snap`
+- `tests/characterization/prompts/<prompt-stem>/inputs/<intent>.json` — inputs canônicos por intent
+
+**Após:** mudança em prompt deve manter snapshot diff = 0 (ou mudança documentada). Detecta drift de model upstream automaticamente.
+</objective>
+
+<context>
+**Argumentos:**
+- `<prompt_file>` — arquivo do prompt (e.g., `prompts/generate-summary.md`) — OBRIGATÓRIO
+- `--inputs-dir <path>` — diretório com inputs canônicos por intent (default: agent gera 5 sintéticos cobrindo concise/detailed/code/edge/adversarial)
+- `--provider openai|anthropic` — provider de LLM (default: detecta via deps)
+- `--seed N` — seed para determinismo (default: 42)
+- `--max-tokens N` — limite output (default: 500)
+- `--num-intents N` — número de intents a cobrir (default: 5; mínimo: 5)
+- `--system-prompt <text>` — system prompt se aplicável
+
+**Exemplos:**
+```
+/caracterizar-prompt prompts/generate-summary.md
+/caracterizar-prompt prompts/code-reviewer.md --num-intents 7 --max-tokens 1000
+/caracterizar-prompt prompts/intent-classifier.md --inputs-dir test-data/classifier-intents
+/caracterizar-prompt prompts/customer-support.md --provider anthropic --seed 123
+```
+
+**Pré-requisitos:**
+- ANTHROPIC_API_KEY ou OPENAI_API_KEY em env
+- Test framework (Vitest, Jest, pytest, ...)
+- Provider escolhido suporta `temperature=0` + `seed`
+
+**Quando este comando é o caminho:**
+- Prompt em produção > 50 linhas
+- Mudanças em prompt quebraram silenciosamente no passado
+- Equipe quer baseline antes de refactor de prompt
+- CI deve detectar drift de model upstream (Claude 4.7 → 4.8)
+</context>
+
+<process>
+
+## 1. Parsear argumentos
+
+```bash
+PROMPT_FILE=$(echo "$ARGUMENTS" | awk '{print $1}')
+INPUTS_DIR=$(echo "$ARGUMENTS" | grep -oE -- '--inputs-dir [^ ]+' | awk '{print $2}')
+PROVIDER=$(echo "$ARGUMENTS" | grep -oE -- '--provider [^ ]+' | awk '{print $2}')
+SEED=$(echo "$ARGUMENTS" | grep -oE -- '--seed [0-9]+' | awk '{print $2}')
+MAX_TOKENS=$(echo "$ARGUMENTS" | grep -oE -- '--max-tokens [0-9]+' | awk '{print $2}')
+NUM_INTENTS=$(echo "$ARGUMENTS" | grep -oE -- '--num-intents [0-9]+' | awk '{print $2}')
+
+[ -z "$SEED" ]         && SEED=42
+[ -z "$MAX_TOKENS" ]   && MAX_TOKENS=500
+[ -z "$NUM_INTENTS" ]  && NUM_INTENTS=5
+
+if [ -z "$PROMPT_FILE" ]; then
+  echo "ERROR: prompt_file obrigatório"
+  exit 1
+fi
+
+if [ ! -f "$PROMPT_FILE" ]; then
+  echo "ERROR: arquivo não encontrado: $PROMPT_FILE"
+  exit 1
+fi
+```
+
+## 2. Detectar provider + framework
+
+```bash
+# auto-detect provider
+if [ -z "$PROVIDER" ]; then
+  if [ -n "$ANTHROPIC_API_KEY" ]; then
+    PROVIDER="anthropic"
+  elif [ -n "$OPENAI_API_KEY" ]; then
+    PROVIDER="openai"
+  else
+    echo "ERROR: nenhum provider detectado. Setar ANTHROPIC_API_KEY ou OPENAI_API_KEY"
+    exit 1
+  fi
+fi
+
+# detectar test framework
+FRAMEWORK=""
+if [ -f "package.json" ]; then
+  if jq -re '.devDependencies.vitest' package.json >/dev/null 2>&1; then FRAMEWORK="vitest"
+  elif jq -re '.devDependencies.jest' package.json >/dev/null 2>&1; then FRAMEWORK="jest"
+  fi
+elif [ -f "pyproject.toml" ]; then
+  FRAMEWORK="pytest"
+fi
+
+[ -z "$FRAMEWORK" ] && FRAMEWORK="vitest"  # default sane
+```
+
+## 3. Dispatch para `legacy-characterizer` (modo prompt)
+
+```text
+Task(
+  subagent_type="legacy-characterizer",
+  prompt="
+target_file: ${PROMPT_FILE}
+target_kind: prompt
+provider: ${PROVIDER}
+seed: ${SEED}
+max_tokens: ${MAX_TOKENS}
+num_intents: ${NUM_INTENTS}
+${INPUTS_DIR:+inputs_dir: ${INPUTS_DIR}}
+framework: ${FRAMEWORK}
+
+Aplicar skill ai-prompt-characterization. Etapas:
+1. Ler prompt + identificar inputs esperados (system prompt? user message format? tools?)
+2. Gerar (ou ler de inputs-dir) ${NUM_INTENTS}+ inputs cobrindo intents distintas:
+   - concise: pedido curto, output esperado curto
+   - detailed: pedido elaborado, output esperado longo
+   - code-heavy: input/output com código
+   - edge case: input ambíguo
+   - adversarial: prompt injection attempt
+3. Para cada intent: rodar LLM com temperature=0 + seed=${SEED}
+4. Capturar text + finishReason + toolCalls (se function calling) + inputTokens + outputTokens + modelVersion
+5. Sanitizar: timestamps, UUIDs, datas relativas, valores monetários, versões
+6. Salvar como snapshot tests usando ${FRAMEWORK}
+7. Cobertura behavioral = % intents cobertas (não % linhas)
+"
+)
+```
+
+## 4. Pós-output
+
+```
+═══════════════════════════════════════════════════════════
+ framework ► CARACTERIZAR-PROMPT ▸ tests/characterization/prompts/...
+═══════════════════════════════════════════════════════════
+
+[output do legacy-characterizer em modo prompt]
+
+## ⚠ REVISÃO MANUAL OBRIGATÓRIA
+
+Snapshots gerados — leia cada um antes de commit:
+1. Verificar nenhum PII/secret persiste pós-sanitização
+2. Verificar nenhum timestamp/UUID/data relativa unredacted
+3. Confirmar finishReason esperado (stop vs length vs tool_use)
+4. Para tool_uses: confirmar tool name + input shape
+
+## Próximos passos
+
+1. **Revisar snapshots** manualmente
+2. **Rodar suite local:**
+   - JS/TS: `npm test -- tests/characterization/prompts`
+   - Python: `pytest tests/characterization/prompts`
+3. **Commit** como `chore: characterize <prompt-name>`
+4. **Configurar CI:**
+   - `tests/characterization/prompts/**` rodam em PR que toca `prompts/**`
+   - Diff vermelho = mudança comportamental detectada → review humano
+5. **Configurar nightly** para detectar drift de model upstream:
+   - Anthropic publica Claude 4.8 → re-run characterization → snapshot diff
+6. **Custo:** ~${NUM_INTENTS} × ($0.015/1k input tokens × 2k = $0.03 + output) ≈ $0.10-0.50/run
+
+## Cross-suite
+
+- **/caracterizar** (v1.12) — characterization de código (não prompt) — análogo
+- **`llm-as-dependency`** skill — fakear LLM em business logic tests (não esses tests)
+- **`legacy-api-only-applications`** skill — LLM provider é caso especial de API external
+- **/instrumentar-fase** (v1.9) — instrumenta consumer de prompt (latency, tokens)
+```
+
+</process>
+
+<success_criteria>
+- [ ] $ARGUMENTS parseados
+- [ ] Provider detectado automaticamente OU especificado
+- [ ] Framework de teste detectado
+- [ ] `legacy-characterizer` invocado em modo prompt
+- [ ] ≥ 5 intents cobrindo grupos canônicos (concise/detailed/code/edge/adversarial)
+- [ ] temperature=0 + seed=fixo aplicado
+- [ ] Sanitização específica para outputs LLM aplicada
+- [ ] Tests rodam contra LLM real apenas em characterization (não em business logic tests)
+- [ ] Próximos passos: review, commit, CI config, nightly drift detection
+- [ ] Cross-suite com llm-as-dependency e legacy-api-only-applications
+</success_criteria>

package/kit/commands/criar-workflow.md

@@ -0,0 +1,158 @@
+---
+name: criar-workflow
+description: Gera um Dynamic Workflow customizado pro teu projeto. Pergunta o padrao de harness (6 opcoes), eliciaa params especificos, compoe reusando agents/skills do kit, materializa em .claude/workflows/.
+argument-hint: "<descricao livre em portugues do que voce quer auditar/automatizar>"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+  - AskUserQuestion
+  - Task
+---
+
+# criar-workflow
+
+> Entrypoint pra gerar um Dynamic Workflow customizado pro teu projeto. O kit não cresce com workflows de nicho — cresce com a capacidade de gerar workflows sob demanda.
+
+> Cada usuário ganha o DELE, calibrado pro stack/dor que ele tem. Outro usuário com necessidade diferente roda `/criar-workflow <sua descrição>` e ganha um diferente.
+
+<objective>
+Invoca o agent [`workflow-generator`](../agents/workflow-generator.md) que executa 4 layers:
+
+1. **Classify** — pergunta qual dos 6 patterns canônicos (Classify-Act, Fanout-Synthesize, Adversarial-Verify, Generate-Filter, Tournament, Loop-Done) encaixa
+2. **Specify** — faz 2-4 perguntas específicas do pattern escolhido
+3. **Compose** — detecta MCP necessárias + propõe reuso de agents canônicos do kit
+4. **Materialize** — escreve `.claude/workflows/<slug>.workflow.js` + `.claude/commands/<slug>.md` (locais ao projeto, NUNCA no kit canônico)
+
+**Cria:**
+- `.claude/workflows/<slug>.workflow.js` — script JS executável pela tool Workflow do Claude Code
+- `.claude/commands/<slug>.md` — slash-command que dispara o workflow
+
+**Após:** `/<slug> [--args]` invoca direto. Pra rodar a cada N minutos: `/loop 3m /<slug>`. Pra cron remoto: `/schedule "*/3 * * * *" <slug>`.
+</objective>
+
+<context>
+**Argumento:**
+- `$ARGUMENTS` — descrição livre em português do objetivo. Quanto mais específico, menos perguntas o gerador faz no Layer 1.
+
+**Exemplos:**
+```
+/criar-workflow auditar comportamento dos agentes IA atendendo WhatsApp 
+                a cada 3 minutos, analisar transcripts e gerar report
+
+/criar-workflow rankear top 10 PRs no GitHub abertos ha mais de 7 dias 
+                sem revisao por impacto
+
+/criar-workflow bug hunt continuo no codigo do servico de pagamento 
+                ate 2 rounds sem novos achados
+
+/criar-workflow brainstorm 12 nomes pra minha CLI e pegar top 3 por 
+                memorability + brand fit
+```
+
+**Pré-requisitos:**
+- Claude Code Max / Team / Enterprise (Dynamic Workflows em research preview Opus 4.8+)
+- Tool `Workflow` habilitada na sessão
+- `.claude/workflows/` existe ou sera criado
+
+**Quando NÃO usar:**
+- Tarefa cabe em 1 slash-command existente (ex.: ja temos `/auditar-observabilidade-cobertura-workflow` — não duplique)
+- Descrição vaga ("automatize meu projeto") — refine antes
+- Mudança que precisa entrar no kit canônico — esses são PRs no repo `luanpdd/kit-mcp`, não workflows locais
+</context>
+
+<process>
+
+## 1. Validar descrição mínima
+
+```bash
+DESC="$ARGUMENTS"
+if [ -z "$DESC" ] || [ ${#DESC} -lt 10 ]; then
+  echo "ERRO: descreva o que voce quer com pelo menos 10 chars."
+  echo "Exemplo: /criar-workflow auditar conversas IA no WhatsApp a cada 3min"
+  exit 1
+fi
+```
+
+## 2. Garantir destino existe
+
+```bash
+mkdir -p .claude/workflows .claude/commands
+```
+
+## 3. Dispatch para workflow-generator
+
+```text
+Task(
+  subagent_type="workflow-generator",
+  prompt="
+description: ${DESC}
+output_dir_workflows: .claude/workflows/
+output_dir_commands: .claude/commands/
+
+Execute os 4 layers conforme spec do agent:
+
+LAYER 0 — Classify (AskUserQuestion obrigatorio, 6 opcoes do pattern)
+LAYER 1 — Specify (perguntas especificas do pattern escolhido, 2-4 max)
+LAYER 2 — Compose (detectar MCP + propor reuso de agents do kit via AskUserQuestion)
+LAYER 3 — Materialize (.workflow.js + .md com header // kit-mcp:user-generated)
+LAYER 4 — Deliver (output formatado com slug, pattern, MCP, comandos /<slug>, /loop, /schedule)
+
+REGRAS DURAS:
+- meta literal puro (sem template literals, sem function calls, sem spread)
+- Todo agent() com schema JSON Schema declarado (required: [...])
+- pipeline() default, parallel() so com justificativa inline
+- Sem Date.now()/Math.random()/argless new Date() — pra randomness varie por indice, pra timestamps passe via args
+- Header // kit-mcp:user-generated no topo do .workflow.js (distingue de // kit-mcp:reference do canonico)
+
+NAO escreva em kit/ — workflows gerados sao locais.
+"
+)
+```
+
+## 4. Pós-output
+
+```
+═══════════════════════════════════════════════════════════
+ framework ► CRIAR-WORKFLOW ▸ <slug>
+═══════════════════════════════════════════════════════════
+
+[output do workflow-generator]
+
+## Como usar
+
+```
+/<slug> [--args ...]                       # 1 execucao
+/loop 3m /<slug> [--args ...]              # a cada 3min (dentro da sessao)
+/schedule "*/3 * * * *" <slug> [--args]    # cron remoto (24/7)
+```
+
+## Editar depois
+
+Se quiser ajustar:
+- `.claude/workflows/<slug>.workflow.js` — script do workflow
+- `.claude/commands/<slug>.md` — slash-command (interface + flags)
+
+A tool Workflow do Claude Code re-le o script a cada execucao — edit ja vale na proxima rodada.
+
+## Quando descontinuar
+
+Apaga os 2 arquivos. Sem efeito colateral (workflows user-generated nao entram no kit/file-manifest.json nem no kit-mcp sync).
+```
+
+</process>
+
+<success_criteria>
+- [ ] `$ARGUMENTS` validado (≥ 10 chars)
+- [ ] `.claude/workflows/` e `.claude/commands/` criados se ausentes
+- [ ] `workflow-generator` invocado via `Task()` com a descrição original
+- [ ] Layer 0 (classify pattern) com `AskUserQuestion` obrigatório — NUNCA infere
+- [ ] Layer 1 (specify) com perguntas específicas DO PADRÃO ESCOLHIDO — não pergunta tudo sempre
+- [ ] Layer 2 (compose) propõe reuso de agents canônicos quando match óbvio
+- [ ] Layer 3 (materialize) escreve 2 arquivos com headers corretos
+- [ ] Layer 4 (deliver) output com `/<slug>`, `/loop`, `/schedule` formatados
+- [ ] Workflow gerado parseável (`node -c` syntax check)
+- [ ] Nenhum arquivo escrito em `kit/` (canônico) — só em `.claude/`
+</success_criteria>

package/kit/commands/definir-perfil.md

@@ -1,7 +1,7 @@
 ---
 name: definir-perfil
 description: Altera o perfil de modelo para os agentes framework (quality/balanced/budget/inherit)
-argument-hint: "<perfil (quality|balanced|budget|inherit)>"
+argument-hint: "<perfil (quality|balanced|budget|inherit)>"
 model: haiku
 allowed-tools:
   - Bash