@luanpdd/kit-mcp 1.33.0 → 1.35.0

package/kit/agents/workflow-generator.md

@@ -0,0 +1,167 @@
+---
+name: workflow-generator
+tier: specialized
+description: Gera `.workflow.js` Dynamic Workflows sob demanda. 4 layers — Classify pattern (6 opcoes), Specify, Compose (reusa kit), Materialize em .claude/workflows/. Nada vai pro kit canonico.
+tools: Read, Write, Bash, Grep, Glob, AskUserQuestion, Task
+color: "#A855F7"
+---
+
+# workflow-generator
+
+Você é o gerador de workflows dinâmicos do kit-mcp. Recebe uma descrição livre do usuário (ex.: "auditar conversas IA no WhatsApp a cada 3min") e produz um `.claude/workflows/<slug>.workflow.js` + `.claude/commands/<slug>.md` no projeto do usuário. **Nunca** escreva no kit canônico — workflows gerados são locais ao projeto, jamais sincronizados pra cima.
+
+Você consulta:
+- [`dynamic-workflow-authoring`](../skills/dynamic-workflow-authoring/SKILL.md) — 6 patterns canônicos + regras duras da API Workflow
+- [`kit/workflows/auditar-observabilidade-cobertura.workflow.js`](../workflows/auditar-observabilidade-cobertura.workflow.js) — exemplo de referência (Fanout + Adversarial)
+- [`kit/agents/`](.) — lista completa dos agents que o gerado pode reusar via `opts.agentType`
+
+## Por que existe
+
+O kit não deve crescer com workflows de nicho. Crescer ele com a *capacidade* de gerar workflows sob demanda — cada usuário ganha o DELE, calibrado pro stack/dor que ele tem. A camada-0 obrigatória (classificar pattern) força escolha de design ANTES de gastar tokens.
+
+## Inputs esperados
+
+- `description` (livre) — o que o usuário quer auditar/automatizar
+- (opcional) `slug-suggestion` — se vazio, derive do description (kebab-case, ≤30 chars)
+- (opcional) `output-dir` — default `.claude/workflows/`
+
+## Workflow em 4 layers
+
+### Layer 0 — Classify (uma pergunta, seis opções)
+
+**SEMPRE** comece com `AskUserQuestion` apresentando os 6 patterns. NÃO infira o pattern do `description` — o usuário decide o trade-off. Mesmo que pareça óbvio.
+
+```
+Pergunta: "Qual padrão de harness encaixa neste caso?"
+Opções:
+  1. Classify-And-Act — roteamento por tipo (ticket triage, content moderation, PR routing)
+  2. Fanout-And-Synthesize — N itens similares em paralelo (audit Edge Functions, julgar conversas, processar currículos)
+  3. Adversarial-Verification — produzir + verificadores céticos (code review, fact-check, audit security)
+  4. Generate-And-Filter — gerar N candidatos, pegar top-K (brainstorm de nomes/designs, hipóteses)
+  5. Tournament — comparação pairwise progressiva (ranking qualitativo)
+  6. Loop-Until-Done — repete até parar (bug hunt, reproduzir flaky)
+```
+
+Se o caso é claramente HÍBRIDO (ex.: Fanout + Adversarial dentro), apresente como Fanout (o exoesqueleto) e codifique o Verify como stage interno. Não invente uma 7ª opção.
+
+### Layer 1 — Specify (perguntas específicas do pattern)
+
+Cada pattern tem 2–4 perguntas que MUDAM. Não pergunte tudo sempre — pergunte só o que aquele pattern precisa. Use `AskUserQuestion` por bloco coerente, max 4 opções por pergunta.
+
+**Classify-And-Act:**
+- Quais são os tipos canônicos? (lista enumerada)
+- Pra cada tipo, qual o output desejado?
+- Há um default "outros" pro classifier?
+
+**Fanout-And-Synthesize:**
+- Como obter os N itens? (SQL via mcp__supabase__execute_sql, glob de arquivos, lista fixa, args do usuário)
+- O que avaliar em CADA item? (lista de dimensões/schema)
+- Estrutura do report final? (markdown path, JSON, ambos)
+- Precisa de Verify stage anti-falso-positivo?
+
+**Adversarial-Verification:**
+- Quem é o "produtor"? (agent kit canônico via `agentType`, ou prompt custom)
+- Quantos verificadores? (default: 3)
+- Lentes diversas (correctness/security/perf) ou redundantes?
+- Quórum pra confirmar? (default: majority 2 de 3)
+
+**Generate-And-Filter:**
+- Quantos candidatos gerar? (N)
+- O prompt do generator varia por índice? (gera diversidade)
+- Qual a rubrica do filter? (critérios canônicos)
+- Top-K a manter? (default: 3)
+
+**Tournament:**
+- Métrica de comparação pairwise? (qual juiz, qual rubric)
+- Como construir o bracket inicial? (lista, SQL, glob)
+- Stop condition (vencedor único ou top-K)?
+
+**Loop-Until-Done:**
+- Stop condition (K rounds vazios? threshold? budget esgotado?)
+- Dedup key (que campo identifica um item já visto?)
+- Budget máximo se loop-until-budget?
+
+### Layer 2 — Compose (reusar kit)
+
+**Antes de escrever código novo**, identifique:
+
+1. **MCP tools necessárias** — grep no description por substantivos canônicos: "Supabase" → `mcp__supabase__*`, "GitHub" → `gh` via Bash, "Notion" → `mcp__notion-*`, etc.
+2. **Agents canônicos do kit reusáveis** — passe a lista de [`kit/agents/`](.) pelos olhos do description. Se houver match óbvio (ex.: descrição menciona "Edge Functions observability" → reuse `observability-coverage-auditor`), proponha via `AskUserQuestion`: "Detectei que o agent X já cobre essa fase. Quer reusar via `opts.agentType: 'X'`?"
+3. **Skills aplicáveis** — se o pattern é Fanout-And-Synthesize + tema é SRE/observability/multi-tenant, mencione no header do `.workflow.js` qual skill o usuário deveria abrir antes de executar (link relativo).
+
+### Layer 3 — Materialize (escrever os 2 arquivos)
+
+Gere `.claude/workflows/<slug>.workflow.js` seguindo o template do pattern escolhido. Regras DURAS (skill `dynamic-workflow-authoring` enumera):
+
+- `export const meta = { ... }` literal puro — sem template literals, sem function calls, sem spreads
+- TODO `agent()` com schema JSON (no minimum: `required: [...]`)
+- `pipeline()` é default; `parallel()` SÓ quando próximo stage precisa de todos os anteriores ao mesmo tempo
+- Sem `Date.now()`, `Math.random()`, `new Date()` argless — pra randomness varie por índice, pra timestamps passe via `args`
+- Compose com `workflow('outro-nome', args)` se a descrição menciona "fazer X depois fazer Y" (multi-fase) — mas nest > 1 throws
+- Cap de concorrência `min(16, cores−2)` — se a descrição pede "100 itens em paralelo", `log()` que só ~14 rodam ao mesmo tempo
+
+Gere `.claude/commands/<slug>.md` com:
+```yaml
+---
+name: <slug>
+description: <espelha o description do usuário, ≤200 bytes>
+argument-hint: "[--flag value] ..."
+allowed-tools: [Read, Bash, Write, Workflow, <MCP tools detectados>]
+---
+```
+Body do command: 1) parse `$ARGUMENTS` em bash, 2) disparar `Workflow({ name: '<slug>', args: { ... } })`, 3) pós-output curto.
+
+### Layer 4 — Deliver
+
+Resposta final ao usuário, formato fixo:
+
+```
+═══════════════════════════════════════════════════════════
+ workflow-generator ▸ <slug>
+═══════════════════════════════════════════════════════════
+
+Pattern:     <pattern escolhido>
+Reusa:       <agents canônicos do kit, se houver>
+MCP:         <tools requeridas, se houver>
+
+Arquivos:
+  .claude/workflows/<slug>.workflow.js   (<N> linhas)
+  .claude/commands/<slug>.md             (<M> linhas)
+
+Use agora:
+  /<slug> [--flags]
+
+Pra agendar a cada N min:
+  /loop 3m /<slug> [--flags]
+
+Pra agendar via cron remoto Anthropic:
+  /schedule "*/3 * * * *" <slug> [--flags]
+
+Quer que eu execute 1x agora pra validar? (y/n)
+```
+
+## Quando NÃO invocar
+
+- Descrição vaga demais ("automatize meu projeto") — devolva pedido de especificidade antes
+- Descrição que cabe em 1 slash-command existente (ex.: usuário pediu "auditar cobertura observability" → aponte `/auditar-observabilidade-cobertura-workflow`, não gere duplicata)
+- Pattern requisitado fora dos 6 canônicos — explique o trade-off e force escolha de um deles
+- Descrição requer write a `kit/` (canônico) — **recuse**. Workflows gerados são locais.
+
+## Garantias de output
+
+- [ ] `.workflow.js` parseável: passar `node -e "import('./caminho.js')"` sem erro de sintaxe
+- [ ] `meta` literal puro (sem expressões dinâmicas)
+- [ ] Todo `agent()` com schema declarado
+- [ ] Default `pipeline()` ou justificativa por que `parallel()` (no comentário inline)
+- [ ] Header `// kit-mcp:user-generated` no topo do `.workflow.js` (diferente do `// kit-mcp:reference` dos workflows do kit canônico — assim sync remove sabe não tocar)
+- [ ] Slash-command tem frontmatter válido + body com Workflow() call
+
+## Compat
+
+Full em Claude Code Max/Team/Enterprise (tool `Workflow` exigida). Cursor/Codex/Gemini/Copilot/Windsurf/Antigravity/Trae ainda não têm Dynamic Workflows — se invocado nesses, retorne erro explícito ("requires Claude Code Opus 4.8+ on Max/Team/Enterprise plan").
+
+## Ver também
+
+- [`dynamic-workflow-authoring`](../skills/dynamic-workflow-authoring/SKILL.md) (skill) — referência canônica que você consulta
+- [`criar-workflow`](../commands/criar-workflow.md) (command) — slash entrypoint que dispara você
+- [`auditar-observabilidade-cobertura.workflow.js`](../workflows/auditar-observabilidade-cobertura.workflow.js) — exemplo de Fanout-And-Synthesize que você pode usar como inspiração

package/kit/commands/adicionar-backlog.md

@@ -1,76 +1,76 @@
----
-name: adicionar-backlog
-description: Adiciona uma ideia ao estacionamento de backlog (numeração 999.x)
+---
+name: adicionar-backlog
+description: Adiciona uma ideia ao estacionamento de backlog (numeração 999.x)
 argument-hint: "<description>"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
----
-
-<objective>
-Adicionar um item de backlog ao roadmap usando a numeração 999.x. Itens de backlog são
-ideias não sequenciadas que não estão prontas para planejamento ativo — ficam fora
-da sequência normal de fases e acumulam contexto ao longo do tempo.
-</objective>
-
-<process>
-
-1. **Ler ROADMAP.md** para encontrar entradas de backlog existentes:
-   ```bash
-   cat .planning/ROADMAP.md
-   ```
-
-2. **Encontrar o próximo número de backlog:**
-   ```bash
-   NEXT=$(node "./.claude/framework/bin/tools.cjs" phase next-decimal 999 --raw)
-   ```
-   Se não existirem fases 999.x, começar em 999.1.
-
-3. **Criar o diretório da fase:**
-   ```bash
-   SLUG=$(node "./.claude/framework/bin/tools.cjs" generate-slug "$ARGUMENTS")
-   mkdir -p ".planning/phases/${NEXT}-${SLUG}"
-   touch ".planning/phases/${NEXT}-${SLUG}/.gitkeep"
-   ```
-
-4. **Adicionar ao ROADMAP.md** em uma seção `## Backlog`. Se a seção não existir, criar ao final:
-
-   ```markdown
-   ## Backlog
-
-   ### Fase {NEXT}: {descrição} (BACKLOG)
-
-   **Objetivo:** [Capturado para planejamento futuro]
-   **Requisitos:** A definir
-   **Planos:** 0 planos
-
-   Planos:
-   - [ ] A definir (promover com /revisar-backlog quando pronto)
-   ```
-
-5. **Commit:**
-   ```bash
-   node "./.claude/framework/bin/tools.cjs" commit "docs: adicionar item de backlog ${NEXT} — ${ARGUMENTS}" --files .planning/ROADMAP.md ".planning/phases/${NEXT}-${SLUG}/.gitkeep"
-   ```
-
-6. **Reportar:**
-   ```
-   ## 📋 Item de Backlog Adicionado
-
-   Fase {NEXT}: {descrição}
-   Diretório: .planning/phases/{NEXT}-{slug}/
-
-   Este item está no estacionamento de backlog.
-   Use /discutir-fase {NEXT} para explorá-lo melhor.
-   Use /revisar-backlog para promover itens ao milestone ativo.
-   ```
-
-</process>
-
-<notes>
-- A numeração 999.x mantém itens de backlog fora da sequência de fases ativas
-- Diretórios de fase são criados imediatamente, então /discutir-fase e /planejar-fase funcionam neles
-- Sem campo `Depends on:` — itens de backlog são não sequenciados por definição
-- Numeração esparsa é aceitável (999.1, 999.3) — sempre usa next-decimal
-</notes>
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Adicionar um item de backlog ao roadmap usando a numeração 999.x. Itens de backlog são
+ideias não sequenciadas que não estão prontas para planejamento ativo — ficam fora
+da sequência normal de fases e acumulam contexto ao longo do tempo.
+</objective>
+
+<process>
+
+1. **Ler ROADMAP.md** para encontrar entradas de backlog existentes:
+   ```bash
+   cat .planning/ROADMAP.md
+   ```
+
+2. **Encontrar o próximo número de backlog:**
+   ```bash
+   NEXT=$(node "./.claude/framework/bin/tools.cjs" phase next-decimal 999 --raw)
+   ```
+   Se não existirem fases 999.x, começar em 999.1.
+
+3. **Criar o diretório da fase:**
+   ```bash
+   SLUG=$(node "./.claude/framework/bin/tools.cjs" generate-slug "$ARGUMENTS")
+   mkdir -p ".planning/phases/${NEXT}-${SLUG}"
+   touch ".planning/phases/${NEXT}-${SLUG}/.gitkeep"
+   ```
+
+4. **Adicionar ao ROADMAP.md** em uma seção `## Backlog`. Se a seção não existir, criar ao final:
+
+   ```markdown
+   ## Backlog
+
+   ### Fase {NEXT}: {descrição} (BACKLOG)
+
+   **Objetivo:** [Capturado para planejamento futuro]
+   **Requisitos:** A definir
+   **Planos:** 0 planos
+
+   Planos:
+   - [ ] A definir (promover com /revisar-backlog quando pronto)
+   ```
+
+5. **Commit:**
+   ```bash
+   node "./.claude/framework/bin/tools.cjs" commit "docs: adicionar item de backlog ${NEXT} — ${ARGUMENTS}" --files .planning/ROADMAP.md ".planning/phases/${NEXT}-${SLUG}/.gitkeep"
+   ```
+
+6. **Reportar:**
+   ```
+   ## 📋 Item de Backlog Adicionado
+
+   Fase {NEXT}: {descrição}
+   Diretório: .planning/phases/{NEXT}-{slug}/
+
+   Este item está no estacionamento de backlog.
+   Use /discutir-fase {NEXT} para explorá-lo melhor.
+   Use /revisar-backlog para promover itens ao milestone ativo.
+   ```
+
+</process>
+
+<notes>
+- A numeração 999.x mantém itens de backlog fora da sequência de fases ativas
+- Diretórios de fase são criados imediatamente, então /discutir-fase e /planejar-fase funcionam neles
+- Sem campo `Depends on:` — itens de backlog são não sequenciados por definição
+- Numeração esparsa é aceitável (999.1, 999.3) — sempre usa next-decimal
+</notes>

package/kit/commands/adicionar-fase.md

@@ -1,43 +1,43 @@
----
-name: adicionar-fase
-description: Adiciona fase ao final do milestone atual no roadmap
+---
+name: adicionar-fase
+description: Adiciona fase ao final do milestone atual no roadmap
 argument-hint: "<description>"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
----
-
-<objective>
-Adiciona uma nova fase inteira ao final do milestone atual no roadmap.
-
-Encaminha para o workflow add-phase que cuida de:
-- Cálculo do número da fase (próximo inteiro sequencial)
-- Criação de diretório com geração de slug
-- Atualizações da estrutura do roadmap
-- Rastreamento de evolução do roadmap no STATE.md
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/add-phase.md
-</execution_context>
-
-<context>
-Argumentos: $ARGUMENTS (descrição da fase)
-
-Roadmap e estado são resolvidos no workflow via `init phase-op` e chamadas de ferramentas específicas.
-</context>
-
-<process>
-**Seguir o workflow add-phase** de `@./.claude/framework/workflows/add-phase.md`.
-
-O workflow cuida de toda a lógica, incluindo:
-1. Análise e validação dos argumentos
-2. Verificação de existência do roadmap
-3. Identificação do milestone atual
-4. Cálculo do próximo número de fase (ignorando decimais)
-5. Geração de slug a partir da descrição
-6. Criação do diretório da fase
-7. Inserção da entrada no roadmap
-8. Atualizações do STATE.md
-</process>
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Adiciona uma nova fase inteira ao final do milestone atual no roadmap.
+
+Encaminha para o workflow add-phase que cuida de:
+- Cálculo do número da fase (próximo inteiro sequencial)
+- Criação de diretório com geração de slug
+- Atualizações da estrutura do roadmap
+- Rastreamento de evolução do roadmap no STATE.md
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/add-phase.md
+</execution_context>
+
+<context>
+Argumentos: $ARGUMENTS (descrição da fase)
+
+Roadmap e estado são resolvidos no workflow via `init phase-op` e chamadas de ferramentas específicas.
+</context>
+
+<process>
+**Seguir o workflow add-phase** de `@./.claude/framework/workflows/add-phase.md`.
+
+O workflow cuida de toda a lógica, incluindo:
+1. Análise e validação dos argumentos
+2. Verificação de existência do roadmap
+3. Identificação do milestone atual
+4. Cálculo do próximo número de fase (ignorando decimais)
+5. Geração de slug a partir da descrição
+6. Criação do diretório da fase
+7. Inserção da entrada no roadmap
+8. Atualizações do STATE.md
+</process>

package/kit/commands/adicionar-tarefa.md

@@ -1,47 +1,47 @@
----
-name: adicionar-tarefa
-description: Captura ideia ou tarefa como todo a partir do contexto da conversa atual
+---
+name: adicionar-tarefa
+description: Captura ideia ou tarefa como todo a partir do contexto da conversa atual
 argument-hint: "[descrição opcional]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - AskUserQuestion
----
-
-<objective>
-Captura uma ideia, tarefa ou problema que surge durante uma sessão framework como um todo estruturado para trabalho posterior.
-
-Encaminha para o workflow add-todo que cuida de:
-- Criação da estrutura de diretórios
-- Extração de conteúdo dos argumentos ou da conversa
-- Inferência de área a partir dos caminhos de arquivo
-- Detecção e resolução de duplicatas
-- Criação do arquivo de todo com frontmatter
-- Atualizações do STATE.md
-- Commits Git
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/add-todo.md
-</execution_context>
-
-<context>
-Argumentos: $ARGUMENTS (descrição opcional do todo)
-
-Estado é resolvido no workflow via `init todos` e leituras específicas.
-</context>
-
-<process>
-**Seguir o workflow add-todo** de `@./.claude/framework/workflows/add-todo.md`.
-
-O workflow cuida de toda a lógica, incluindo:
-1. Garantia de diretórios
-2. Verificação de áreas existentes
-3. Extração de conteúdo (argumentos ou conversa)
-4. Inferência de área
-5. Verificação de duplicatas
-6. Criação de arquivo com geração de slug
-7. Atualizações do STATE.md
-8. Commits Git
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Captura uma ideia, tarefa ou problema que surge durante uma sessão framework como um todo estruturado para trabalho posterior.
+
+Encaminha para o workflow add-todo que cuida de:
+- Criação da estrutura de diretórios
+- Extração de conteúdo dos argumentos ou da conversa
+- Inferência de área a partir dos caminhos de arquivo
+- Detecção e resolução de duplicatas
+- Criação do arquivo de todo com frontmatter
+- Atualizações do STATE.md
+- Commits Git
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/add-todo.md
+</execution_context>
+
+<context>
+Argumentos: $ARGUMENTS (descrição opcional do todo)
+
+Estado é resolvido no workflow via `init todos` e leituras específicas.
+</context>
+
+<process>
+**Seguir o workflow add-todo** de `@./.claude/framework/workflows/add-todo.md`.
+
+O workflow cuida de toda a lógica, incluindo:
+1. Garantia de diretórios
+2. Verificação de áreas existentes
+3. Extração de conteúdo (argumentos ou conversa)
+4. Inferência de área
+5. Verificação de duplicatas
+6. Criação de arquivo com geração de slug
+7. Atualizações do STATE.md
+8. Commits Git
 </process>

package/kit/commands/adicionar-testes.md

@@ -1,41 +1,41 @@
----
-name: adicionar-testes
-description: Gera testes para uma fase concluída com base nos critérios de UAT e implementação
-argument-hint: "<phase> [instruções adicionais]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Glob
-  - Grep
-  - Task
-  - AskUserQuestion
-argument-instructions: |
-  Analise o argumento como um número de fase (inteiro, decimal ou sufixo de letra), mais instruções opcionais em texto livre.
-  Exemplo: /adicionar-testes 12
-  Exemplo: /adicionar-testes 12 focar nos casos extremos no módulo de precificação
----
-<objective>
-Gera testes unitários e E2E para uma fase concluída, usando seu SUMMARY.md, CONTEXT.md e VERIFICATION.md como especificações.
-
-Analisa os arquivos de implementação, classifica-os em categorias TDD (unitário), E2E (browser) ou Ignorar, apresenta um plano de testes para aprovação do usuário e gera os testes seguindo as convenções RED-GREEN.
-
-Saída: Arquivos de teste com commit da mensagem `test(phase-{N}): add unit and E2E tests from add-tests command`
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/add-tests.md
-</execution_context>
-
-<context>
-Fase: $ARGUMENTS
-
-@.planning/STATE.md
-@.planning/ROADMAP.md
-</context>
-
-<process>
-Execute o workflow add-tests de @./.claude/framework/workflows/add-tests.md do início ao fim.
-Preserve todos os checkpoints do workflow (aprovação de classificação, aprovação do plano de testes, verificação RED-GREEN, relatório de lacunas).
-</process>
+---
+name: adicionar-testes
+description: Gera testes para uma fase concluída com base nos critérios de UAT e implementação
+argument-hint: "<phase> [instruções adicionais]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+argument-instructions: |
+  Analise o argumento como um número de fase (inteiro, decimal ou sufixo de letra), mais instruções opcionais em texto livre.
+  Exemplo: /adicionar-testes 12
+  Exemplo: /adicionar-testes 12 focar nos casos extremos no módulo de precificação
+---
+<objective>
+Gera testes unitários e E2E para uma fase concluída, usando seu SUMMARY.md, CONTEXT.md e VERIFICATION.md como especificações.
+
+Analisa os arquivos de implementação, classifica-os em categorias TDD (unitário), E2E (browser) ou Ignorar, apresenta um plano de testes para aprovação do usuário e gera os testes seguindo as convenções RED-GREEN.
+
+Saída: Arquivos de teste com commit da mensagem `test(phase-{N}): add unit and E2E tests from add-tests command`
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/add-tests.md
+</execution_context>
+
+<context>
+Fase: $ARGUMENTS
+
+@.planning/STATE.md
+@.planning/ROADMAP.md
+</context>
+
+<process>
+Execute o workflow add-tests de @./.claude/framework/workflows/add-tests.md do início ao fim.
+Preserve todos os checkpoints do workflow (aprovação de classificação, aprovação do plano de testes, verificação RED-GREEN, relatório de lacunas).
+</process>

package/kit/commands/ajuda.md

@@ -1,22 +1,22 @@
----
-name: ajuda
-description: Mostra os comandos do framework disponíveis e o guia de uso
----
-<objective>
-Exibir a referência completa de comandos do framework.
-
-Exibir APENAS o conteúdo de referência abaixo. NÃO adicionar:
-- Análise específica do projeto
-- Status do git ou contexto de arquivo
-- Sugestões de próximos passos
-- Qualquer comentário além da referência
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/help.md
-</execution_context>
-
-<process>
-Exibir a referência completa de comandos do framework de @./.claude/framework/workflows/help.md.
-Exibir o conteúdo de referência diretamente — sem adições ou modificações.
+---
+name: ajuda
+description: Mostra os comandos do framework disponíveis e o guia de uso
+---
+<objective>
+Exibir a referência completa de comandos do framework.
+
+Exibir APENAS o conteúdo de referência abaixo. NÃO adicionar:
+- Análise específica do projeto
+- Status do git ou contexto de arquivo
+- Sugestões de próximos passos
+- Qualquer comentário além da referência
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/help.md
+</execution_context>
+
+<process>
+Exibir a referência completa de comandos do framework de @./.claude/framework/workflows/help.md.
+Exibir o conteúdo de referência diretamente — sem adições ou modificações.
 </process>