@luanpdd/kit-mcp 1.18.0 → 1.20.0

package/kit/commands/listar-workspaces.md

@@ -1,19 +1,19 @@
----
-name: listar-workspaces
-description: Lista os workspaces framework ativos e seu status
-allowed-tools:
-  - Bash
-  - Read
----
-<objective>
-Escanear `~/workspaces/` por diretórios de workspace contendo manifestos `WORKSPACE.md`. Exibir uma tabela resumo com nome, caminho, contagem de repos, estratégia e status do projeto framework.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/list-workspaces.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<process>
-Execute o workflow list-workspaces de @./.claude/framework/workflows/list-workspaces.md do início ao fim.
+---
+name: listar-workspaces
+description: Lista os workspaces framework ativos e seu status
+allowed-tools:
+  - Bash
+  - Read
+---
+<objective>
+Escanear `~/workspaces/` por diretórios de workspace contendo manifestos `WORKSPACE.md`. Exibir uma tabela resumo com nome, caminho, contagem de repos, estratégia e status do projeto framework.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/list-workspaces.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<process>
+Execute o workflow list-workspaces de @./.claude/framework/workflows/list-workspaces.md do início ao fim.
 </process>

package/kit/commands/mapear-codebase.md

@@ -1,71 +1,71 @@
----
-name: mapear-codebase
-description: Analisa a base de código com agentes mapeadores paralelos para produzir documentos em .planning/codebase/
-argument-hint: "[opcional: área específica para mapear, ex: 'api' ou 'auth']"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-<objective>
-Analisar a base de código existente usando agentes codebase-mapper paralelos para produzir documentos estruturados.
-
-Cada agente mapeador explora uma área de foco e **escreve documentos diretamente** em `.planning/codebase/`. O orquestrador recebe apenas confirmações, mantendo o uso de contexto mínimo.
-
-Saída: pasta .planning/codebase/ com 7 documentos estruturados sobre o estado da base de código.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/map-codebase.md
-</execution_context>
-
-<context>
-Área de foco: $ARGUMENTS (opcional - se fornecido, orienta os agentes a focar em um subsistema específico)
-
-**Carregar estado do projeto se existir:**
-Verificar .planning/STATE.md - carrega contexto se o projeto já foi inicializado
-
-**Este comando pode rodar:**
-- Antes de /novo-projeto (bases de código brownfield) - cria mapa da base de código primeiro
-- Após /novo-projeto (bases de código greenfield) - atualiza o mapa conforme o código evolui
-- A qualquer momento para atualizar a compreensão da base de código
-</context>
-
-<when_to_use>
-**Use mapear-codebase para:**
-- Projetos brownfield antes da inicialização (entender o código existente primeiro)
-- Atualizar mapa da base de código após mudanças significativas
-- Onboarding em uma base de código desconhecida
-- Antes de grandes refatorações (entender o estado atual)
-- Quando STATE.md referencia informações desatualizadas da base de código
-
-**Pule mapear-codebase para:**
-- Projetos greenfield sem código ainda (nada a mapear)
-- Bases de código triviais (menos de 5 arquivos)
-</when_to_use>
-
-<process>
-1. Verificar se .planning/codebase/ já existe (oferecer para atualizar ou pular)
-2. Criar estrutura de diretório .planning/codebase/
-3. Invocar 4 agentes codebase-mapper paralelos:
-   - Agente 1: foco tech → escreve STACK.md, INTEGRATIONS.md
-   - Agente 2: foco arch → escreve ARCHITECTURE.md, STRUCTURE.md
-   - Agente 3: foco quality → escreve CONVENTIONS.md, TESTING.md
-   - Agente 4: foco concerns → escreve CONCERNS.md
-4. Aguardar conclusão dos agentes, coletar confirmações (NÃO o conteúdo dos documentos)
-5. Verificar se todos os 7 documentos existem com contagem de linhas
-6. Commitar mapa da base de código
-7. Oferecer próximos passos (tipicamente: /novo-projeto ou /planejar-fase)
-</process>
-
-<success_criteria>
-- [ ] Diretório .planning/codebase/ criado
-- [ ] Todos os 7 documentos da base de código escritos pelos agentes mapeadores
-- [ ] Documentos seguem estrutura de template
-- [ ] Agentes paralelos concluíram sem erros
-- [ ] Usuário conhece próximos passos
+---
+name: mapear-codebase
+description: Analisa a base de código com agentes mapeadores paralelos para produzir documentos em .planning/codebase/
+argument-hint: "[opcional: área específica para mapear, ex: 'api' ou 'auth']"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+<objective>
+Analisar a base de código existente usando agentes codebase-mapper paralelos para produzir documentos estruturados.
+
+Cada agente mapeador explora uma área de foco e **escreve documentos diretamente** em `.planning/codebase/`. O orquestrador recebe apenas confirmações, mantendo o uso de contexto mínimo.
+
+Saída: pasta .planning/codebase/ com 7 documentos estruturados sobre o estado da base de código.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/map-codebase.md
+</execution_context>
+
+<context>
+Área de foco: $ARGUMENTS (opcional - se fornecido, orienta os agentes a focar em um subsistema específico)
+
+**Carregar estado do projeto se existir:**
+Verificar .planning/STATE.md - carrega contexto se o projeto já foi inicializado
+
+**Este comando pode rodar:**
+- Antes de /novo-projeto (bases de código brownfield) - cria mapa da base de código primeiro
+- Após /novo-projeto (bases de código greenfield) - atualiza o mapa conforme o código evolui
+- A qualquer momento para atualizar a compreensão da base de código
+</context>
+
+<when_to_use>
+**Use mapear-codebase para:**
+- Projetos brownfield antes da inicialização (entender o código existente primeiro)
+- Atualizar mapa da base de código após mudanças significativas
+- Onboarding em uma base de código desconhecida
+- Antes de grandes refatorações (entender o estado atual)
+- Quando STATE.md referencia informações desatualizadas da base de código
+
+**Pule mapear-codebase para:**
+- Projetos greenfield sem código ainda (nada a mapear)
+- Bases de código triviais (menos de 5 arquivos)
+</when_to_use>
+
+<process>
+1. Verificar se .planning/codebase/ já existe (oferecer para atualizar ou pular)
+2. Criar estrutura de diretório .planning/codebase/
+3. Invocar 4 agentes codebase-mapper paralelos:
+   - Agente 1: foco tech → escreve STACK.md, INTEGRATIONS.md
+   - Agente 2: foco arch → escreve ARCHITECTURE.md, STRUCTURE.md
+   - Agente 3: foco quality → escreve CONVENTIONS.md, TESTING.md
+   - Agente 4: foco concerns → escreve CONCERNS.md
+4. Aguardar conclusão dos agentes, coletar confirmações (NÃO o conteúdo dos documentos)
+5. Verificar se todos os 7 documentos existem com contagem de linhas
+6. Commitar mapa da base de código
+7. Oferecer próximos passos (tipicamente: /novo-projeto ou /planejar-fase)
+</process>
+
+<success_criteria>
+- [ ] Diretório .planning/codebase/ criado
+- [ ] Todos os 7 documentos da base de código escritos pelos agentes mapeadores
+- [ ] Documentos seguem estrutura de template
+- [ ] Agentes paralelos concluíram sem erros
+- [ ] Usuário conhece próximos passos
 </success_criteria>

package/kit/commands/nota.md

@@ -1,34 +1,34 @@
----
-name: nota
-description: Captura de ideias sem fricção. Adicionar, listar ou promover notas para todos.
-argument-hint: "<text> | list | promote <N> [--global]"
-allowed-tools:
-  - Read
-  - Write
-  - Glob
-  - Grep
----
-<objective>
-Captura de ideia sem fricção — uma chamada Write, uma linha de confirmação.
-
-Três subcomandos:
-- **append** (padrão): Salva um arquivo de nota com timestamp. Sem perguntas, sem formatação.
-- **list**: Mostra todas as notas dos escopos do projeto e global.
-- **promote**: Converte uma nota em um todo estruturado.
-
-Roda inline — sem Task, sem AskUserQuestion, sem Bash.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/note.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<context>
-$ARGUMENTS
-</context>
-
-<process>
-Execute o workflow note de @./.claude/framework/workflows/note.md do início ao fim.
-Capturar a nota, listar notas ou promover para todo — dependendo dos argumentos.
+---
+name: nota
+description: Captura de ideias sem fricção. Adicionar, listar ou promover notas para todos.
+argument-hint: "<text> | list | promote <N> [--global]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+---
+<objective>
+Captura de ideia sem fricção — uma chamada Write, uma linha de confirmação.
+
+Três subcomandos:
+- **append** (padrão): Salva um arquivo de nota com timestamp. Sem perguntas, sem formatação.
+- **list**: Mostra todas as notas dos escopos do projeto e global.
+- **promote**: Converte uma nota em um todo estruturado.
+
+Roda inline — sem Task, sem AskUserQuestion, sem Bash.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/note.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+</context>
+
+<process>
+Execute o workflow note de @./.claude/framework/workflows/note.md do início ao fim.
+Capturar a nota, listar notas ou promover para todo — dependendo dos argumentos.
 </process>

package/kit/commands/novo-marco.md

@@ -1,44 +1,44 @@
----
-name: novo-marco
-description: Inicia um novo ciclo de milestone — atualiza PROJECT.md e encaminha para requisitos
-argument-hint: "[nome do milestone, ex: 'v1.1 Notificações']"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Task
-  - AskUserQuestion
----
-<objective>
-Iniciar um novo milestone: questionamento → pesquisa (opcional) → requisitos → roadmap.
-
-Equivalente brownfield do novo-projeto. O projeto existe, PROJECT.md tem histórico. Reúne "o que vem a seguir", atualiza PROJECT.md, então executa o ciclo requisitos → roadmap.
-
-**Cria/Atualiza:**
-- `.planning/PROJECT.md` — atualizado com novos objetivos do milestone
-- `.planning/research/` — pesquisa de domínio (opcional, apenas para NOVOS recursos)
-- `.planning/REQUIREMENTS.md` — requisitos com escopo para este milestone
-- `.planning/ROADMAP.md` — estrutura de fases (continua numeração)
-- `.planning/STATE.md` — reiniciado para novo milestone
-
-**Após:** `/planejar-fase [N]` para iniciar a execução.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/new-milestone.md
-@./.claude/framework/references/questioning.md
-@./.claude/framework/references/ui-brand.md
-@./.claude/framework/templates/project.md
-@./.claude/framework/templates/requirements.md
-</execution_context>
-
-<context>
-Nome do milestone: $ARGUMENTS (opcional - solicitará se não fornecido)
-
-Arquivos de contexto do projeto e milestone são resolvidos dentro do workflow (`init new-milestone`) e delegados via blocos `<files_to_read>` onde subagentes são usados.
-</context>
-
-<process>
-Execute o workflow new-milestone de @./.claude/framework/workflows/new-milestone.md do início ao fim.
-Preserve todos os checkpoints do workflow (validação, questionamento, pesquisa, requisitos, aprovação do roadmap, commits).
+---
+name: novo-marco
+description: Inicia um novo ciclo de milestone — atualiza PROJECT.md e encaminha para requisitos
+argument-hint: "[nome do milestone, ex: 'v1.1 Notificações']"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Iniciar um novo milestone: questionamento → pesquisa (opcional) → requisitos → roadmap.
+
+Equivalente brownfield do novo-projeto. O projeto existe, PROJECT.md tem histórico. Reúne "o que vem a seguir", atualiza PROJECT.md, então executa o ciclo requisitos → roadmap.
+
+**Cria/Atualiza:**
+- `.planning/PROJECT.md` — atualizado com novos objetivos do milestone
+- `.planning/research/` — pesquisa de domínio (opcional, apenas para NOVOS recursos)
+- `.planning/REQUIREMENTS.md` — requisitos com escopo para este milestone
+- `.planning/ROADMAP.md` — estrutura de fases (continua numeração)
+- `.planning/STATE.md` — reiniciado para novo milestone
+
+**Após:** `/planejar-fase [N]` para iniciar a execução.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/new-milestone.md
+@./.claude/framework/references/questioning.md
+@./.claude/framework/references/ui-brand.md
+@./.claude/framework/templates/project.md
+@./.claude/framework/templates/requirements.md
+</execution_context>
+
+<context>
+Nome do milestone: $ARGUMENTS (opcional - solicitará se não fornecido)
+
+Arquivos de contexto do projeto e milestone são resolvidos dentro do workflow (`init new-milestone`) e delegados via blocos `<files_to_read>` onde subagentes são usados.
+</context>
+
+<process>
+Execute o workflow new-milestone de @./.claude/framework/workflows/new-milestone.md do início ao fim.
+Preserve todos os checkpoints do workflow (validação, questionamento, pesquisa, requisitos, aprovação do roadmap, commits).
 </process>

package/kit/commands/novo-projeto.md

@@ -1,42 +1,42 @@
----
-name: novo-projeto
-description: Inicializa um novo projeto com coleta profunda de contexto e PROJECT.md
-argument-hint: "[--auto]"
-allowed-tools:
-  - Read
-  - Bash
-  - Write
-  - Task
-  - AskUserQuestion
----
-<context>
-**Flags:**
-- `--auto` — Modo automático. Após perguntas de configuração, executa pesquisa → requisitos → roadmap sem mais interação. Espera documento de ideia via referência @.
-</context>
-
-<objective>
-Inicializar um novo projeto através do fluxo unificado: questionamento → pesquisa (opcional) → requisitos → roadmap.
-
-**Cria:**
-- `.planning/PROJECT.md` — contexto do projeto
-- `.planning/config.json` — preferências de workflow
-- `.planning/research/` — pesquisa de domínio (opcional)
-- `.planning/REQUIREMENTS.md` — requisitos com escopo
-- `.planning/ROADMAP.md` — estrutura de fases
-- `.planning/STATE.md` — memória do projeto
-
-**Após este comando:** Execute `/planejar-fase 1` para iniciar a execução.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/new-project.md
-@./.claude/framework/references/questioning.md
-@./.claude/framework/references/ui-brand.md
-@./.claude/framework/templates/project.md
-@./.claude/framework/templates/requirements.md
-</execution_context>
-
-<process>
-Execute o workflow new-project de @./.claude/framework/workflows/new-project.md do início ao fim.
-Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
+---
+name: novo-projeto
+description: Inicializa um novo projeto com coleta profunda de contexto e PROJECT.md
+argument-hint: "[--auto]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Task
+  - AskUserQuestion
+---
+<context>
+**Flags:**
+- `--auto` — Modo automático. Após perguntas de configuração, executa pesquisa → requisitos → roadmap sem mais interação. Espera documento de ideia via referência @.
+</context>
+
+<objective>
+Inicializar um novo projeto através do fluxo unificado: questionamento → pesquisa (opcional) → requisitos → roadmap.
+
+**Cria:**
+- `.planning/PROJECT.md` — contexto do projeto
+- `.planning/config.json` — preferências de workflow
+- `.planning/research/` — pesquisa de domínio (opcional)
+- `.planning/REQUIREMENTS.md` — requisitos com escopo
+- `.planning/ROADMAP.md` — estrutura de fases
+- `.planning/STATE.md` — memória do projeto
+
+**Após este comando:** Execute `/planejar-fase 1` para iniciar a execução.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/new-project.md
+@./.claude/framework/references/questioning.md
+@./.claude/framework/references/ui-brand.md
+@./.claude/framework/templates/project.md
+@./.claude/framework/templates/requirements.md
+</execution_context>
+
+<process>
+Execute o workflow new-project de @./.claude/framework/workflows/new-project.md do início ao fim.
+Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
 </process>

package/kit/commands/novo-workspace.md

@@ -1,44 +1,44 @@
----
-name: novo-workspace
-description: Cria um workspace isolado com cópias de repos e .planning/ independente
-argument-hint: "--name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]"
-allowed-tools:
-  - Read
-  - Bash
-  - Write
-  - AskUserQuestion
----
-<context>
-**Flags:**
-- `--name` (obrigatório) — Nome do workspace
-- `--repos` — Caminhos ou nomes de repos separados por vírgula. Se omitido, seleção interativa dos repos git filhos no cwd
-- `--path` — Diretório de destino. Padrão: `~/workspaces/<name>`
-- `--strategy` — `worktree` (padrão, leve) ou `clone` (totalmente independente)
-- `--branch` — Branch para fazer checkout. Padrão: `workspace/<name>`
-- `--auto` — Pular perguntas interativas, usar padrões
-</context>
-
-<objective>
-Criar um diretório de workspace físico contendo cópias dos repos git especificados (como worktrees ou clones) com um diretório `.planning/` independente para sessões framework isoladas.
-
-**Casos de uso:**
-- Orquestração multi-repo: trabalhar em um subconjunto de repos em paralelo com estado framework isolado
-- Isolamento de feature branch: criar um worktree do repo atual com seu próprio `.planning/`
-
-**Cria:**
-- `<path>/WORKSPACE.md` — manifesto do workspace
-- `<path>/.planning/` — diretório de planejamento independente
-- `<path>/<repo>/` — git worktree ou clone para cada repo especificado
-
-**Após este comando:** `cd` no workspace e execute `/novo-projeto` para inicializar o framework.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/new-workspace.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<process>
-Execute o workflow new-workspace de @./.claude/framework/workflows/new-workspace.md do início ao fim.
-Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
+---
+name: novo-workspace
+description: Cria um workspace isolado com cópias de repos e .planning/ independente
+argument-hint: "--name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - AskUserQuestion
+---
+<context>
+**Flags:**
+- `--name` (obrigatório) — Nome do workspace
+- `--repos` — Caminhos ou nomes de repos separados por vírgula. Se omitido, seleção interativa dos repos git filhos no cwd
+- `--path` — Diretório de destino. Padrão: `~/workspaces/<name>`
+- `--strategy` — `worktree` (padrão, leve) ou `clone` (totalmente independente)
+- `--branch` — Branch para fazer checkout. Padrão: `workspace/<name>`
+- `--auto` — Pular perguntas interativas, usar padrões
+</context>
+
+<objective>
+Criar um diretório de workspace físico contendo cópias dos repos git especificados (como worktrees ou clones) com um diretório `.planning/` independente para sessões framework isoladas.
+
+**Casos de uso:**
+- Orquestração multi-repo: trabalhar em um subconjunto de repos em paralelo com estado framework isolado
+- Isolamento de feature branch: criar um worktree do repo atual com seu próprio `.planning/`
+
+**Cria:**
+- `<path>/WORKSPACE.md` — manifesto do workspace
+- `<path>/.planning/` — diretório de planejamento independente
+- `<path>/<repo>/` — git worktree ou clone para cada repo especificado
+
+**Após este comando:** `cd` no workspace e execute `/novo-projeto` para inicializar o framework.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/new-workspace.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<process>
+Execute o workflow new-workspace de @./.claude/framework/workflows/new-workspace.md do início ao fim.
+Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
 </process>

package/kit/commands/pausar-trabalho.md

@@ -1,38 +1,38 @@
----
-name: pausar-trabalho
-description: Cria handoff de contexto ao pausar trabalho no meio de uma fase
-allowed-tools:
-  - Read
-  - Write
-  - Bash
----
-
-<objective>
-Criar arquivo de handoff `.continue-here.md` para preservar o estado completo do trabalho entre sessões.
-
-Encaminha para o workflow pause-work que cuida de:
-- Detecção da fase atual a partir de arquivos recentes
-- Coleta completa de estado (posição, trabalho concluído, trabalho restante, decisões, bloqueadores)
-- Criação do arquivo de handoff com todas as seções de contexto
-- Commit git como WIP
-- Instruções de retomada
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/pause-work.md
-</execution_context>
-
-<context>
-Estado e progresso da fase são coletados no workflow com leituras específicas.
-</context>
-
-<process>
-**Seguir o workflow pause-work** de `@./.claude/framework/workflows/pause-work.md`.
-
-O workflow cuida de toda a lógica, incluindo:
-1. Detecção do diretório de fase
-2. Coleta de estado com esclarecimentos do usuário
-3. Escrita do arquivo de handoff com timestamp
-4. Commit git
-5. Confirmação com instruções de retomada
+---
+name: pausar-trabalho
+description: Cria handoff de contexto ao pausar trabalho no meio de uma fase
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Criar arquivo de handoff `.continue-here.md` para preservar o estado completo do trabalho entre sessões.
+
+Encaminha para o workflow pause-work que cuida de:
+- Detecção da fase atual a partir de arquivos recentes
+- Coleta completa de estado (posição, trabalho concluído, trabalho restante, decisões, bloqueadores)
+- Criação do arquivo de handoff com todas as seções de contexto
+- Commit git como WIP
+- Instruções de retomada
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/pause-work.md
+</execution_context>
+
+<context>
+Estado e progresso da fase são coletados no workflow com leituras específicas.
+</context>
+
+<process>
+**Seguir o workflow pause-work** de `@./.claude/framework/workflows/pause-work.md`.
+
+O workflow cuida de toda a lógica, incluindo:
+1. Detecção do diretório de fase
+2. Coleta de estado com esclarecimentos do usuário
+3. Escrita do arquivo de handoff com timestamp
+4. Commit git
+5. Confirmação com instruções de retomada
 </process>