@luanpdd/kit-mcp 1.27.0 → 1.29.0

package/kit/commands/retomar-trabalho.md

@@ -1,40 +1,40 @@
----
-name: retomar-trabalho
-description: Retoma o trabalho da sessão anterior com restauração completa de contexto
-allowed-tools:
-  - Read
-  - Bash
-  - Write
-  - AskUserQuestion
-  - SlashCommand
----
-
-<objective>
-Restaura o contexto completo do projeto e retoma o trabalho de forma contínua a partir da sessão anterior.
-
-Roteia para o workflow resume-project que trata:
-
-- Carregamento do STATE.md (ou reconstrução se ausente)
-- Detecção de checkpoints (arquivos .continue-here)
-- Detecção de trabalho incompleto (PLAN sem SUMMARY)
-- Apresentação de status
-- Roteamento de próxima ação com consciência de contexto
-  </objective>
-
-<execution_context>
-@./.claude/framework/workflows/resume-project.md
-</execution_context>
-
-<process>
-**Seguir o workflow resume-project** de `@./.claude/framework/workflows/resume-project.md`.
-
-O workflow trata toda a lógica de retomada incluindo:
-
-1. Verificação de existência do projeto
-2. Carregamento ou reconstrução do STATE.md
-3. Detecção de checkpoints e trabalho incompleto
-4. Apresentação visual de status
-5. Oferta de opções com consciência de contexto (verifica CONTEXT.md antes de sugerir planejar vs discutir)
-6. Roteamento para próximo comando apropriado
-7. Atualizações de continuidade da sessão
-   </process>
+---
+name: retomar-trabalho
+description: Retoma o trabalho da sessão anterior com restauração completa de contexto
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - AskUserQuestion
+  - SlashCommand
+---
+
+<objective>
+Restaura o contexto completo do projeto e retoma o trabalho de forma contínua a partir da sessão anterior.
+
+Roteia para o workflow resume-project que trata:
+
+- Carregamento do STATE.md (ou reconstrução se ausente)
+- Detecção de checkpoints (arquivos .continue-here)
+- Detecção de trabalho incompleto (PLAN sem SUMMARY)
+- Apresentação de status
+- Roteamento de próxima ação com consciência de contexto
+  </objective>
+
+<execution_context>
+@./.claude/framework/workflows/resume-project.md
+</execution_context>
+
+<process>
+**Seguir o workflow resume-project** de `@./.claude/framework/workflows/resume-project.md`.
+
+O workflow trata toda a lógica de retomada incluindo:
+
+1. Verificação de existência do projeto
+2. Carregamento ou reconstrução do STATE.md
+3. Detecção de checkpoints e trabalho incompleto
+4. Apresentação visual de status
+5. Oferta de opções com consciência de contexto (verifica CONTEXT.md antes de sugerir planejar vs discutir)
+6. Roteamento para próximo comando apropriado
+7. Atualizações de continuidade da sessão
+   </process>

package/kit/commands/revisar-backlog.md

@@ -1,60 +1,60 @@
----
-name: revisar-backlog
-description: Revisa e promove itens do backlog para o milestone ativo
-allowed-tools:
-  - Read
-  - Write
-  - Bash
----
-
-<objective>
-Revisar todos os itens de backlog 999.x e opcionalmente promovê-los para a sequência do milestone ativo ou remover entradas obsoletas.
-</objective>
-
-<process>
-
-1. **Listar itens do backlog:**
-   ```bash
-   ls -d .planning/phases/999* 2>/dev/null || echo "Nenhum item de backlog encontrado"
-   ```
-
-2. **Ler ROADMAP.md** e extrair todas as entradas de fase 999.x:
-   ```bash
-   cat .planning/ROADMAP.md
-   ```
-   Mostrar cada item do backlog com sua descrição, qualquer contexto acumulado (CONTEXT.md, RESEARCH.md) e data de criação.
-
-3. **Apresentar a lista ao usuário** via AskUserQuestion:
-   - Para cada item do backlog, mostrar: número da fase, descrição, artefatos acumulados
-   - Opções por item: **Promover** (mover para ativo), **Manter** (deixar no backlog), **Remover** (deletar)
-
-4. **Para itens a PROMOVER:**
-   - Encontrar o próximo número de fase sequencial no milestone ativo
-   - Renomear o diretório de `999.x-slug` para `{novo_num}-slug`:
-     ```bash
-     NEW_NUM=$(node "./.claude/framework/bin/tools.cjs" phase add "${DESCRIPTION}" --raw)
-     ```
-   - Mover artefatos acumulados para o novo diretório de fase
-   - Atualizar ROADMAP.md: mover entrada da seção `## Backlog` para a lista de fases ativas
-   - Remover marcador `(BACKLOG)`
-   - Adicionar campo `**Depends on:**` apropriado
-
-5. **Para itens a REMOVER:**
-   - Deletar o diretório da fase
-   - Remover a entrada da seção `## Backlog` do ROADMAP.md
-
-6. **Commitar alterações:**
-   ```bash
-   node "./.claude/framework/bin/tools.cjs" commit "docs: revisar backlog — promovidos N, removidos M" --files .planning/ROADMAP.md
-   ```
-
-7. **Relatório resumo:**
-   ```
-   ## Revisão de Backlog Concluída
-
-   Promovidos: {lista de itens promovidos com novos números de fase}
-   Mantidos: {lista de itens que permanecem no backlog}
-   Removidos: {lista de itens deletados}
-   ```
-
-</process>
+---
+name: revisar-backlog
+description: Revisa e promove itens do backlog para o milestone ativo
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Revisar todos os itens de backlog 999.x e opcionalmente promovê-los para a sequência do milestone ativo ou remover entradas obsoletas.
+</objective>
+
+<process>
+
+1. **Listar itens do backlog:**
+   ```bash
+   ls -d .planning/phases/999* 2>/dev/null || echo "Nenhum item de backlog encontrado"
+   ```
+
+2. **Ler ROADMAP.md** e extrair todas as entradas de fase 999.x:
+   ```bash
+   cat .planning/ROADMAP.md
+   ```
+   Mostrar cada item do backlog com sua descrição, qualquer contexto acumulado (CONTEXT.md, RESEARCH.md) e data de criação.
+
+3. **Apresentar a lista ao usuário** via AskUserQuestion:
+   - Para cada item do backlog, mostrar: número da fase, descrição, artefatos acumulados
+   - Opções por item: **Promover** (mover para ativo), **Manter** (deixar no backlog), **Remover** (deletar)
+
+4. **Para itens a PROMOVER:**
+   - Encontrar o próximo número de fase sequencial no milestone ativo
+   - Renomear o diretório de `999.x-slug` para `{novo_num}-slug`:
+     ```bash
+     NEW_NUM=$(node "./.claude/framework/bin/tools.cjs" phase add "${DESCRIPTION}" --raw)
+     ```
+   - Mover artefatos acumulados para o novo diretório de fase
+   - Atualizar ROADMAP.md: mover entrada da seção `## Backlog` para a lista de fases ativas
+   - Remover marcador `(BACKLOG)`
+   - Adicionar campo `**Depends on:**` apropriado
+
+5. **Para itens a REMOVER:**
+   - Deletar o diretório da fase
+   - Remover a entrada da seção `## Backlog` do ROADMAP.md
+
+6. **Commitar alterações:**
+   ```bash
+   node "./.claude/framework/bin/tools.cjs" commit "docs: revisar backlog — promovidos N, removidos M" --files .planning/ROADMAP.md
+   ```
+
+7. **Relatório resumo:**
+   ```
+   ## Revisão de Backlog Concluída
+
+   Promovidos: {lista de itens promovidos com novos números de fase}
+   Mantidos: {lista de itens que permanecem no backlog}
+   Removidos: {lista de itens deletados}
+   ```
+
+</process>

package/kit/commands/revisar-ui.md

@@ -1,32 +1,32 @@
----
-name: revisar-ui
-description: Auditoria visual retroativa de 6 pilares do código frontend implementado
-argument-hint: "[fase]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
-  - Task
-  - AskUserQuestion
----
-<objective>
-Realiza uma auditoria visual retroativa de 6 pilares. Produz UI-REVIEW.md com
-avaliação graduada (1-4 por pilar). Funciona em qualquer projeto.
-Saída: {phase_num}-UI-REVIEW.md
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/ui-review.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<context>
-Fase: $ARGUMENTS — opcional, padrão é a última fase concluída.
-</context>
-
-<process>
-Execute @./.claude/framework/workflows/ui-review.md do início ao fim.
-Preserve todos os gates do workflow.
-</process>
+---
+name: revisar-ui
+description: Auditoria visual retroativa de 6 pilares do código frontend implementado
+argument-hint: "[fase]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Realiza uma auditoria visual retroativa de 6 pilares. Produz UI-REVIEW.md com
+avaliação graduada (1-4 por pilar). Funciona em qualquer projeto.
+Saída: {phase_num}-UI-REVIEW.md
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/ui-review.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Fase: $ARGUMENTS — opcional, padrão é a última fase concluída.
+</context>
+
+<process>
+Execute @./.claude/framework/workflows/ui-review.md do início ao fim.
+Preserve todos os gates do workflow.
+</process>

package/kit/commands/revisar.md

@@ -1,37 +1,37 @@
----
-name: revisar
-description: Solicita revisão entre IAs de planos de fase a partir de CLIs externas
-argument-hint: "--phase N [--gemini] [--claude] [--codex] [--all]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
----
-
-<objective>
-Invoca CLIs externas de IA (Gemini, Claude, Codex) para revisar planos de fase de forma independente.
-Produz um REVIEWS.md estruturado com feedback por revisor que pode ser incorporado de volta ao
-planejamento via /planejar-fase --reviews.
-
-**Fluxo:** Detectar CLIs → Construir prompt de revisão → Invocar cada CLI → Coletar respostas → Escrever REVIEWS.md
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/review.md
-</execution_context>
-
-<context>
-Número da fase: extraído de $ARGUMENTS (obrigatório)
-
-**Flags:**
-- `--gemini` — Incluir revisão do Gemini CLI
-- `--claude` — Incluir revisão do Claude CLI (usa sessão separada)
-- `--codex` — Incluir revisão do Codex CLI
-- `--all` — Incluir todos os CLIs disponíveis
-</context>
-
-<process>
-Execute o workflow review de @./.claude/framework/workflows/review.md do início ao fim.
-</process>
+---
+name: revisar
+description: Solicita revisão entre IAs de planos de fase a partir de CLIs externas
+argument-hint: "--phase N [--gemini] [--claude] [--codex] [--all]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+---
+
+<objective>
+Invoca CLIs externas de IA (Gemini, Claude, Codex) para revisar planos de fase de forma independente.
+Produz um REVIEWS.md estruturado com feedback por revisor que pode ser incorporado de volta ao
+planejamento via /planejar-fase --reviews.
+
+**Fluxo:** Detectar CLIs → Construir prompt de revisão → Invocar cada CLI → Coletar respostas → Escrever REVIEWS.md
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/review.md
+</execution_context>
+
+<context>
+Número da fase: extraído de $ARGUMENTS (obrigatório)
+
+**Flags:**
+- `--gemini` — Incluir revisão do Gemini CLI
+- `--claude` — Incluir revisão do Claude CLI (usa sessão separada)
+- `--codex` — Incluir revisão do Codex CLI
+- `--all` — Incluir todos os CLIs disponíveis
+</context>
+
+<process>
+Execute o workflow review de @./.claude/framework/workflows/review.md do início ao fim.
+</process>

package/kit/commands/saude.md

@@ -1,22 +1,22 @@
----
-name: saude
-description: Diagnostica a integridade do diretório de planejamento e opcionalmente repara problemas
-argument-hint: [--repair]
-allowed-tools:
-  - Read
-  - Bash
-  - Write
-  - AskUserQuestion
----
-<objective>
-Validar a integridade do diretório `.planning/` e reportar problemas acionáveis. Verifica arquivos ausentes, configurações inválidas, estado inconsistente e planos órfãos.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/health.md
-</execution_context>
-
-<process>
-Execute o workflow health de @./.claude/framework/workflows/health.md do início ao fim.
-Analisar a flag --repair dos argumentos e passar para o workflow.
+---
+name: saude
+description: Diagnostica a integridade do diretório de planejamento e opcionalmente repara problemas
+argument-hint: [--repair]
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - AskUserQuestion
+---
+<objective>
+Validar a integridade do diretório `.planning/` e reportar problemas acionáveis. Verifica arquivos ausentes, configurações inválidas, estado inconsistente e planos órfãos.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/health.md
+</execution_context>
+
+<process>
+Execute o workflow health de @./.claude/framework/workflows/health.md do início ao fim.
+Analisar a flag --repair dos argumentos e passar para o workflow.
 </process>

package/kit/commands/setup-notion.md

@@ -1,93 +1,93 @@
-# /setup-notion — Inicializar Documentação Notion para um Projeto
-
-Cria a estrutura de páginas Notion para um novo projeto sob a página raiz do seu workspace e gera o `.claude/notion-config.json` local.
-
-## Quando usar
-
-Ao iniciar um novo projeto framework que ainda não tem página no Notion.
-Execute uma vez por projeto — depois use `/publicar` normalmente.
-
-## Processo
-
-### Passo 1 — Ler contexto do projeto
-
-Leia `.planning/PROJECT.md` para obter:
-- Nome do projeto
-- Stack
-- Descrição em 1 frase
-
-### Passo 2 — Criar páginas no Notion
-
-Use o Notion MCP (`notion-create-pages`) com `parent.page_id = "{NOTION_PARENT_PAGE_ID}"`, onde `NOTION_PARENT_PAGE_ID` é o ID da página raiz do seu workspace de documentação (configure via env var `KIT_NOTION_PARENT_PAGE_ID` ou substitua diretamente).
-
-Crie a página raiz do projeto com ícone 📋 e este conteúdo:
-
-```
-[Callout azul] {NOME_PROJETO} — {DESCRICAO_1_FRASE}
-
----
-
-## Stack
-[Tabela com camadas e tecnologias do PROJECT.md]
-
----
-
-## Estrutura da Documentação
-- changelog/ — Uma entrada por milestone
-- features/ — O que cada feature faz
-- adr/ — Decisões arquiteturais
-- runbooks/ — Procedimentos operacionais
-
----
-
-## Versões Lançadas
-[Tabela vazia: Versão | Nome | Data | Status]
-```
-
-Depois crie as 4 subpáginas sob a página raiz criada:
-- 📅 `changelog/` — com tabela de índice vazia
-- 📄 `features/` — com tabela de índice vazia
-- 🏛️ `adr/` — com tabela de índice vazia
-- 📖 `runbooks/` — com tabela de índice vazia
-
-### Passo 3 — Gerar notion-config.json
-
-Com os IDs retornados pelo Notion MCP, crie `.claude/notion-config.json`:
-
-```json
-{
-  "project": "{NOME_PROJETO}",
-  "notion": {
-    "root": "{ID_ROOT}",
-    "root_url": "{URL_ROOT}",
-    "changelog": "{ID_CHANGELOG}",
-    "features": "{ID_FEATURES}",
-    "adr": "{ID_ADR}",
-    "runbooks": "{ID_RUNBOOKS}"
-  }
-}
-```
-
-### Passo 4 — Reportar resultado
-
-```
-✅ Notion configurado para {NOME_PROJETO}
-
-📋 Página principal: {URL_ROOT}
-📅 changelog/: {URL_CHANGELOG}
-📄 features/: {URL_FEATURES}
-🏛️ adr/: {URL_ADR}
-📖 runbooks/: {URL_RUNBOOKS}
-
-Arquivo criado: .claude/notion-config.json
-Próximo passo: use /publicar ao concluir o próximo milestone.
-```
-
-## Configuração da página raiz do Notion
-
-Defina o ID da página raiz onde os projetos serão criados (uma página "guarda-chuva" no seu workspace Notion):
-
-- Via env var: `export KIT_NOTION_PARENT_PAGE_ID="<ID_DA_PAGINA>"`
-- Ou substitua `{NOTION_PARENT_PAGE_ID}` no Passo 2 pelo ID literal antes de executar.
-
-Para obter o ID: abra a página no Notion → Share → Copy link → o ID é o hash de 32 caracteres no final da URL.
+# /setup-notion — Inicializar Documentação Notion para um Projeto
+
+Cria a estrutura de páginas Notion para um novo projeto sob a página raiz do seu workspace e gera o `.claude/notion-config.json` local.
+
+## Quando usar
+
+Ao iniciar um novo projeto framework que ainda não tem página no Notion.
+Execute uma vez por projeto — depois use `/publicar` normalmente.
+
+## Processo
+
+### Passo 1 — Ler contexto do projeto
+
+Leia `.planning/PROJECT.md` para obter:
+- Nome do projeto
+- Stack
+- Descrição em 1 frase
+
+### Passo 2 — Criar páginas no Notion
+
+Use o Notion MCP (`notion-create-pages`) com `parent.page_id = "{NOTION_PARENT_PAGE_ID}"`, onde `NOTION_PARENT_PAGE_ID` é o ID da página raiz do seu workspace de documentação (configure via env var `KIT_NOTION_PARENT_PAGE_ID` ou substitua diretamente).
+
+Crie a página raiz do projeto com ícone 📋 e este conteúdo:
+
+```
+[Callout azul] {NOME_PROJETO} — {DESCRICAO_1_FRASE}
+
+---
+
+## Stack
+[Tabela com camadas e tecnologias do PROJECT.md]
+
+---
+
+## Estrutura da Documentação
+- changelog/ — Uma entrada por milestone
+- features/ — O que cada feature faz
+- adr/ — Decisões arquiteturais
+- runbooks/ — Procedimentos operacionais
+
+---
+
+## Versões Lançadas
+[Tabela vazia: Versão | Nome | Data | Status]
+```
+
+Depois crie as 4 subpáginas sob a página raiz criada:
+- 📅 `changelog/` — com tabela de índice vazia
+- 📄 `features/` — com tabela de índice vazia
+- 🏛️ `adr/` — com tabela de índice vazia
+- 📖 `runbooks/` — com tabela de índice vazia
+
+### Passo 3 — Gerar notion-config.json
+
+Com os IDs retornados pelo Notion MCP, crie `.claude/notion-config.json`:
+
+```json
+{
+  "project": "{NOME_PROJETO}",
+  "notion": {
+    "root": "{ID_ROOT}",
+    "root_url": "{URL_ROOT}",
+    "changelog": "{ID_CHANGELOG}",
+    "features": "{ID_FEATURES}",
+    "adr": "{ID_ADR}",
+    "runbooks": "{ID_RUNBOOKS}"
+  }
+}
+```
+
+### Passo 4 — Reportar resultado
+
+```
+✅ Notion configurado para {NOME_PROJETO}
+
+📋 Página principal: {URL_ROOT}
+📅 changelog/: {URL_CHANGELOG}
+📄 features/: {URL_FEATURES}
+🏛️ adr/: {URL_ADR}
+📖 runbooks/: {URL_RUNBOOKS}
+
+Arquivo criado: .claude/notion-config.json
+Próximo passo: use /publicar ao concluir o próximo milestone.
+```
+
+## Configuração da página raiz do Notion
+
+Defina o ID da página raiz onde os projetos serão criados (uma página "guarda-chuva" no seu workspace Notion):
+
+- Via env var: `export KIT_NOTION_PARENT_PAGE_ID="<ID_DA_PAGINA>"`
+- Ou substitua `{NOTION_PARENT_PAGE_ID}` no Passo 2 pelo ID literal antes de executar.
+
+Para obter o ID: abra a página no Notion → Share → Copy link → o ID é o hash de 32 caracteres no final da URL.

package/kit/commands/storytelling.md

@@ -1,6 +1,6 @@
 ---
 name: storytelling
-description: Invoca storytelling-analyst — IA gera mental model de codebase desconhecido (story 5 frases + inventário + naked CRC + responsibility hot spots + extract candidates). Modernização cap 16-17 Feathers para era IA.
+description: Invoca storytelling-analyst — IA gera mental model de codebase desconhecido (story 5 frases + inventário + naked CRC + responsibility hot spots + extract candidates).
 argument-hint: "<target_dir_or_file> [--depth deep|shallow] [--include-tests] [--output PATH]"
 allowed-tools:
   - Read

package/kit/commands/supabase.md

@@ -1,6 +1,6 @@
 ---
 name: supabase
-description: Orquestrador da Suíte Supabase — serviço de materialização (v1.23) que recebe planejamento/draft SQL de qualquer agent ou user e devolve código hardenado pronto. NUNCA bloqueia upstream — handoff cooperativo via Task(). Subcomandos arquiteto, migration, rls, hardener, edge, realtime, auth, storage, rag, cron, check com sinônimos PT/EN.
+description: Orquestrador da Suíte Supabase — serviço de materialização (v1.23) que recebe planejamento/draft SQL de qualquer agent ou user e devolve código hardenado pronto. NUNCA bloqueia upstream…
 argument-hint: "<subcomando> [args...]"
 allowed-tools:
   - Read