@luanpdd/kit-mcp 0.2.1 → 0.3.0

package/kit/commands/revisar-backlog.md

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

package/kit/commands/revisar-ui.md

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

package/kit/commands/revisar.md

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

package/kit/commands/saude.md

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

package/kit/commands/setup-notion.md

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

package/kit/commands/sync-main.md

@@ -0,0 +1,68 @@
+---
+name: sync-main
+description: Atualiza a branch local com os commits da main. Se houver conflitos, pergunta qual priorizar.
+allowed-tools:
+  - Bash
+---
+
+<safety_rules>
+NUNCA execute git push para main ou origin/main.
+NUNCA mude para a branch main (git checkout main / git switch main).
+Este comando só traz código da main para a branch local — nunca o contrário.
+</safety_rules>
+
+<process>
+
+## 1 — Proteção: bloquear se estiver na main
+
+```bash
+git branch --show-current
+```
+
+Se a branch atual for `main`, encerre com:
+> "⛔ Você está na branch main. Mude para uma branch de feature antes de continuar."
+
+## 2 — Buscar atualizações e verificar se há algo novo
+
+```bash
+git fetch origin
+git log --oneline origin/main ^HEAD
+```
+
+Se não houver nenhum commit novo em `origin/main`, informe:
+> "Sua branch já está atualizada com a main."
+E encerre.
+
+## 3 — Aplicar os commits da main na branch local
+
+```bash
+git merge origin/main
+```
+
+### Se não houver conflitos:
+Mostre um resumo com:
+- Quantos commits foram integrados
+- Lista dos arquivos modificados (`git diff --name-only HEAD~1 HEAD` ou similar)
+
+Encerre.
+
+### Se houver conflitos:
+
+Liste os arquivos conflitantes e pergunte:
+> "Encontrei conflitos nos arquivos abaixo. Qual é a prioridade?
+> [1] main — usa o código da main nos conflitos
+> [2] local — mantém o seu código nos conflitos"
+
+Aguarde a resposta.
+
+**Se [1] main:**
+Para cada arquivo conflitante: `git checkout --theirs <arquivo>`
+Depois: `git add . && git commit`
+
+**Se [2] local:**
+Para cada arquivo conflitante: `git checkout --ours <arquivo>`
+Depois: `git add . && git commit`
+
+Mostre o resumo final: branch atual, status limpo, commits integrados.
+
+</process>

package/kit/commands/validar-fase.md

@@ -0,0 +1,35 @@
+---
+name: validar-fase
+description: Audita retroativamente e preenche lacunas de validação Nyquist para uma fase concluída
+argument-hint: "[número da fase]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Audita a cobertura de validação Nyquist para uma fase concluída. Três estados:
+- (A) VALIDATION.md existe — auditar e preencher lacunas
+- (B) Sem VALIDATION.md, SUMMARY.md existe — reconstruir a partir de artefatos
+- (C) Fase não executada — sair com orientação
+
+Saída: VALIDATION.md atualizado + arquivos de teste gerados.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/validate-phase.md
+</execution_context>
+
+<context>
+Fase: $ARGUMENTS — opcional, padrão é a última fase concluída.
+</context>
+
+<process>
+Execute @./.claude/framework/workflows/validate-phase.md.
+Preserve todos os gates do workflow.
+</process>

package/kit/commands/verificar-tarefas.md

@@ -0,0 +1,45 @@
+---
+name: verificar-tarefas
+description: Lista todos os todos pendentes e seleciona um para trabalhar
+argument-hint: [filtro de área]
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Lista todos os todos pendentes, permite seleção, carrega o contexto completo do todo selecionado e encaminha para a ação adequada.
+
+Encaminha para o workflow check-todos que cuida de:
+- Contagem e listagem de todos com filtro por área
+- Seleção interativa com carregamento completo de contexto
+- Checagem de correlação com roadmap
+- Roteamento de ação (trabalhar agora, adicionar à fase, brainstorm, criar fase)
+- Atualizações do STATE.md e commits git
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/check-todos.md
+</execution_context>
+
+<context>
+Argumentos: $ARGUMENTS (filtro de área opcional)
+
+Estado dos todos e correlação com roadmap são carregados no workflow usando `init todos` e leituras específicas.
+</context>
+
+<process>
+**Seguir o workflow check-todos** de `@./.claude/framework/workflows/check-todos.md`.
+
+O workflow cuida de toda a lógica, incluindo:
+1. Verificação de existência de todos
+2. Filtro por área
+3. Listagem e seleção interativa
+4. Carregamento completo de contexto com resumos de arquivo
+5. Checagem de correlação com roadmap
+6. Oferta e execução de ação
+7. Atualizações do STATE.md
+8. Commits git
+</process>

package/kit/commands/verificar-trabalho.md

@@ -0,0 +1,38 @@
+---
+name: verificar-trabalho
+description: Valida funcionalidades construídas através de UAT conversacional
+argument-hint: "[número da fase, ex: '4']"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Edit
+  - Write
+  - Task
+---
+<objective>
+Valida funcionalidades construídas através de testes conversacionais com estado persistente.
+
+Propósito: Confirmar que o que o Claude construiu realmente funciona da perspectiva do usuário. Um teste por vez, respostas em texto simples, sem interrogatório. Quando problemas são encontrados, automaticamente diagnostica, planeja correções e prepara para execução.
+
+Saída: {phase_num}-UAT.md rastreando todos os resultados de teste. Se problemas encontrados: lacunas diagnosticadas, planos de correção verificados prontos para /executar-fase
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/verify-work.md
+@./.claude/framework/templates/UAT.md
+</execution_context>
+
+<context>
+Fase: $ARGUMENTS (opcional)
+- Se fornecido: Testar fase específica (ex: "4")
+- Se não fornecido: Verificar sessões ativas ou solicitar fase
+
+Arquivos de contexto são resolvidos dentro do workflow (`init verify-work`) e delegados via blocos `<files_to_read>`.
+</context>
+
+<process>
+Execute o workflow verify-work de @./.claude/framework/workflows/verify-work.md do início ao fim.
+Preserve todos os gates do workflow (gerenciamento de sessão, apresentação de testes, diagnóstico, planejamento de correções, roteamento).
+</process>