@luanpdd/kit-mcp 1.30.2 → 1.31.0

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>

package/kit/commands/atualizar.md

@@ -1,37 +1,37 @@
----
-name: atualizar
-description: Atualiza o framework para a versão mais recente com exibição de changelog
-allowed-tools:
-  - Bash
-  - AskUserQuestion
----
-
-<objective>
-Verifica atualizações do framework, instala se disponível e exibe o que mudou.
-
-Roteia para o workflow update que trata:
-- Detecção de versão (instalação local vs global)
-- Verificação de versão no npm
-- Busca e exibição do changelog
-- Confirmação do usuário com aviso de instalação limpa
-- Execução da atualização e limpeza de cache
-- Lembrete de reinicialização
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/update.md
-</execution_context>
-
-<process>
-**Seguir o workflow update** de `@./.claude/framework/workflows/update.md`.
-
-O workflow trata toda a lógica incluindo:
-1. Detecção de versão instalada (local/global)
-2. Verificação da versão mais recente via npm
-3. Comparação de versões
-4. Busca e extração do changelog
-5. Exibição do aviso de instalação limpa
-6. Confirmação do usuário
-7. Execução da atualização
-8. Limpeza de cache
-</process>
+---
+name: atualizar
+description: Atualiza o framework para a versão mais recente com exibição de changelog
+allowed-tools:
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Verifica atualizações do framework, instala se disponível e exibe o que mudou.
+
+Roteia para o workflow update que trata:
+- Detecção de versão (instalação local vs global)
+- Verificação de versão no npm
+- Busca e exibição do changelog
+- Confirmação do usuário com aviso de instalação limpa
+- Execução da atualização e limpeza de cache
+- Lembrete de reinicialização
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/update.md
+</execution_context>
+
+<process>
+**Seguir o workflow update** de `@./.claude/framework/workflows/update.md`.
+
+O workflow trata toda a lógica incluindo:
+1. Detecção de versão instalada (local/global)
+2. Verificação da versão mais recente via npm
+3. Comparação de versões
+4. Busca e extração do changelog
+5. Exibição do aviso de instalação limpa
+6. Confirmação do usuário
+7. Execução da atualização
+8. Limpeza de cache
+</process>