@luanpdd/kit-mcp 1.21.0 → 1.22.0

package/kit/commands/discutir-fase.md

@@ -1,131 +1,131 @@
----
-name: discutir-fase
-description: Reúne contexto da fase por questionamento adaptativo antes do planejamento. Use --auto para pular perguntas interativas (Claude escolhe os padrões recomendados).
-argument-hint: "<phase> [--auto] [--batch] [--analyze] [--text]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
-  - AskUserQuestion
-  - Task
-  - mcp__context7__resolve-library-id
-  - mcp__context7__query-docs
----
-
-<objective>
-Extrair decisões de implementação que os agentes subsequentes precisam — o pesquisador e o planejador usarão o CONTEXT.md para saber o que investigar e quais escolhas estão travadas.
-
-**Como funciona:**
-1. Carregar contexto anterior (PROJECT.md, REQUIREMENTS.md, STATE.md, arquivos CONTEXT.md anteriores)
-2. Explorar base de código em busca de recursos e padrões reutilizáveis
-3. Analisar a fase — pular áreas cinzentas já decididas em fases anteriores
-4. Apresentar áreas cinzentas restantes — usuário seleciona quais discutir
-5. Aprofundar cada área selecionada até satisfação
-6. Criar CONTEXT.md com decisões que guiam pesquisa e planejamento
-
-**Saída:** `{phase_num}-CONTEXT.md` — decisões claras o suficiente para que agentes subsequentes possam agir sem perguntar ao usuário novamente
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/discuss-phase.md
-@./.claude/framework/workflows/discuss-phase-assumptions.md
-@./.claude/framework/templates/context.md
-</execution_context>
-
-<context>
-Número da fase: $ARGUMENTS (obrigatório)
-
-Arquivos de contexto são resolvidos no workflow usando `init phase-op` e chamadas de ferramentas de roadmap/estado.
-</context>
-
-<process>
-**Roteamento de modo:**
-```bash
-DISCUSS_MODE=$(node "./.claude/framework/bin/tools.cjs" config-get workflow.discuss_mode 2>/dev/null || echo "discuss")
-```
-
-Se `DISCUSS_MODE` for `"assumptions"`: Ler e executar @./.claude/framework/workflows/discuss-phase-assumptions.md do início ao fim.
-
-Se `DISCUSS_MODE` for `"discuss"` (ou não definido, ou qualquer outro valor): Ler e executar @./.claude/framework/workflows/discuss-phase.md do início ao fim.
-
-**OBRIGATÓRIO:** Os arquivos execution_context listados acima SÃO as instruções. Ler o arquivo de workflow ANTES de tomar qualquer ação. As seções de objective e success_criteria neste arquivo de comando são resumos — o arquivo de workflow contém o processo completo passo a passo com todos os comportamentos obrigatórios, verificações de configuração e padrões de interação. Não improvisar a partir do resumo.
-</process>
-
-<success_criteria>
-- Contexto anterior carregado e aplicado (sem re-perguntar questões já decididas)
-- Áreas cinzentas identificadas através de análise inteligente
-- Usuário escolheu quais áreas discutir
-- Cada área selecionada explorada até satisfação
-- Expansão de escopo redirecionada para ideias adiadas
-- CONTEXT.md captura decisões, não visão vaga
-- Usuário conhece os próximos passos
-</success_criteria>
-
-<observability_integration>
-**Integração com Observability-Driven Development (v1.9):**
-
-Quando o workflow.observability_phase_questions = true (default), o workflow inclui pergunta canônica de ODD na sessão de discussão:
-
-> "Quais SLIs essa fase impacta? O que precisa ser instrumentado para responder às 4 perguntas pré-PR?"
-
-A pergunta é resolvida consultando a skill [`observability-driven-development`](../skills/observability-driven-development/SKILL.md) e o resultado é registrado na seção `<observability>` do CONTEXT.md gerado:
-
-```markdown
-<observability>
-## SLIs impactados
-- [SLI ou "nenhum — fase puramente interna"]
-
-## Instrumentação necessária
-- Spans novos: [lista]
-- Atributos canônicos: [user.id, tenant_id, ...]
-- error.type enum esperado: [validation, timeout, ...]
-</observability>
-```
-
-O `plan-checker` invocado pelo `/planejar-fase` (Phase 33 — INT-FW-02) lê esta seção e bloqueia o plano se ODD ausente para fases voltadas ao usuário (skip silenciosamente para fases de infraestrutura — ver detecção em `discuss-phase.md`).
-
-**REQ:** INT-FW-01.
-</observability_integration>
-
-<legacy_refactor_integration>
-**Integração com Suíte Legacy Code (Feathers):**
-
-Quando o workflow detecta intent de **refactor** (palavras-chave em descrição da fase: "refator", "refactor", "extrair", "limpar", "reorganizar", "split", "quebrar classe/módulo"), inclui pergunta canônica:
-
-> "Esta fase envolve refactor de arquivo existente? Se sim, qual é o arquivo alvo?"
-
-Para cada arquivo identificado:
-1. Coleta line count + checa se path matches contrato externo (supabase/functions, src/api, webhooks, pages/api)
-2. Invoca [`refactor-safety-auditor`](../agents/refactor-safety-auditor.md) **em modo dry-run** para coletar evidências sem bloquear
-3. Resultado registrado em CONTEXT.md em seção `<refactor_safety>`:
-
-```markdown
-<refactor_safety>
-## Arquivos alvo de refactor
-
-| Arquivo | Linhas | Contrato externo | Cobertura | Char tests | Veredito do gate |
-|---|---|---|---|---|---|
-| src/orders/handler.ts | 724 | true | 12% | absent | BLOCK |
-| src/orders/utils.ts | 89 | false | 78% | absent | GO |
-
-## Recomendação
-
-Para `src/orders/handler.ts`:
-  - Caminho preferido: /caracterizar antes de refactor (custo: 8-16h)
-  - Alternativa: /refactor-seguro --mode=sprout (se mudança ADICIONA, não modifica)
-  - Para safe-extract: assinar checklist canônico de safe extraction
-  - Override possível com ticket + reason
-
-Para `src/orders/utils.ts`:
-  - Refactor pode prosseguir; cobertura adequada existe.
-</refactor_safety>
-```
-
-`plan-checker` consume essa seção. Se gate retorna BLOCK e mode=blocking, plano não é aprovado até user escolher caminho explícito.
-
-**Skill canônica:** [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md)
-
-**Quando skip:** fase puramente de infraestrutura (markdown, config, tooling), fase greenfield (sem arquivos existentes a modificar), OR `workflow.legacy_refactor_questions=false` em config.
-</legacy_refactor_integration>
+---
+name: discutir-fase
+description: Reúne contexto da fase por questionamento adaptativo antes do planejamento. Use --auto para pular perguntas interativas (Claude escolhe os padrões recomendados).
+argument-hint: "<phase> [--auto] [--batch] [--analyze] [--text]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+  - Task
+  - mcp__context7__resolve-library-id
+  - mcp__context7__query-docs
+---
+
+<objective>
+Extrair decisões de implementação que os agentes subsequentes precisam — o pesquisador e o planejador usarão o CONTEXT.md para saber o que investigar e quais escolhas estão travadas.
+
+**Como funciona:**
+1. Carregar contexto anterior (PROJECT.md, REQUIREMENTS.md, STATE.md, arquivos CONTEXT.md anteriores)
+2. Explorar base de código em busca de recursos e padrões reutilizáveis
+3. Analisar a fase — pular áreas cinzentas já decididas em fases anteriores
+4. Apresentar áreas cinzentas restantes — usuário seleciona quais discutir
+5. Aprofundar cada área selecionada até satisfação
+6. Criar CONTEXT.md com decisões que guiam pesquisa e planejamento
+
+**Saída:** `{phase_num}-CONTEXT.md` — decisões claras o suficiente para que agentes subsequentes possam agir sem perguntar ao usuário novamente
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/discuss-phase.md
+@./.claude/framework/workflows/discuss-phase-assumptions.md
+@./.claude/framework/templates/context.md
+</execution_context>
+
+<context>
+Número da fase: $ARGUMENTS (obrigatório)
+
+Arquivos de contexto são resolvidos no workflow usando `init phase-op` e chamadas de ferramentas de roadmap/estado.
+</context>
+
+<process>
+**Roteamento de modo:**
+```bash
+DISCUSS_MODE=$(node "./.claude/framework/bin/tools.cjs" config-get workflow.discuss_mode 2>/dev/null || echo "discuss")
+```
+
+Se `DISCUSS_MODE` for `"assumptions"`: Ler e executar @./.claude/framework/workflows/discuss-phase-assumptions.md do início ao fim.
+
+Se `DISCUSS_MODE` for `"discuss"` (ou não definido, ou qualquer outro valor): Ler e executar @./.claude/framework/workflows/discuss-phase.md do início ao fim.
+
+**OBRIGATÓRIO:** Os arquivos execution_context listados acima SÃO as instruções. Ler o arquivo de workflow ANTES de tomar qualquer ação. As seções de objective e success_criteria neste arquivo de comando são resumos — o arquivo de workflow contém o processo completo passo a passo com todos os comportamentos obrigatórios, verificações de configuração e padrões de interação. Não improvisar a partir do resumo.
+</process>
+
+<success_criteria>
+- Contexto anterior carregado e aplicado (sem re-perguntar questões já decididas)
+- Áreas cinzentas identificadas através de análise inteligente
+- Usuário escolheu quais áreas discutir
+- Cada área selecionada explorada até satisfação
+- Expansão de escopo redirecionada para ideias adiadas
+- CONTEXT.md captura decisões, não visão vaga
+- Usuário conhece os próximos passos
+</success_criteria>
+
+<observability_integration>
+**Integração com Observability-Driven Development (v1.9):**
+
+Quando o workflow.observability_phase_questions = true (default), o workflow inclui pergunta canônica de ODD na sessão de discussão:
+
+> "Quais SLIs essa fase impacta? O que precisa ser instrumentado para responder às 4 perguntas pré-PR?"
+
+A pergunta é resolvida consultando a skill [`observability-driven-development`](../skills/observability-driven-development/SKILL.md) e o resultado é registrado na seção `<observability>` do CONTEXT.md gerado:
+
+```markdown
+<observability>
+## SLIs impactados
+- [SLI ou "nenhum — fase puramente interna"]
+
+## Instrumentação necessária
+- Spans novos: [lista]
+- Atributos canônicos: [user.id, tenant_id, ...]
+- error.type enum esperado: [validation, timeout, ...]
+</observability>
+```
+
+O `plan-checker` invocado pelo `/planejar-fase` (Phase 33 — INT-FW-02) lê esta seção e bloqueia o plano se ODD ausente para fases voltadas ao usuário (skip silenciosamente para fases de infraestrutura — ver detecção em `discuss-phase.md`).
+
+**REQ:** INT-FW-01.
+</observability_integration>
+
+<legacy_refactor_integration>
+**Integração com Suíte Legacy Code (Feathers):**
+
+Quando o workflow detecta intent de **refactor** (palavras-chave em descrição da fase: "refator", "refactor", "extrair", "limpar", "reorganizar", "split", "quebrar classe/módulo"), inclui pergunta canônica:
+
+> "Esta fase envolve refactor de arquivo existente? Se sim, qual é o arquivo alvo?"
+
+Para cada arquivo identificado:
+1. Coleta line count + checa se path matches contrato externo (supabase/functions, src/api, webhooks, pages/api)
+2. Invoca [`refactor-safety-auditor`](../agents/refactor-safety-auditor.md) **em modo dry-run** para coletar evidências sem bloquear
+3. Resultado registrado em CONTEXT.md em seção `<refactor_safety>`:
+
+```markdown
+<refactor_safety>
+## Arquivos alvo de refactor
+
+| Arquivo | Linhas | Contrato externo | Cobertura | Char tests | Veredito do gate |
+|---|---|---|---|---|---|
+| src/orders/handler.ts | 724 | true | 12% | absent | BLOCK |
+| src/orders/utils.ts | 89 | false | 78% | absent | GO |
+
+## Recomendação
+
+Para `src/orders/handler.ts`:
+  - Caminho preferido: /caracterizar antes de refactor (custo: 8-16h)
+  - Alternativa: /refactor-seguro --mode=sprout (se mudança ADICIONA, não modifica)
+  - Para safe-extract: assinar checklist canônico de safe extraction
+  - Override possível com ticket + reason
+
+Para `src/orders/utils.ts`:
+  - Refactor pode prosseguir; cobertura adequada existe.
+</refactor_safety>
+```
+
+`plan-checker` consume essa seção. Se gate retorna BLOCK e mode=blocking, plano não é aprovado até user escolher caminho explícito.
+
+**Skill canônica:** [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md)
+
+**Quando skip:** fase puramente de infraestrutura (markdown, config, tooling), fase greenfield (sem arquivos existentes a modificar), OR `workflow.legacy_refactor_questions=false` em config.
+</legacy_refactor_integration>

package/kit/commands/entrar-discord.md

@@ -1,18 +1,18 @@
----
-name: entrar-discord
-description: Entrar na comunidade framework no Discord
----
-
-<objective>
-Exibir o link de convite para o servidor da comunidade framework no Discord.
-</objective>
-
-<output>
-# Entre no Discord do framework
-
-Conecte-se com outros usuários do framework, obtenha ajuda, compartilhe o que está criando e fique atualizado.
-
-**Link de convite:** https://discord.gg/framework
-
-Clique no link ou cole-o no seu navegador para entrar.
+---
+name: entrar-discord
+description: Entrar na comunidade framework no Discord
+---
+
+<objective>
+Exibir o link de convite para o servidor da comunidade framework no Discord.
+</objective>
+
+<output>
+# Entre no Discord do framework
+
+Conecte-se com outros usuários do framework, obtenha ajuda, compartilhe o que está criando e fique atualizado.
+
+**Link de convite:** https://discord.gg/framework
+
+Clique no link ou cole-o no seu navegador para entrar.
 </output>

package/kit/commands/estatisticas.md

@@ -1,18 +1,18 @@
----
-name: estatisticas
-description: Exibe estatísticas do projeto — fases, planos, requisitos, métricas git e linha do tempo
-allowed-tools:
-  - Read
-  - Bash
----
-<objective>
-Exibe estatísticas abrangentes do projeto incluindo progresso de fases, métricas de execução de planos, conclusão de requisitos, estatísticas de histórico git e linha do tempo do projeto.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/stats.md
-</execution_context>
-
-<process>
-Execute o workflow stats de @./.claude/framework/workflows/stats.md do início ao fim.
-</process>
+---
+name: estatisticas
+description: Exibe estatísticas do projeto — fases, planos, requisitos, métricas git e linha do tempo
+allowed-tools:
+  - Read
+  - Bash
+---
+<objective>
+Exibe estatísticas abrangentes do projeto incluindo progresso de fases, métricas de execução de planos, conclusão de requisitos, estatísticas de histórico git e linha do tempo do projeto.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/stats.md
+</execution_context>
+
+<process>
+Execute o workflow stats de @./.claude/framework/workflows/stats.md do início ao fim.
+</process>

package/kit/commands/example-greeting.md

@@ -1,33 +1,33 @@
----
-name: example-greeting
-description: Example slash-command template. Replace with your own. Greets the user and shows what kit-mcp can do.
-argument-hint: "[name]"
-allowed-tools:
-  - Bash
----
-
-# /example-greeting
-
-Greet the user (by name if provided) and print a one-line summary of what
-kit-mcp does.
-
-## Process
-
-1. Parse `$ARGUMENTS` for an optional name.
-2. Print:
-   ```
-   Hello <name>! kit-mcp is ready.
-   <one-line summary of the kit's purpose>
-   ```
-3. Optionally, run `kit kit list-agents | head -3` so the user sees what's
-   available.
-
-## Notes
-
-This is a minimal template. Real commands typically:
-- Read STATE.md or other artifacts
-- Spawn sub-agents via `Task(subagent_type=...)`
-- Update files and commit
-- Route to a downstream command
-
-See the kit-mcp README for command authoring patterns.
+---
+name: example-greeting
+description: Example slash-command template. Replace with your own. Greets the user and shows what kit-mcp can do.
+argument-hint: "[name]"
+allowed-tools:
+  - Bash
+---
+
+# /example-greeting
+
+Greet the user (by name if provided) and print a one-line summary of what
+kit-mcp does.
+
+## Process
+
+1. Parse `$ARGUMENTS` for an optional name.
+2. Print:
+   ```
+   Hello <name>! kit-mcp is ready.
+   <one-line summary of the kit's purpose>
+   ```
+3. Optionally, run `kit kit list-agents | head -3` so the user sees what's
+   available.
+
+## Notes
+
+This is a minimal template. Real commands typically:
+- Read STATE.md or other artifacts
+- Spawn sub-agents via `Task(subagent_type=...)`
+- Update files and commit
+- Route to a downstream command
+
+See the kit-mcp README for command authoring patterns.

package/kit/commands/executar-fase.md

@@ -1,59 +1,59 @@
----
-name: executar-fase
-description: Executa todos os planos de uma fase com paralelização por ondas
-argument-hint: "<phase-number> [--wave N] [--gaps-only] [--interactive]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Glob
-  - Grep
-  - Bash
-  - Task
-  - TodoWrite
-  - AskUserQuestion
----
-<objective>
-Executa todos os planos de uma fase usando execução paralela por ondas.
-
-O orquestrador se mantém enxuto: descobrir planos, analisar dependências, agrupar em ondas, invocar subagentes, coletar resultados. Cada subagente carrega o contexto completo de execute-plan e cuida do seu próprio plano.
-
-Filtro de onda opcional:
-- `--wave N` executa apenas a Onda `N` para controle de ritmo, gestão de cota ou lançamento em etapas
-- verificação/conclusão da fase ainda ocorre apenas quando não há planos incompletos restantes após a onda selecionada terminar
-
-Regra de tratamento de flags:
-- As flags opcionais documentadas abaixo são comportamentos disponíveis, não comportamentos ativos implícitos
-- Uma flag está ativa apenas quando seu token literal aparece em `$ARGUMENTS`
-- Se uma flag documentada estiver ausente de `$ARGUMENTS`, trate-a como inativa
-
-Orçamento de contexto: ~15% orquestrador, 100% fresco por subagente.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/execute-phase.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<context>
-Fase: $ARGUMENTS
-
-**Flags opcionais disponíveis (somente documentação — não automaticamente ativas):**
-- `--wave N` — Executar apenas a Onda `N` na fase. Use quando quiser controlar o ritmo da execução ou ficar dentro dos limites de uso.
-- `--gaps-only` — Executar apenas planos de fechamento de lacunas (planos com `gap_closure: true` no frontmatter). Use após verify-work criar planos de correção.
-- `--interactive` — Executar planos sequencialmente inline (sem subagentes) com checkpoints de usuário entre tarefas. Menor uso de tokens, estilo programação em par. Melhor para fases pequenas, correções de bugs e lacunas de verificação.
-
-**Flags ativas devem ser derivadas de `$ARGUMENTS`:**
-- `--wave N` está ativa somente se o token literal `--wave` estiver presente em `$ARGUMENTS`
-- `--gaps-only` está ativa somente se o token literal `--gaps-only` estiver presente em `$ARGUMENTS`
-- `--interactive` está ativa somente se o token literal `--interactive` estiver presente em `$ARGUMENTS`
-- Se nenhum desses tokens aparecer, executar o fluxo padrão de execução completa da fase sem filtragem específica de flag
-- Não inferir que uma flag está ativa apenas porque está documentada neste prompt
-
-Arquivos de contexto são resolvidos dentro do workflow via `tools init execute-phase` e blocos `<files_to_read>` por subagente.
-</context>
-
-<process>
-Execute o workflow execute-phase de @./.claude/framework/workflows/execute-phase.md do início ao fim.
-Preserve todos os checkpoints do workflow (execução de ondas, tratamento de checkpoints, verificação, atualizações de estado, roteamento).
+---
+name: executar-fase
+description: Executa todos os planos de uma fase com paralelização por ondas
+argument-hint: "<phase-number> [--wave N] [--gaps-only] [--interactive]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - TodoWrite
+  - AskUserQuestion
+---
+<objective>
+Executa todos os planos de uma fase usando execução paralela por ondas.
+
+O orquestrador se mantém enxuto: descobrir planos, analisar dependências, agrupar em ondas, invocar subagentes, coletar resultados. Cada subagente carrega o contexto completo de execute-plan e cuida do seu próprio plano.
+
+Filtro de onda opcional:
+- `--wave N` executa apenas a Onda `N` para controle de ritmo, gestão de cota ou lançamento em etapas
+- verificação/conclusão da fase ainda ocorre apenas quando não há planos incompletos restantes após a onda selecionada terminar
+
+Regra de tratamento de flags:
+- As flags opcionais documentadas abaixo são comportamentos disponíveis, não comportamentos ativos implícitos
+- Uma flag está ativa apenas quando seu token literal aparece em `$ARGUMENTS`
+- Se uma flag documentada estiver ausente de `$ARGUMENTS`, trate-a como inativa
+
+Orçamento de contexto: ~15% orquestrador, 100% fresco por subagente.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/execute-phase.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Fase: $ARGUMENTS
+
+**Flags opcionais disponíveis (somente documentação — não automaticamente ativas):**
+- `--wave N` — Executar apenas a Onda `N` na fase. Use quando quiser controlar o ritmo da execução ou ficar dentro dos limites de uso.
+- `--gaps-only` — Executar apenas planos de fechamento de lacunas (planos com `gap_closure: true` no frontmatter). Use após verify-work criar planos de correção.
+- `--interactive` — Executar planos sequencialmente inline (sem subagentes) com checkpoints de usuário entre tarefas. Menor uso de tokens, estilo programação em par. Melhor para fases pequenas, correções de bugs e lacunas de verificação.
+
+**Flags ativas devem ser derivadas de `$ARGUMENTS`:**
+- `--wave N` está ativa somente se o token literal `--wave` estiver presente em `$ARGUMENTS`
+- `--gaps-only` está ativa somente se o token literal `--gaps-only` estiver presente em `$ARGUMENTS`
+- `--interactive` está ativa somente se o token literal `--interactive` estiver presente em `$ARGUMENTS`
+- Se nenhum desses tokens aparecer, executar o fluxo padrão de execução completa da fase sem filtragem específica de flag
+- Não inferir que uma flag está ativa apenas porque está documentada neste prompt
+
+Arquivos de contexto são resolvidos dentro do workflow via `tools init execute-phase` e blocos `<files_to_read>` por subagente.
+</context>
+
+<process>
+Execute o workflow execute-phase de @./.claude/framework/workflows/execute-phase.md do início ao fim.
+Preserve todos os checkpoints do workflow (execução de ondas, tratamento de checkpoints, verificação, atualizações de estado, roteamento).
 </process>

package/kit/commands/expresso.md

@@ -1,56 +1,56 @@
----
-name: expresso
-description: Executa uma tarefa rápida com garantias framework (commits atômicos, rastreamento de estado) mas pula agentes opcionais
-argument-hint: "[--full] [--discuss] [--research]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Glob
-  - Grep
-  - Bash
-  - Task
-  - AskUserQuestion
----
-<objective>
-Executar tarefas pequenas e ad-hoc com garantias framework (commits atômicos, rastreamento no STATE.md).
-
-Modo expresso é o mesmo sistema com um caminho mais curto:
-- Invoca planner (modo rápido) + executor(s)
-- Tarefas expressas ficam em `.planning/quick/` separado das fases planejadas
-- Atualiza tabela "Quick Tasks Completed" do STATE.md (NÃO ROADMAP.md)
-
-**Padrão:** Pula pesquisa, discussão, plan-checker, verificador. Use quando você sabe exatamente o que fazer.
-
-**Flag `--discuss`:** Fase de discussão leve antes do planejamento. Apresenta hipóteses, esclarece áreas cinzentas, captura decisões em CONTEXT.md. Use quando a tarefa tem ambiguidade que vale a pena resolver antecipadamente.
-
-**Flag `--full`:** Habilita verificação de plano (máximo 2 iterações) e verificação pós-execução. Use quando você quer garantias de qualidade sem a cerimônia completa de milestone.
-
-**Flag `--research`:** Invoca um agente de pesquisa focado antes do planejamento. Investiga abordagens de implementação, opções de biblioteca e armadilhas para a tarefa. Use quando não tem certeza da melhor abordagem.
-
-Flags são combináveis: `--discuss --research --full` dá discussão + pesquisa + verificação de plano + verificação.
-
-## Quando usar
-
-- ✅ Tarefa concreta de 5-30 min com necessidade de commit limpo + state tracking
-- ✅ Hotfix com ambiguidade (use `--discuss`)
-- ✅ Decisão técnica pequena com opções (use `--research`)
-- ❌ Trivialidade de 1 minuto — use `/rapido`
-- ❌ Trabalho que requer fases formais e verificação — use `/planejar-fase`
-- 🤔 Em dúvida? → **`/fazer "descrição"`** roteia automaticamente
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/quick.md
-</execution_context>
-
-<context>
-$ARGUMENTS
-
-Arquivos de contexto são resolvidos dentro do workflow (`init quick`) e delegados via blocos `<files_to_read>`.
-</context>
-
-<process>
-Execute o workflow quick de @./.claude/framework/workflows/quick.md do início ao fim.
-Preserve todos os checkpoints do workflow (validação, descrição de tarefa, planejamento, execução, atualizações de estado, commits).
-</process>
+---
+name: expresso
+description: Executa uma tarefa rápida com garantias framework (commits atômicos, rastreamento de estado) mas pula agentes opcionais
+argument-hint: "[--full] [--discuss] [--research]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Executar tarefas pequenas e ad-hoc com garantias framework (commits atômicos, rastreamento no STATE.md).
+
+Modo expresso é o mesmo sistema com um caminho mais curto:
+- Invoca planner (modo rápido) + executor(s)
+- Tarefas expressas ficam em `.planning/quick/` separado das fases planejadas
+- Atualiza tabela "Quick Tasks Completed" do STATE.md (NÃO ROADMAP.md)
+
+**Padrão:** Pula pesquisa, discussão, plan-checker, verificador. Use quando você sabe exatamente o que fazer.
+
+**Flag `--discuss`:** Fase de discussão leve antes do planejamento. Apresenta hipóteses, esclarece áreas cinzentas, captura decisões em CONTEXT.md. Use quando a tarefa tem ambiguidade que vale a pena resolver antecipadamente.
+
+**Flag `--full`:** Habilita verificação de plano (máximo 2 iterações) e verificação pós-execução. Use quando você quer garantias de qualidade sem a cerimônia completa de milestone.
+
+**Flag `--research`:** Invoca um agente de pesquisa focado antes do planejamento. Investiga abordagens de implementação, opções de biblioteca e armadilhas para a tarefa. Use quando não tem certeza da melhor abordagem.
+
+Flags são combináveis: `--discuss --research --full` dá discussão + pesquisa + verificação de plano + verificação.
+
+## Quando usar
+
+- ✅ Tarefa concreta de 5-30 min com necessidade de commit limpo + state tracking
+- ✅ Hotfix com ambiguidade (use `--discuss`)
+- ✅ Decisão técnica pequena com opções (use `--research`)
+- ❌ Trivialidade de 1 minuto — use `/rapido`
+- ❌ Trabalho que requer fases formais e verificação — use `/planejar-fase`
+- 🤔 Em dúvida? → **`/fazer "descrição"`** roteia automaticamente
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/quick.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+Arquivos de contexto são resolvidos dentro do workflow (`init quick`) e delegados via blocos `<files_to_read>`.
+</context>
+
+<process>
+Execute o workflow quick de @./.claude/framework/workflows/quick.md do início ao fim.
+Preserve todos os checkpoints do workflow (validação, descrição de tarefa, planejamento, execução, atualizações de estado, commits).
+</process>