@luanpdd/kit-mcp 1.28.0 → 1.30.0

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>

package/kit/commands/fase-ui.md

@@ -1,34 +1,34 @@
----
-name: fase-ui
-description: Gera contrato de design UI (UI-SPEC.md) para fases de frontend
-argument-hint: "[fase]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
-  - Task
-  - WebFetch
-  - AskUserQuestion
-  - mcp__context7__*
----
-<objective>
-Cria um contrato de design UI (UI-SPEC.md) para uma fase de frontend.
-Orquestra os agentes ui-researcher e ui-checker.
-Fluxo: Validar → Pesquisar UI → Verificar UI-SPEC → Concluído
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/ui-phase.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<context>
-Número da fase: $ARGUMENTS — opcional, auto-detecta a próxima fase não planejada se omitido.
-</context>
-
-<process>
-Execute @./.claude/framework/workflows/ui-phase.md do início ao fim.
-Preserve todos os gates do workflow.
-</process>
+---
+name: fase-ui
+description: Gera contrato de design UI (UI-SPEC.md) para fases de frontend
+argument-hint: "[fase]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - WebFetch
+  - AskUserQuestion
+  - mcp__context7__*
+---
+<objective>
+Cria um contrato de design UI (UI-SPEC.md) para uma fase de frontend.
+Orquestra os agentes ui-researcher e ui-checker.
+Fluxo: Validar → Pesquisar UI → Verificar UI-SPEC → Concluído
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/ui-phase.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Número da fase: $ARGUMENTS — opcional, auto-detecta a próxima fase não planejada se omitido.
+</context>
+
+<process>
+Execute @./.claude/framework/workflows/ui-phase.md do início ao fim.
+Preserve todos os gates do workflow.
+</process>

package/kit/commands/fazer.md

@@ -1,58 +1,58 @@
----
-name: fazer
-description: Entrypoint canônico — roteia texto livre para o comando do framework correto. Use este quando estiver na dúvida.
-argument-hint: "<descrição do que você quer fazer>"
-allowed-tools:
-  - Read
-  - Bash
-  - AskUserQuestion
----
-<objective>
-**Entrypoint canônico do framework.** Quando você sabe o que quer mas não sabe qual `/*` executar, use `/fazer "descrição"`.
-
-`/fazer` é um despachante inteligente — nunca faz o trabalho diretamente; combina a intenção com o melhor comando e transfere com confirmação.
-
-## Árvore de decisão
-
-| Sua intenção | Comando recomendado | Quando usar |
-|---|---|---|
-| Tarefa **trivial** (rename, ajuste pontual) | **`/rapido`** | Sem necessidade de plano formal; commit atômico, sem subagentes |
-| Tarefa **rápida com garantias** (commit limpo, rastreamento de estado) | **`/expresso`** | Algo concreto mas pequeno; pula agentes opcionais mas mantém disciplina |
-| Trabalho **estruturado** (multi-arquivo, requer planejamento) | **`/discutir-fase` → `/planejar-fase` → `/executar-fase`** | Fase real de milestone; usa agentes completos |
-| **Tarefa Supabase** (DB/Auth/Realtime/Edge/Storage/RLS/migration) | **`/supabase <subcomando>`** | Roteia para agent especializado: arquiteto / migration / rls / edge / realtime / auth / storage / rag / cron / check |
-| **Próximo passo** ambíguo no fluxo atual | **`/proximo`** | Avança no roadmap automaticamente |
-| **Capturar ideia** sem agir agora | **`/nota`** ou **`/adicionar-tarefa`** | Salva pra depois sem interromper o foco |
-| **Investigar bug** com método científico | **`/depurar`** | Hipótese → teste → fix com checkpoints |
-
-## Detecção de intenção Supabase
-
-Se a descrição do user menciona qualquer destes termos, considere rotear para `/supabase` em vez de `/discutir-fase` ou `/expresso`:
-
-- **DB:** "migration", "RLS", "policy", "schema", "tabela Postgres", "supabase/migrations", "supabase/schemas"
-- **Auth:** "Supabase auth", "Next.js auth", "@supabase/ssr", "magic link", "OAuth", "MFA TOTP"
-- **Realtime:** "broadcast Supabase", "presence", "postgres_changes", "channel"
-- **Edge Functions:** "Edge Function", "Deno + Supabase", "supabase/functions"
-- **Storage:** "bucket", "signed URL", "upload Supabase"
-- **AI/RAG:** "pgvector", "embeddings + Supabase", "RAG with permissions"
-- **Background:** "pg_cron", "pgmq", "scheduled job Supabase"
-
-Para contexto sobre o que cada subcomando faz, leia [`/supabase`](./supabase.md) ou as 11 skills em `kit/skills/supabase-*/`.
-
-## Aliases (continuam funcionando)
-
-`/rapido`, `/expresso`, `/proximo`, `/depurar`, `/discutir-fase`, `/planejar-fase`, `/executar-fase` — todos continuam executando direto, sem passar pelo `/fazer`. Use `/fazer` quando estiver em dúvida sobre qual escolher.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/do.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<context>
-$ARGUMENTS
-</context>
-
-<process>
-Execute o workflow do de @./.claude/framework/workflows/do.md do início ao fim.
-Rotear a intenção do usuário para o melhor comando do framework e invocá-lo.
+---
+name: fazer
+description: Entrypoint canônico — roteia texto livre para o comando do framework correto. Use este quando estiver na dúvida.
+argument-hint: "<descrição do que você quer fazer>"
+allowed-tools:
+  - Read
+  - Bash
+  - AskUserQuestion
+---
+<objective>
+**Entrypoint canônico do framework.** Quando você sabe o que quer mas não sabe qual `/*` executar, use `/fazer "descrição"`.
+
+`/fazer` é um despachante inteligente — nunca faz o trabalho diretamente; combina a intenção com o melhor comando e transfere com confirmação.
+
+## Árvore de decisão
+
+| Sua intenção | Comando recomendado | Quando usar |
+|---|---|---|
+| Tarefa **trivial** (rename, ajuste pontual) | **`/rapido`** | Sem necessidade de plano formal; commit atômico, sem subagentes |
+| Tarefa **rápida com garantias** (commit limpo, rastreamento de estado) | **`/expresso`** | Algo concreto mas pequeno; pula agentes opcionais mas mantém disciplina |
+| Trabalho **estruturado** (multi-arquivo, requer planejamento) | **`/discutir-fase` → `/planejar-fase` → `/executar-fase`** | Fase real de milestone; usa agentes completos |
+| **Tarefa Supabase** (DB/Auth/Realtime/Edge/Storage/RLS/migration) | **`/supabase <subcomando>`** | Roteia para agent especializado: arquiteto / migration / rls / edge / realtime / auth / storage / rag / cron / check |
+| **Próximo passo** ambíguo no fluxo atual | **`/proximo`** | Avança no roadmap automaticamente |
+| **Capturar ideia** sem agir agora | **`/nota`** ou **`/adicionar-tarefa`** | Salva pra depois sem interromper o foco |
+| **Investigar bug** com método científico | **`/depurar`** | Hipótese → teste → fix com checkpoints |
+
+## Detecção de intenção Supabase
+
+Se a descrição do user menciona qualquer destes termos, considere rotear para `/supabase` em vez de `/discutir-fase` ou `/expresso`:
+
+- **DB:** "migration", "RLS", "policy", "schema", "tabela Postgres", "supabase/migrations", "supabase/schemas"
+- **Auth:** "Supabase auth", "Next.js auth", "@supabase/ssr", "magic link", "OAuth", "MFA TOTP"
+- **Realtime:** "broadcast Supabase", "presence", "postgres_changes", "channel"
+- **Edge Functions:** "Edge Function", "Deno + Supabase", "supabase/functions"
+- **Storage:** "bucket", "signed URL", "upload Supabase"
+- **AI/RAG:** "pgvector", "embeddings + Supabase", "RAG with permissions"
+- **Background:** "pg_cron", "pgmq", "scheduled job Supabase"
+
+Para contexto sobre o que cada subcomando faz, leia [`/supabase`](./supabase.md) ou as 11 skills em `kit/skills/supabase-*/`.
+
+## Aliases (continuam funcionando)
+
+`/rapido`, `/expresso`, `/proximo`, `/depurar`, `/discutir-fase`, `/planejar-fase`, `/executar-fase` — todos continuam executando direto, sem passar pelo `/fazer`. Use `/fazer` quando estiver em dúvida sobre qual escolher.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/do.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+</context>
+
+<process>
+Execute o workflow do de @./.claude/framework/workflows/do.md do início ao fim.
+Rotear a intenção do usuário para o melhor comando do framework e invocá-lo.
 </process>