@luanpdd/kit-mcp 1.20.0 → 1.21.0

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>

package/kit/commands/setup-notion.md

@@ -1,93 +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.
+# /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

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