@luanpdd/kit-mcp 1.30.1 → 1.31.0

package/kit/commands/relatorio-sessao.md

@@ -1,19 +1,19 @@
----
-name: relatorio-sessao
-description: Gera relatório da sessão com estimativas de uso de tokens, resumo de trabalho e resultados
-allowed-tools:
-  - Read
-  - Bash
-  - Write
----
-<objective>
-Gera um documento SESSION_REPORT.md estruturado capturando resultados da sessão, trabalho realizado e uso estimado de recursos. Fornece um artefato compartilhável para revisão pós-sessão.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/session-report.md
-</execution_context>
-
-<process>
-Execute o workflow session-report de @./.claude/framework/workflows/session-report.md do início ao fim.
-</process>
+---
+name: relatorio-sessao
+description: Gera relatório da sessão com estimativas de uso de tokens, resumo de trabalho e resultados
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+---
+<objective>
+Gera um documento SESSION_REPORT.md estruturado capturando resultados da sessão, trabalho realizado e uso estimado de recursos. Fornece um artefato compartilhável para revisão pós-sessão.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/session-report.md
+</execution_context>
+
+<process>
+Execute o workflow session-report de @./.claude/framework/workflows/session-report.md do início ao fim.
+</process>

package/kit/commands/remover-fase.md

@@ -1,31 +1,31 @@
----
-name: remover-fase
-description: Remove uma fase futura do roadmap e renumera as fases subsequentes
-argument-hint: <phase-number>
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
----
-<objective>
-Remover uma fase futura não iniciada do roadmap e renumerar todas as fases subsequentes para manter uma sequência limpa e linear.
-
-Propósito: Remoção limpa de trabalho que você decidiu não fazer, sem poluir o contexto com marcadores cancelados/adiados.
-Saída: Fase deletada, todas as fases subsequentes renumeradas, commit git como registro histórico.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/remove-phase.md
-</execution_context>
-
-<context>
-Fase: $ARGUMENTS
-
-Roadmap e estado são resolvidos no workflow via `init phase-op` e leituras específicas.
-</context>
-
-<process>
-Execute o workflow remove-phase de @./.claude/framework/workflows/remove-phase.md do início ao fim.
-Preserve todos os checkpoints de validação (verificação de fase futura, verificação de trabalho), lógica de renumeração e commit.
-</process>
+---
+name: remover-fase
+description: Remove uma fase futura do roadmap e renumera as fases subsequentes
+argument-hint: <phase-number>
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+---
+<objective>
+Remover uma fase futura não iniciada do roadmap e renumerar todas as fases subsequentes para manter uma sequência limpa e linear.
+
+Propósito: Remoção limpa de trabalho que você decidiu não fazer, sem poluir o contexto com marcadores cancelados/adiados.
+Saída: Fase deletada, todas as fases subsequentes renumeradas, commit git como registro histórico.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/remove-phase.md
+</execution_context>
+
+<context>
+Fase: $ARGUMENTS
+
+Roadmap e estado são resolvidos no workflow via `init phase-op` e leituras específicas.
+</context>
+
+<process>
+Execute o workflow remove-phase de @./.claude/framework/workflows/remove-phase.md do início ao fim.
+Preserve todos os checkpoints de validação (verificação de fase futura, verificação de trabalho), lógica de renumeração e commit.
+</process>

package/kit/commands/remover-workspace.md

@@ -1,26 +1,26 @@
----
-name: remover-workspace
-description: Remove um workspace framework e limpa as worktrees
-argument-hint: "<nome-do-workspace>"
-allowed-tools:
-  - Bash
-  - Read
-  - AskUserQuestion
----
-<context>
-**Argumentos:**
-- `<nome-do-workspace>` (obrigatório) — Nome do workspace a remover
-</context>
-
-<objective>
-Remove um diretório de workspace após confirmação. Para estratégia de worktree, executa `git worktree remove` para cada repositório membro primeiro. Recusa se algum repositório tiver alterações não commitadas.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/remove-workspace.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<process>
-Execute o workflow remove-workspace de @./.claude/framework/workflows/remove-workspace.md do início ao fim.
-</process>
+---
+name: remover-workspace
+description: Remove um workspace framework e limpa as worktrees
+argument-hint: "<nome-do-workspace>"
+allowed-tools:
+  - Bash
+  - Read
+  - AskUserQuestion
+---
+<context>
+**Argumentos:**
+- `<nome-do-workspace>` (obrigatório) — Nome do workspace a remover
+</context>
+
+<objective>
+Remove um diretório de workspace após confirmação. Para estratégia de worktree, executa `git worktree remove` para cada repositório membro primeiro. Recusa se algum repositório tiver alterações não commitadas.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/remove-workspace.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<process>
+Execute o workflow remove-workspace de @./.claude/framework/workflows/remove-workspace.md do início ao fim.
+</process>

package/kit/commands/resumo-marco.md

@@ -1,51 +1,51 @@
----
-type: prompt
-name: resumo-marco
-description: Gera um resumo abrangente do projeto a partir dos artefatos do milestone para onboarding e revisão da equipe
-argument-hint: "[version]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Grep
-  - Glob
----
-
-<objective>
-Gerar um resumo estruturado do milestone para onboarding da equipe e revisão do projeto. Lê artefatos do milestone concluído (arquivos ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION) e produz uma visão geral amigável do que foi construído, como e por quê.
-
-Propósito: Permitir que novos membros da equipe entendam um projeto concluído lendo um documento e fazendo perguntas de acompanhamento.
-Saída: MILESTONE_SUMMARY escrito em `.planning/reports/`, apresentado inline, Q&A interativo opcional.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/milestone-summary.md
-</execution_context>
-
-<context>
-**Arquivos do projeto:**
-- `.planning/ROADMAP.md`
-- `.planning/PROJECT.md`
-- `.planning/STATE.md`
-- `.planning/RETROSPECTIVE.md`
-- `.planning/milestones/v{version}-ROADMAP.md` (se arquivado)
-- `.planning/milestones/v{version}-REQUIREMENTS.md` (se arquivado)
-- `.planning/phases/*-*/` (SUMMARY.md, VERIFICATION.md, CONTEXT.md, RESEARCH.md)
-
-**Entrada do usuário:**
-- Versão: $ARGUMENTS (opcional — padrão para milestone atual/mais recente)
-</context>
-
-<process>
-Ler e executar o workflow milestone-summary de @./.claude/framework/workflows/milestone-summary.md do início ao fim.
-</process>
-
-<success_criteria>
-- Versão do milestone resolvida (de argumentos, STATE.md ou scan de arquivo)
-- Todos os artefatos disponíveis lidos (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, RETROSPECTIVE)
-- Documento de resumo escrito em `.planning/reports/MILESTONE_SUMMARY-v{version}.md`
-- Todas as 7 seções geradas (Visão Geral, Arquitetura, Fases, Decisões, Requisitos, Dívida Técnica, Começando)
-- Resumo apresentado inline ao usuário
-- Q&A interativo oferecido
-- STATE.md atualizado
+---
+type: prompt
+name: resumo-marco
+description: Gera um resumo abrangente do projeto a partir dos artefatos do milestone para onboarding e revisão da equipe
+argument-hint: "[version]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+---
+
+<objective>
+Gerar um resumo estruturado do milestone para onboarding da equipe e revisão do projeto. Lê artefatos do milestone concluído (arquivos ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION) e produz uma visão geral amigável do que foi construído, como e por quê.
+
+Propósito: Permitir que novos membros da equipe entendam um projeto concluído lendo um documento e fazendo perguntas de acompanhamento.
+Saída: MILESTONE_SUMMARY escrito em `.planning/reports/`, apresentado inline, Q&A interativo opcional.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/milestone-summary.md
+</execution_context>
+
+<context>
+**Arquivos do projeto:**
+- `.planning/ROADMAP.md`
+- `.planning/PROJECT.md`
+- `.planning/STATE.md`
+- `.planning/RETROSPECTIVE.md`
+- `.planning/milestones/v{version}-ROADMAP.md` (se arquivado)
+- `.planning/milestones/v{version}-REQUIREMENTS.md` (se arquivado)
+- `.planning/phases/*-*/` (SUMMARY.md, VERIFICATION.md, CONTEXT.md, RESEARCH.md)
+
+**Entrada do usuário:**
+- Versão: $ARGUMENTS (opcional — padrão para milestone atual/mais recente)
+</context>
+
+<process>
+Ler e executar o workflow milestone-summary de @./.claude/framework/workflows/milestone-summary.md do início ao fim.
+</process>
+
+<success_criteria>
+- Versão do milestone resolvida (de argumentos, STATE.md ou scan de arquivo)
+- Todos os artefatos disponíveis lidos (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, RETROSPECTIVE)
+- Documento de resumo escrito em `.planning/reports/MILESTONE_SUMMARY-v{version}.md`
+- Todas as 7 seções geradas (Visão Geral, Arquitetura, Fases, Decisões, Requisitos, Dívida Técnica, Começando)
+- Resumo apresentado inline ao usuário
+- Q&A interativo oferecido
+- STATE.md atualizado
 </success_criteria>

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>