@luanpdd/kit-mcp 0.2.1 → 0.3.0

package/kit/commands/adicionar-backlog.md

@@ -0,0 +1,76 @@
+---
+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>

package/kit/commands/adicionar-fase.md

@@ -0,0 +1,43 @@
+---
+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>

package/kit/commands/adicionar-tarefa.md

@@ -0,0 +1,47 @@
+---
+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
+</process>

package/kit/commands/adicionar-testes.md

@@ -0,0 +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>

package/kit/commands/ajuda.md

@@ -0,0 +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.
+</process>

package/kit/commands/atualizar.md

@@ -0,0 +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>

package/kit/commands/auditar-marco.md

@@ -0,0 +1,36 @@
+---
+name: auditar-marco
+description: Audita a conclusão do milestone contra a intenção original antes de arquivar
+argument-hint: "[version]"
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - Write
+---
+<objective>
+Verificar se o milestone alcançou sua definição de pronto. Checar cobertura de requisitos, integração entre fases e fluxos de ponta a ponta.
+
+**Este comando É o orquestrador.** Lê os arquivos VERIFICATION.md existentes (fases já verificadas durante o executar-fase), agrega dívidas técnicas e lacunas adiadas, então invoca o verificador de integração para a fiação entre fases.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/audit-milestone.md
+</execution_context>
+
+<context>
+Versão: $ARGUMENTS (opcional — padrão para o milestone atual)
+
+Arquivos principais de planejamento são resolvidos no workflow (`init milestone-op`) e carregados apenas quando necessário.
+
+**Trabalho Concluído:**
+Glob: .planning/phases/*/*-SUMMARY.md
+Glob: .planning/phases/*/*-VERIFICATION.md
+</context>
+
+<process>
+Execute o workflow audit-milestone de @./.claude/framework/workflows/audit-milestone.md do início ao fim.
+Preserve todos os checkpoints do workflow (determinação de escopo, leitura de verificações, checagem de integração, cobertura de requisitos, roteamento).
+</process>

package/kit/commands/auditar-uat.md

@@ -0,0 +1,24 @@
+---
+name: auditar-uat
+description: Auditoria multi-fase de todos os itens de UAT e verificação pendentes
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+---
+<objective>
+Verificar todas as fases em busca de itens de UAT pendentes, ignorados, bloqueados e que precisam de humano. Cruzar com a base de código para detectar documentação desatualizada. Produzir plano de testes humanos priorizado.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/audit-uat.md
+</execution_context>
+
+<context>
+Arquivos principais de planejamento são carregados no workflow via CLI.
+
+**Escopo:**
+Glob: .planning/phases/*/*-UAT.md
+Glob: .planning/phases/*/*-VERIFICATION.md
+</context>

package/kit/commands/autonomo.md

@@ -0,0 +1,41 @@
+---
+name: autonomo
+description: Executa todas as fases restantes de forma autônoma — discutir→planejar→executar por fase
+argument-hint: "[--from N]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+  - Task
+---
+<objective>
+Executa todas as fases restantes do milestone de forma autônoma. Para cada fase: discutir → planejar → executar. Pausa apenas para decisões do usuário (aceitação de área cinzenta, bloqueadores, solicitações de validação).
+
+Usa descoberta de fases do ROADMAP.md e invocações Skill() flat para cada comando de fase. Após todas as fases concluírem: auditoria de milestone → concluir → limpeza.
+
+**Cria/Atualiza:**
+- `.planning/STATE.md` — atualizado após cada fase
+- `.planning/ROADMAP.md` — progresso atualizado após cada fase
+- Artefatos de fase — CONTEXT.md, PLANOs, SUMMARYs por fase
+
+**Após:** O milestone está completo e limpo.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/autonomous.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Flag opcional: `--from N` — começar da fase N em vez da primeira fase incompleta.
+
+Contexto do projeto, lista de fases e estado são resolvidos dentro do workflow usando comandos init (`tools.cjs init milestone-op`, `tools.cjs roadmap analyze`). Sem carregamento prévio de contexto necessário.
+</context>
+
+<process>
+Execute o workflow autonomous de @./.claude/framework/workflows/autonomous.md do início ao fim.
+Preserve todos os checkpoints do workflow (descoberta de fases, execução por fase, tratamento de bloqueadores, exibição de progresso).
+</process>

package/kit/commands/branch-pr.md

@@ -0,0 +1,25 @@
+---
+name: branch-pr
+description: Cria um branch limpo para PR filtrando commits de .planning/ — pronto para revisão de código
+argument-hint: "[branch destino, padrão: main]"
+allowed-tools:
+  - Bash
+  - Read
+  - AskUserQuestion
+---
+
+<objective>
+Criar um branch limpo adequado para pull requests filtrando commits de .planning/
+do branch atual. Revisores veem apenas mudanças de código, não artefatos de planejamento framework.
+
+Isso resolve o problema de diffs de PR poluídos com mudanças de PLAN.md, SUMMARY.md, STATE.md
+que são irrelevantes para revisão de código.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/pr-branch.md
+</execution_context>
+
+<process>
+Execute o workflow pr-branch de @./.claude/framework/workflows/pr-branch.md do início ao fim.
+</process>

package/kit/commands/concluir-marco.md

@@ -0,0 +1,136 @@
+---
+type: prompt
+name: concluir-marco
+description: Arquiva milestone concluído e prepara para próxima versão
+argument-hint: <version>
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Marcar milestone {{version}} como completo, arquivar em milestones/ e atualizar ROADMAP.md e REQUIREMENTS.md.
+
+Propósito: Criar registro histórico da versão entregue, arquivar artefatos do milestone (roadmap + requisitos) e preparar para o próximo milestone.
+Saída: Milestone arquivado (roadmap + requisitos), PROJECT.md evoluído, tag git criado.
+</objective>
+
+<execution_context>
+**Carregar estes arquivos AGORA (antes de prosseguir):**
+
+- @./.claude/framework/workflows/complete-milestone.md (workflow principal)
+- @./.claude/framework/templates/milestone-archive.md (template de arquivo)
+  </execution_context>
+
+<context>
+**Arquivos do projeto:**
+- `.planning/ROADMAP.md`
+- `.planning/REQUIREMENTS.md`
+- `.planning/STATE.md`
+- `.planning/PROJECT.md`
+
+**Entrada do usuário:**
+
+- Versão: {{version}} (ex: "1.0", "1.1", "2.0")
+  </context>
+
+<process>
+
+**Seguir o workflow complete-milestone.md:**
+
+0. **Verificar auditoria:**
+
+   - Procurar `.planning/v{{version}}-MILESTONE-AUDIT.md`
+   - Se ausente ou desatualizado: recomendar `/auditar-marco` primeiro
+   - Se status da auditoria for `gaps_found`: recomendar `/planejar-lacunas` primeiro
+   - Se status da auditoria for `passed`: prosseguir para o passo 1
+
+   ```markdown
+   ## Verificação Pré-voo
+
+   {Se não houver v{{version}}-MILESTONE-AUDIT.md:}
+   ⚠ Nenhuma auditoria de milestone encontrada. Execute `/auditar-marco` primeiro para verificar
+   cobertura de requisitos, integração entre fases e fluxos E2E.
+
+   {Se a auditoria tiver lacunas:}
+   ⚠ Auditoria de milestone encontrou lacunas. Execute `/planejar-lacunas` para criar
+   fases que fechem as lacunas, ou prossiga assim mesmo para aceitar como dívida técnica.
+
+   {Se a auditoria passou:}
+   ✓ Auditoria de milestone aprovada. Prosseguindo com a conclusão.
+   ```
+
+1. **Verificar prontidão:**
+
+   - Checar se todas as fases do milestone têm planos concluídos (SUMMARY.md existe)
+   - Apresentar escopo e estatísticas do milestone
+   - Aguardar confirmação
+
+2. **Coletar estatísticas:**
+
+   - Contar fases, planos, tarefas
+   - Calcular intervalo git, alterações de arquivo, LOC
+   - Extrair cronograma do git log
+   - Apresentar resumo, confirmar
+
+3. **Extrair realizações:**
+
+   - Ler todos os arquivos SUMMARY.md das fases no intervalo do milestone
+   - Extrair 4-6 realizações principais
+   - Apresentar para aprovação
+
+4. **Arquivar milestone:**
+
+   - Criar `.planning/milestones/v{{version}}-ROADMAP.md`
+   - Extrair detalhes completos das fases do ROADMAP.md
+   - Preencher template milestone-archive.md
+   - Atualizar ROADMAP.md para resumo de uma linha com link
+
+5. **Arquivar requisitos:**
+
+   - Criar `.planning/milestones/v{{version}}-REQUIREMENTS.md`
+   - Marcar todos os requisitos v1 como completos (checkboxes marcados)
+   - Registrar resultados dos requisitos (validado, ajustado, descartado)
+   - Deletar `.planning/REQUIREMENTS.md` (novo será criado para o próximo milestone)
+
+6. **Atualizar PROJECT.md:**
+
+   - Adicionar seção "Estado Atual" com versão entregue
+   - Adicionar seção "Objetivos do Próximo Milestone"
+   - Arquivar conteúdo anterior em `<details>` (se v1.1+)
+
+7. **Commit e tag:**
+
+   - Stagear: MILESTONES.md, PROJECT.md, ROADMAP.md, STATE.md, arquivos de arquivo
+   - Commit: `chore: archive v{{version}} milestone`
+   - Tag: `git tag -a v{{version}} -m "[resumo do milestone]"`
+   - Perguntar sobre push da tag
+
+8. **Oferecer próximos passos:**
+   - `/novo-marco` — iniciar próximo milestone (questionamento → pesquisa → requisitos → roadmap)
+
+</process>
+
+<success_criteria>
+
+- Milestone arquivado em `.planning/milestones/v{{version}}-ROADMAP.md`
+- Requisitos arquivados em `.planning/milestones/v{{version}}-REQUIREMENTS.md`
+- `.planning/REQUIREMENTS.md` deletado (novo para próximo milestone)
+- ROADMAP.md colapsado para entrada de uma linha
+- PROJECT.md atualizado com estado atual
+- Tag git v{{version}} criado
+- Commit bem-sucedido
+- Usuário conhece os próximos passos (incluindo necessidade de novos requisitos)
+  </success_criteria>
+
+<critical_rules>
+
+- **Carregar workflow primeiro:** Ler complete-milestone.md antes de executar
+- **Verificar conclusão:** Todas as fases devem ter arquivos SUMMARY.md
+- **Confirmação do usuário:** Aguardar aprovação nos checkpoints de verificação
+- **Arquivar antes de deletar:** Sempre criar arquivos de arquivo antes de atualizar/deletar originais
+- **Resumo de uma linha:** Milestone colapsado no ROADMAP.md deve ser uma única linha com link
+- **Eficiência de contexto:** Arquivo mantém ROADMAP.md e REQUIREMENTS.md com tamanho constante por milestone
+- **Novos requisitos:** Próximo milestone começa com `/novo-marco` que inclui definição de requisitos
+  </critical_rules>

package/kit/commands/configuracoes.md

@@ -0,0 +1,36 @@
+---
+name: configuracoes
+description: Configura os toggles de workflow framework e perfil de modelo
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Configuração interativa de agentes de workflow framework e perfil de modelo via prompt de múltiplas perguntas.
+
+Roteia para o workflow settings que trata:
+- Garantia de existência de configuração
+- Leitura e análise das configurações atuais
+- Prompt interativo com 5 perguntas (modelo, research, plan_check, verifier, branching)
+- Mesclagem e escrita de configuração
+- Exibição de confirmação com referências de comandos rápidos
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/settings.md
+</execution_context>
+
+<process>
+**Seguir o workflow settings** de `@./.claude/framework/workflows/settings.md`.
+
+O workflow trata toda a lógica incluindo:
+1. Criação de arquivo de config com padrões se ausente
+2. Leitura da config atual
+3. Apresentação interativa de configurações com pré-seleção
+4. Análise de respostas e mesclagem de config
+5. Escrita de arquivo
+6. Exibição de confirmação
+</process>

package/kit/commands/definir-perfil.md

@@ -0,0 +1,12 @@
+---
+name: definir-perfil
+description: Altera o perfil de modelo para os agentes framework (quality/balanced/budget/inherit)
+argument-hint: <perfil (quality|balanced|budget|inherit)>
+model: haiku
+allowed-tools:
+  - Bash
+---
+
+Mostrar a seguinte saída ao usuário verbatim, sem comentários adicionais:
+
+!`node "./.claude/framework/bin/tools.cjs" config-set-model-profile $ARGUMENTS --raw`