@luanpdd/kit-mcp 1.21.0 → 1.22.0

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>

package/kit/commands/fio.md

@@ -1,126 +1,126 @@
----
-name: fio
-description: Gerencia threads de contexto persistentes para trabalho entre sessões
+---
+name: fio
+description: Gerencia threads de contexto persistentes para trabalho entre sessões
 argument-hint: "[nome | descrição]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
----
-
-<objective>
-Criar, listar ou retomar threads de contexto persistentes. Threads são armazenamentos leves
-de conhecimento entre sessões para trabalho que abrange múltiplas sessões mas
-não pertence a nenhuma fase específica.
-</objective>
-
-<process>
-
-**Analisar $ARGUMENTS para determinar o modo:**
-
-<mode_list>
-**Se sem argumentos ou $ARGUMENTS estiver vazio:**
-
-Listar todos os threads:
-```bash
-ls .planning/threads/*.md 2>/dev/null
-```
-
-Para cada thread, ler as primeiras linhas para mostrar título e status:
-```
-## Threads Ativos
-
-| Thread | Status | Última Atualização |
-|--------|--------|--------------------|
-| fix-deploy-key-auth | ABERTO | 2026-03-15 |
-| pasta-tcp-timeout | RESOLVIDO | 2026-03-12 |
-| perf-investigation | EM ANDAMENTO | 2026-03-17 |
-```
-
-Se não existirem threads, mostrar:
-```
-Nenhum thread encontrado. Crie um com: /fio <descrição>
-```
-</mode_list>
-
-<mode_resume>
-**Se $ARGUMENTS corresponder a um nome de thread existente (arquivo existe):**
-
-Retomar o thread — carregar seu contexto na sessão atual:
-```bash
-cat ".planning/threads/${THREAD_NAME}.md"
-```
-
-Exibir o conteúdo do thread e perguntar ao usuário o que deseja trabalhar a seguir.
-Atualizar o status do thread para `IN PROGRESS` se estava `OPEN`.
-</mode_resume>
-
-<mode_create>
-**Se $ARGUMENTS for uma nova descrição (nenhum arquivo de thread correspondente):**
-
-Criar um novo thread:
-
-1. Gerar slug a partir da descrição:
-   ```bash
-   SLUG=$(node "./.claude/framework/bin/tools.cjs" generate-slug "$ARGUMENTS")
-   ```
-
-2. Criar o diretório de threads se necessário:
-   ```bash
-   mkdir -p .planning/threads
-   ```
-
-3. Escrever o arquivo do thread:
-   ```bash
-   cat > ".planning/threads/${SLUG}.md" << 'EOF'
-   # Thread: {descrição}
-
-   ## Status: OPEN
-
-   ## Objetivo
-
-   {descrição}
-
-   ## Contexto
-
-   *Criado a partir de conversa em {data de hoje}.*
-
-   ## Referências
-
-   - *(adicionar links, caminhos de arquivo ou números de issue)*
-
-   ## Próximos Passos
-
-   - *(o que a próxima sessão deve fazer primeiro)*
-   EOF
-   ```
-
-4. Se houver contexto relevante na conversa atual (trechos de código,
-   mensagens de erro, resultados de investigação), extrair e adicionar à seção Contexto.
-
-5. Commitar:
-   ```bash
-   node "./.claude/framework/bin/tools.cjs" commit "docs: criar thread — ${ARGUMENTS}" --files ".planning/threads/${SLUG}.md"
-   ```
-
-6. Reportar:
-   ```
-   ## Thread Criado
-
-   Thread: {slug}
-   Arquivo: .planning/threads/{slug}.md
-
-   Retome a qualquer momento com: /fio {slug}
-   ```
-</mode_create>
-
-</process>
-
-<notes>
-- Threads NÃO têm escopo de fase — existem independentemente do roadmap
-- Mais leve que /pausar-trabalho — sem estado de fase, sem contexto de plano
-- O valor está em Contexto e Próximos Passos — uma sessão fria pode começar imediatamente
-- Threads podem ser promovidos para fases ou itens de backlog quando amadurecem:
-  /adicionar-fase ou /adicionar-backlog com contexto do thread
-- Arquivos de thread ficam em .planning/threads/ — sem colisão com fases ou outras estruturas framework
-</notes>
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Criar, listar ou retomar threads de contexto persistentes. Threads são armazenamentos leves
+de conhecimento entre sessões para trabalho que abrange múltiplas sessões mas
+não pertence a nenhuma fase específica.
+</objective>
+
+<process>
+
+**Analisar $ARGUMENTS para determinar o modo:**
+
+<mode_list>
+**Se sem argumentos ou $ARGUMENTS estiver vazio:**
+
+Listar todos os threads:
+```bash
+ls .planning/threads/*.md 2>/dev/null
+```
+
+Para cada thread, ler as primeiras linhas para mostrar título e status:
+```
+## Threads Ativos
+
+| Thread | Status | Última Atualização |
+|--------|--------|--------------------|
+| fix-deploy-key-auth | ABERTO | 2026-03-15 |
+| pasta-tcp-timeout | RESOLVIDO | 2026-03-12 |
+| perf-investigation | EM ANDAMENTO | 2026-03-17 |
+```
+
+Se não existirem threads, mostrar:
+```
+Nenhum thread encontrado. Crie um com: /fio <descrição>
+```
+</mode_list>
+
+<mode_resume>
+**Se $ARGUMENTS corresponder a um nome de thread existente (arquivo existe):**
+
+Retomar o thread — carregar seu contexto na sessão atual:
+```bash
+cat ".planning/threads/${THREAD_NAME}.md"
+```
+
+Exibir o conteúdo do thread e perguntar ao usuário o que deseja trabalhar a seguir.
+Atualizar o status do thread para `IN PROGRESS` se estava `OPEN`.
+</mode_resume>
+
+<mode_create>
+**Se $ARGUMENTS for uma nova descrição (nenhum arquivo de thread correspondente):**
+
+Criar um novo thread:
+
+1. Gerar slug a partir da descrição:
+   ```bash
+   SLUG=$(node "./.claude/framework/bin/tools.cjs" generate-slug "$ARGUMENTS")
+   ```
+
+2. Criar o diretório de threads se necessário:
+   ```bash
+   mkdir -p .planning/threads
+   ```
+
+3. Escrever o arquivo do thread:
+   ```bash
+   cat > ".planning/threads/${SLUG}.md" << 'EOF'
+   # Thread: {descrição}
+
+   ## Status: OPEN
+
+   ## Objetivo
+
+   {descrição}
+
+   ## Contexto
+
+   *Criado a partir de conversa em {data de hoje}.*
+
+   ## Referências
+
+   - *(adicionar links, caminhos de arquivo ou números de issue)*
+
+   ## Próximos Passos
+
+   - *(o que a próxima sessão deve fazer primeiro)*
+   EOF
+   ```
+
+4. Se houver contexto relevante na conversa atual (trechos de código,
+   mensagens de erro, resultados de investigação), extrair e adicionar à seção Contexto.
+
+5. Commitar:
+   ```bash
+   node "./.claude/framework/bin/tools.cjs" commit "docs: criar thread — ${ARGUMENTS}" --files ".planning/threads/${SLUG}.md"
+   ```
+
+6. Reportar:
+   ```
+   ## Thread Criado
+
+   Thread: {slug}
+   Arquivo: .planning/threads/{slug}.md
+
+   Retome a qualquer momento com: /fio {slug}
+   ```
+</mode_create>
+
+</process>
+
+<notes>
+- Threads NÃO têm escopo de fase — existem independentemente do roadmap
+- Mais leve que /pausar-trabalho — sem estado de fase, sem contexto de plano
+- O valor está em Contexto e Próximos Passos — uma sessão fria pode começar imediatamente
+- Threads podem ser promovidos para fases ou itens de backlog quando amadurecem:
+  /adicionar-fase ou /adicionar-backlog com contexto do thread
+- Arquivos de thread ficam em .planning/threads/ — sem colisão com fases ou outras estruturas framework
+</notes>

package/kit/commands/fluxos-trabalho.md

@@ -1,64 +1,64 @@
----
-name: fluxos-trabalho
-description: Gerencia fluxos de trabalho paralelos — listar, criar, alternar, status, progresso, concluir e retomar
----
-
-# /fluxos-trabalho
-
-Gerencia fluxos de trabalho paralelos para trabalho concurrent em milestones.
-
-## Uso
-
-`/fluxos-trabalho [subcomando] [argumentos]`
-
-### Subcomandos
-
-| Comando | Descrição |
-|---------|-----------|
-| `list` | Listar todos os fluxos com status |
-| `create <nome>` | Criar um novo fluxo de trabalho |
-| `status <nome>` | Status detalhado de um fluxo |
-| `switch <nome>` | Definir fluxo ativo |
-| `progress` | Resumo de progresso de todos os fluxos |
-| `complete <nome>` | Arquivar um fluxo concluído |
-| `resume <nome>` | Retomar trabalho em um fluxo |
-
-## Passo 1: Analisar Subcomando
-
-Analisar a entrada do usuário para determinar qual operação de fluxo executar.
-Se nenhum subcomando for fornecido, padrão é `list`.
-
-## Passo 2: Executar Operação
-
-### list
-Executar: `node "$TOOLS" workstream list --raw --cwd "$CWD"`
-Exibir os fluxos em formato de tabela mostrando nome, status, fase atual e progresso.
-
-### create
-Executar: `node "$TOOLS" workstream create <nome> --raw --cwd "$CWD"`
-Após criação, exibir o caminho do novo fluxo e sugerir próximos passos:
-- `/novo-marco --ws <nome>` para configurar o milestone
-
-### status
-Executar: `node "$TOOLS" workstream status <nome> --raw --cwd "$CWD"`
-Exibir detalhamento de fases e informações de estado.
-
-### switch
-Executar: `node "$TOOLS" workstream set <nome> --raw --cwd "$CWD"`
-Também definir variável de ambiente `WORKSTREAM` para a sessão atual.
-
-### progress
-Executar: `node "$TOOLS" workstream progress --raw --cwd "$CWD"`
-Exibir visão geral de progresso de todos os fluxos.
-
-### complete
-Executar: `node "$TOOLS" workstream complete <nome> --raw --cwd "$CWD"`
-Arquivar o fluxo em milestones/.
-
-### resume
-Definir o fluxo como ativo e sugerir `/retomar-trabalho --ws <nome>`.
-
-## Passo 3: Exibir Resultados
-
-Formatar a saída JSON do tools em exibição legível por humanos.
-Incluir a flag `${WS}` em qualquer sugestão de roteamento.
+---
+name: fluxos-trabalho
+description: Gerencia fluxos de trabalho paralelos — listar, criar, alternar, status, progresso, concluir e retomar
+---
+
+# /fluxos-trabalho
+
+Gerencia fluxos de trabalho paralelos para trabalho concurrent em milestones.
+
+## Uso
+
+`/fluxos-trabalho [subcomando] [argumentos]`
+
+### Subcomandos
+
+| Comando | Descrição |
+|---------|-----------|
+| `list` | Listar todos os fluxos com status |
+| `create <nome>` | Criar um novo fluxo de trabalho |
+| `status <nome>` | Status detalhado de um fluxo |
+| `switch <nome>` | Definir fluxo ativo |
+| `progress` | Resumo de progresso de todos os fluxos |
+| `complete <nome>` | Arquivar um fluxo concluído |
+| `resume <nome>` | Retomar trabalho em um fluxo |
+
+## Passo 1: Analisar Subcomando
+
+Analisar a entrada do usuário para determinar qual operação de fluxo executar.
+Se nenhum subcomando for fornecido, padrão é `list`.
+
+## Passo 2: Executar Operação
+
+### list
+Executar: `node "$TOOLS" workstream list --raw --cwd "$CWD"`
+Exibir os fluxos em formato de tabela mostrando nome, status, fase atual e progresso.
+
+### create
+Executar: `node "$TOOLS" workstream create <nome> --raw --cwd "$CWD"`
+Após criação, exibir o caminho do novo fluxo e sugerir próximos passos:
+- `/novo-marco --ws <nome>` para configurar o milestone
+
+### status
+Executar: `node "$TOOLS" workstream status <nome> --raw --cwd "$CWD"`
+Exibir detalhamento de fases e informações de estado.
+
+### switch
+Executar: `node "$TOOLS" workstream set <nome> --raw --cwd "$CWD"`
+Também definir variável de ambiente `WORKSTREAM` para a sessão atual.
+
+### progress
+Executar: `node "$TOOLS" workstream progress --raw --cwd "$CWD"`
+Exibir visão geral de progresso de todos os fluxos.
+
+### complete
+Executar: `node "$TOOLS" workstream complete <nome> --raw --cwd "$CWD"`
+Arquivar o fluxo em milestones/.
+
+### resume
+Definir o fluxo como ativo e sugerir `/retomar-trabalho --ws <nome>`.
+
+## Passo 3: Exibir Resultados
+
+Formatar a saída JSON do tools em exibição legível por humanos.
+Incluir a flag `${WS}` em qualquer sugestão de roteamento.