@luanpdd/kit-mcp 1.27.0 → 1.28.0

package/kit/commands/rapido.md

@@ -1,36 +1,36 @@
----
-name: rapido
-description: Executa uma tarefa trivial inline — sem subagentes, sem overhead de planejamento
-argument-hint: "[descrição da tarefa]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Grep
-  - Glob
----
-
-<objective>
-Executa uma tarefa trivial diretamente no contexto atual sem invocar subagentes
-ou gerar arquivos PLAN.md. Para tarefas pequenas demais para justificar overhead de planejamento:
-correções de typo, mudanças de configuração, pequenas refatorações, commits esquecidos, adições simples.
-
-Este NÃO é um substituto para /expresso — use /expresso para qualquer coisa que
-precise de pesquisa, planejamento multi-etapas ou verificação. /rapido é para tarefas
-que você poderia descrever em uma frase e executar em menos de 2 minutos.
-
-## Quando usar
-
-- ✅ "renomear variável X pra Y", "ajustar copy do botão", "adicionar log", "fix de typo"
-- ❌ Multi-arquivo, multi-passo, requer pesquisa — use `/expresso` ou `/planejar-fase`
-- 🤔 Em dúvida sobre qual comando? → **`/fazer "descrição"`** roteia automaticamente
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/fast.md
-</execution_context>
-
-<process>
-Execute o workflow fast de @./.claude/framework/workflows/fast.md do início ao fim.
+---
+name: rapido
+description: Executa uma tarefa trivial inline — sem subagentes, sem overhead de planejamento
+argument-hint: "[descrição da tarefa]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Grep
+  - Glob
+---
+
+<objective>
+Executa uma tarefa trivial diretamente no contexto atual sem invocar subagentes
+ou gerar arquivos PLAN.md. Para tarefas pequenas demais para justificar overhead de planejamento:
+correções de typo, mudanças de configuração, pequenas refatorações, commits esquecidos, adições simples.
+
+Este NÃO é um substituto para /expresso — use /expresso para qualquer coisa que
+precise de pesquisa, planejamento multi-etapas ou verificação. /rapido é para tarefas
+que você poderia descrever em uma frase e executar em menos de 2 minutos.
+
+## Quando usar
+
+- ✅ "renomear variável X pra Y", "ajustar copy do botão", "adicionar log", "fix de typo"
+- ❌ Multi-arquivo, multi-passo, requer pesquisa — use `/expresso` ou `/planejar-fase`
+- 🤔 Em dúvida sobre qual comando? → **`/fazer "descrição"`** roteia automaticamente
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/fast.md
+</execution_context>
+
+<process>
+Execute o workflow fast de @./.claude/framework/workflows/fast.md do início ao fim.
 </process>

package/kit/commands/reaplicar-patches.md

@@ -1,124 +1,124 @@
----
-name: reaplicar-patches
-description: Reaplicar modificações locais após uma atualização do framework
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
----
-
-<purpose>
-Após uma atualização do framework limpar e reinstalar arquivos, este comando mescla as modificações locais salvas anteriormente pelo usuário de volta para a nova versão. Usa comparação inteligente para tratar casos onde o arquivo upstream também foi alterado.
-</purpose>
-
-<process>
-
-## Passo 1: Detectar patches com backup
-
-Verificar diretório de patches locais:
-
-```bash
-# Instalação global — detectar diretório de config do runtime
-if [ -d "$HOME/.config/opencode/local-patches" ]; then
-  PATCHES_DIR="$HOME/.config/opencode/local-patches"
-elif [ -d "$HOME/.opencode/local-patches" ]; then
-  PATCHES_DIR="$HOME/.opencode/local-patches"
-elif [ -d "$HOME/.gemini/local-patches" ]; then
-  PATCHES_DIR="$HOME/.gemini/local-patches"
-else
-  PATCHES_DIR="./.claude/local-patches"
-fi
-# Fallback para instalação local — verificar todos os diretórios de runtime
-if [ ! -d "$PATCHES_DIR" ]; then
-  for dir in .config/opencode .opencode .gemini .claude; do
-    if [ -d "./$dir/local-patches" ]; then
-      PATCHES_DIR="./$dir/local-patches"
-      break
-    fi
-  done
-fi
-```
-
-Ler `backup-meta.json` do diretório de patches.
-
-**Se nenhum patch encontrado:**
-```
-Nenhum patch local encontrado. Nada a reaplicar.
-
-Patches locais são salvos automaticamente quando você executa /atualizar
-após modificar qualquer workflow, comando ou arquivo de agente do framework.
-```
-Sair.
-
-## Passo 2: Mostrar resumo de patches
-
-```
-## Patches Locais para Reaplicar
-
-**Backup de:** v{from_version}
-**Versão atual:** {ler arquivo VERSION}
-**Arquivos modificados:** {contagem}
-
-| # | Arquivo | Status |
-|---|---------|--------|
-| 1 | {file_path} | Pendente |
-| 2 | {file_path} | Pendente |
-```
-
-## Passo 3: Mesclar cada arquivo
-
-Para cada arquivo em `backup-meta.json`:
-
-1. **Ler a versão com backup** (cópia modificada pelo usuário de `local-patches/`)
-2. **Ler a versão recém-instalada** (arquivo atual após atualização)
-3. **Comparar e mesclar:**
-
-   - Se o novo arquivo for idêntico ao arquivo com backup: pular (modificação foi incorporada upstream)
-   - Se o novo arquivo diferir: identificar as modificações do usuário e aplicá-las à nova versão
-
-   **Estratégia de mesclagem:**
-   - Ler ambas as versões completamente
-   - Identificar seções que o usuário adicionou ou modificou (procurar por adições, não apenas diferenças de substituição de caminho)
-   - Aplicar adições/modificações do usuário à nova versão
-   - Se uma seção que o usuário modificou também foi alterada upstream: sinalizar como conflito, mostrar ambas as versões, perguntar ao usuário qual manter
-
-4. **Escrever resultado mesclado** no local instalado
-5. **Reportar status:**
-   - `Mesclado` — modificações do usuário aplicadas corretamente
-   - `Pulado` — modificação já está upstream
-   - `Conflito` — usuário escolheu resolução
-
-## Passo 4: Atualizar manifesto
-
-Após reaplicar, regenerar o manifesto de arquivo para que futuras atualizações detectem corretamente estes como modificações do usuário:
-
-```bash
-# O manifesto será regenerado no próximo /atualizar
-# Por agora, apenas registrar quais arquivos foram modificados
-```
-
-## Passo 5: Opção de limpeza
-
-Perguntar ao usuário:
-- "Manter backups de patch para referência?" → preservar `local-patches/`
-- "Limpar backups de patch?" → remover diretório `local-patches/`
-
-## Passo 6: Relatório
-
-```
-## Patches Reaplicados
-
-| # | Arquivo | Status |
-|---|---------|--------|
-| 1 | {file_path} | ✓ Mesclado |
-| 2 | {file_path} | ○ Pulado (já está upstream) |
-| 3 | {file_path} | ⚠ Conflito resolvido |
-
-{contagem} arquivo(s) atualizado(s). Suas modificações locais estão ativas novamente.
-```
-
-</process>
-
-<success_criteria>
-- [ ] Todos os patches com backup processados
-- [ ] Modificações do usuário mescladas na nova versão
-- [ ] Conflitos resolvidos com entrada do usuário
-- [ ] Status reportado para cada arquivo
-</success_criteria>
+---
+name: reaplicar-patches
+description: Reaplicar modificações locais após uma atualização do framework
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
+---
+
+<purpose>
+Após uma atualização do framework limpar e reinstalar arquivos, este comando mescla as modificações locais salvas anteriormente pelo usuário de volta para a nova versão. Usa comparação inteligente para tratar casos onde o arquivo upstream também foi alterado.
+</purpose>
+
+<process>
+
+## Passo 1: Detectar patches com backup
+
+Verificar diretório de patches locais:
+
+```bash
+# Instalação global — detectar diretório de config do runtime
+if [ -d "$HOME/.config/opencode/local-patches" ]; then
+  PATCHES_DIR="$HOME/.config/opencode/local-patches"
+elif [ -d "$HOME/.opencode/local-patches" ]; then
+  PATCHES_DIR="$HOME/.opencode/local-patches"
+elif [ -d "$HOME/.gemini/local-patches" ]; then
+  PATCHES_DIR="$HOME/.gemini/local-patches"
+else
+  PATCHES_DIR="./.claude/local-patches"
+fi
+# Fallback para instalação local — verificar todos os diretórios de runtime
+if [ ! -d "$PATCHES_DIR" ]; then
+  for dir in .config/opencode .opencode .gemini .claude; do
+    if [ -d "./$dir/local-patches" ]; then
+      PATCHES_DIR="./$dir/local-patches"
+      break
+    fi
+  done
+fi
+```
+
+Ler `backup-meta.json` do diretório de patches.
+
+**Se nenhum patch encontrado:**
+```
+Nenhum patch local encontrado. Nada a reaplicar.
+
+Patches locais são salvos automaticamente quando você executa /atualizar
+após modificar qualquer workflow, comando ou arquivo de agente do framework.
+```
+Sair.
+
+## Passo 2: Mostrar resumo de patches
+
+```
+## Patches Locais para Reaplicar
+
+**Backup de:** v{from_version}
+**Versão atual:** {ler arquivo VERSION}
+**Arquivos modificados:** {contagem}
+
+| # | Arquivo | Status |
+|---|---------|--------|
+| 1 | {file_path} | Pendente |
+| 2 | {file_path} | Pendente |
+```
+
+## Passo 3: Mesclar cada arquivo
+
+Para cada arquivo em `backup-meta.json`:
+
+1. **Ler a versão com backup** (cópia modificada pelo usuário de `local-patches/`)
+2. **Ler a versão recém-instalada** (arquivo atual após atualização)
+3. **Comparar e mesclar:**
+
+   - Se o novo arquivo for idêntico ao arquivo com backup: pular (modificação foi incorporada upstream)
+   - Se o novo arquivo diferir: identificar as modificações do usuário e aplicá-las à nova versão
+
+   **Estratégia de mesclagem:**
+   - Ler ambas as versões completamente
+   - Identificar seções que o usuário adicionou ou modificou (procurar por adições, não apenas diferenças de substituição de caminho)
+   - Aplicar adições/modificações do usuário à nova versão
+   - Se uma seção que o usuário modificou também foi alterada upstream: sinalizar como conflito, mostrar ambas as versões, perguntar ao usuário qual manter
+
+4. **Escrever resultado mesclado** no local instalado
+5. **Reportar status:**
+   - `Mesclado` — modificações do usuário aplicadas corretamente
+   - `Pulado` — modificação já está upstream
+   - `Conflito` — usuário escolheu resolução
+
+## Passo 4: Atualizar manifesto
+
+Após reaplicar, regenerar o manifesto de arquivo para que futuras atualizações detectem corretamente estes como modificações do usuário:
+
+```bash
+# O manifesto será regenerado no próximo /atualizar
+# Por agora, apenas registrar quais arquivos foram modificados
+```
+
+## Passo 5: Opção de limpeza
+
+Perguntar ao usuário:
+- "Manter backups de patch para referência?" → preservar `local-patches/`
+- "Limpar backups de patch?" → remover diretório `local-patches/`
+
+## Passo 6: Relatório
+
+```
+## Patches Reaplicados
+
+| # | Arquivo | Status |
+|---|---------|--------|
+| 1 | {file_path} | ✓ Mesclado |
+| 2 | {file_path} | ○ Pulado (já está upstream) |
+| 3 | {file_path} | ⚠ Conflito resolvido |
+
+{contagem} arquivo(s) atualizado(s). Suas modificações locais estão ativas novamente.
+```
+
+</process>
+
+<success_criteria>
+- [ ] Todos os patches com backup processados
+- [ ] Modificações do usuário mescladas na nova versão
+- [ ] Conflitos resolvidos com entrada do usuário
+- [ ] Status reportado para cada arquivo
+</success_criteria>

package/kit/commands/refactor-seguro.md

@@ -1,6 +1,6 @@
 ---
 name: refactor-seguro
-description: Orquestrador de refactor seguro — chain canônico encontrar-seams → caracterizar → auditar-refactor → executar. Suporta modos --mode=full|sprout|safe-extract|override. Substitui edit-and-pray por cover-and-modify.
+description: Orquestrador de refactor seguro — chain canônico encontrar-seams → caracterizar → auditar-refactor → executar. Suporta modos --mode=full|sprout|safe-extract|override.
 argument-hint: "<target_file> [--mode full|sprout|safe-extract|override] [--ticket REQ-N] [--reason \"...\"] [--skip-seams] [--skip-characterize]"
 allowed-tools:
   - Read

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>