@luanpdd/kit-mcp 0.2.0 → 0.3.0

package/kit/commands/forense.md

@@ -0,0 +1,56 @@
+---
+type: prompt
+name: forense
+description: Investigação post-mortem de workflows framework com falha — analisa histórico git, artefatos e estado para diagnosticar o que deu errado
+argument-hint: "[descrição do problema]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+---
+
+<objective>
+Investigar o que deu errado durante a execução de um workflow framework. Analisa histórico git, artefatos `.planning/` e estado do sistema de arquivos para detectar anomalias e gerar um relatório diagnóstico estruturado.
+
+Propósito: Diagnosticar workflows com falha ou travados para que o usuário possa entender a causa raiz e tomar ação corretiva.
+Saída: Relatório forense salvo em `.planning/forensics/`, apresentado inline, com criação opcional de issue.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/forensics.md
+</execution_context>
+
+<context>
+**Fontes de dados:**
+- `git log` (commits recentes, padrões, lacunas de tempo)
+- `git status` / `git diff` (trabalho não commitado, conflitos)
+- `.planning/STATE.md` (posição atual, histórico de sessão)
+- `.planning/ROADMAP.md` (escopo e progresso das fases)
+- `.planning/phases/*/` (PLAN.md, SUMMARY.md, VERIFICATION.md, CONTEXT.md)
+- `.planning/reports/SESSION_REPORT.md` (resultados da última sessão)
+
+**Entrada do usuário:**
+- Descrição do problema: $ARGUMENTS (opcional — perguntará se não fornecido)
+</context>
+
+<process>
+Ler e executar o workflow forensics de @./.claude/framework/workflows/forensics.md do início ao fim.
+</process>
+
+<success_criteria>
+- Evidências coletadas de todas as fontes de dados disponíveis
+- Pelo menos 4 tipos de anomalia verificados (loop travado, artefatos ausentes, trabalho abandonado, crash/interrupção)
+- Relatório forense estruturado escrito em `.planning/forensics/report-{timestamp}.md`
+- Relatório apresentado inline com descobertas, anomalias e recomendações
+- Investigação interativa oferecida para análise mais profunda
+- Criação de issue no GitHub oferecida se existirem descobertas acionáveis
+</success_criteria>
+
+<critical_rules>
+- **Investigação somente leitura:** Não modificar arquivos fonte do projeto durante forense. Apenas escrever o relatório forense e atualizar rastreamento de sessão no STATE.md.
+- **Redigir dados sensíveis:** Remover caminhos absolutos, chaves de API, tokens de relatórios e issues.
+- **Fundamentar descobertas em evidências:** Toda anomalia deve citar commits, arquivos ou dados de estado específicos.
+- **Sem especulação sem evidência:** Se os dados forem insuficientes, diga isso — não fabrique causas raiz.
+</critical_rules>

package/kit/commands/gerenciador.md

@@ -0,0 +1,39 @@
+---
+name: gerenciador
+description: Central de comando interativa para gerenciar múltiplas fases em um terminal
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+  - Task
+---
+<objective>
+Central de comando em terminal único para gerenciar um milestone. Mostra um painel de todas as fases com indicadores visuais de status, recomenda as próximas ações ideais e despacha trabalho — discussão roda inline, planejamento/execução roda como agentes em segundo plano.
+
+Projetado para usuários avançados que querem paralelizar trabalho entre fases em um terminal: discutir uma fase enquanto outra planeja ou executa em segundo plano.
+
+**Cria/Atualiza:**
+- Nenhum arquivo criado diretamente — despacha para comandos do framework existentes via Skill() e agentes Task em segundo plano.
+- Lê `.planning/STATE.md`, `.planning/ROADMAP.md`, diretórios de fase para status.
+
+**Após:** Usuário sai quando terminar de gerenciar, ou todas as fases concluem e o ciclo de vida do milestone é sugerido.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/manager.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Sem argumentos necessários. Requer um milestone ativo com ROADMAP.md e STATE.md.
+
+Contexto do projeto, lista de fases, dependências e recomendações são resolvidos dentro do workflow usando `tools.cjs init manager`. Sem carregamento prévio de contexto necessário.
+</context>
+
+<process>
+Execute o workflow manager de @./.claude/framework/workflows/manager.md do início ao fim.
+Manter o loop de atualização do painel até que o usuário saia ou todas as fases concluam.
+</process>

package/kit/commands/inserir-fase.md

@@ -0,0 +1,32 @@
+---
+name: inserir-fase
+description: Insere trabalho urgente como fase decimal (ex: 72.1) entre fases existentes
+argument-hint: <after> <description>
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Inserir uma fase decimal para trabalho urgente descoberto no meio do milestone que deve ser concluído entre fases inteiras existentes.
+
+Usa numeração decimal (72.1, 72.2, etc.) para preservar a sequência lógica das fases planejadas enquanto acomoda inserções urgentes.
+
+Propósito: Lidar com trabalho urgente descoberto durante a execução sem renumerar todo o roadmap.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/insert-phase.md
+</execution_context>
+
+<context>
+Argumentos: $ARGUMENTS (formato: <número-da-fase-após> <descrição>)
+
+Roadmap e estado são resolvidos no workflow via `init phase-op` e chamadas de ferramentas específicas.
+</context>
+
+<process>
+Execute o workflow insert-phase de @./.claude/framework/workflows/insert-phase.md do início ao fim.
+Preserve todos os checkpoints de validação (análise de argumentos, verificação de fase, cálculo decimal, atualizações de roadmap).
+</process>

package/kit/commands/limpeza.md

@@ -0,0 +1,18 @@
+---
+name: limpeza
+description: Arquiva diretórios de fase acumulados de milestones concluídos
+---
+<objective>
+Arquiva diretórios de fase de milestones concluídos em `.planning/milestones/v{X.Y}-phases/`.
+
+Use quando `.planning/phases/` acumulou diretórios de milestones passados.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/cleanup.md
+</execution_context>
+
+<process>
+Seguir o workflow cleanup em @./.claude/framework/workflows/cleanup.md.
+Identificar milestones concluídos, mostrar um resumo de simulação e arquivar após confirmação.
+</process>

package/kit/commands/listar-hipoteses-fase.md

@@ -0,0 +1,46 @@
+---
+name: listar-hipoteses-fase
+description: Mostra as hipóteses do Claude sobre a abordagem de uma fase antes do planejamento
+argument-hint: "[phase]"
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+---
+
+<objective>
+Analisar uma fase e apresentar as hipóteses do Claude sobre abordagem técnica, ordem de implementação, limites de escopo, áreas de risco e dependências.
+
+Propósito: Ajudar usuários a ver o que o Claude pensa ANTES do planejamento começar — permitindo correção de curso cedo quando as hipóteses estão erradas.
+Saída: Apenas saída conversacional (sem criação de arquivo) — termina com o prompt "O que você acha?"
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/list-phase-assumptions.md
+</execution_context>
+
+<context>
+Número da fase: $ARGUMENTS (obrigatório)
+
+Estado do projeto e roadmap são carregados no workflow usando leituras específicas.
+</context>
+
+<process>
+1. Validar argumento de número de fase (erro se ausente ou inválido)
+2. Verificar se a fase existe no roadmap
+3. Seguir o workflow list-phase-assumptions.md:
+   - Analisar descrição do roadmap
+   - Apresentar hipóteses sobre: abordagem técnica, ordem de implementação, escopo, riscos, dependências
+   - Apresentar hipóteses claramente
+   - Perguntar "O que você acha?"
+4. Coletar feedback e oferecer próximos passos
+</process>
+
+<success_criteria>
+
+- Fase validada contra o roadmap
+- Hipóteses apresentadas em cinco áreas
+- Usuário solicitado a dar feedback
+- Usuário conhece próximos passos (discutir contexto, planejar fase ou corrigir hipóteses)
+  </success_criteria>

package/kit/commands/listar-workspaces.md

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

package/kit/commands/mapear-codebase.md

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

package/kit/commands/nota.md

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

package/kit/commands/novo-marco.md

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

package/kit/commands/novo-projeto.md

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

package/kit/commands/novo-workspace.md

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

package/kit/commands/pausar-trabalho.md

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

package/kit/commands/perfil-usuario.md

@@ -0,0 +1,46 @@
+---
+name: perfil-usuario
+description: Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude
+argument-hint: "[--questionnaire] [--refresh]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+  - Task
+---
+
+<objective>
+Gerar um perfil comportamental do desenvolvedor a partir de análise de sessão (ou questionário) e produzir artefatos (USER-PROFILE.md, /preferencias-dev, seção CLAUDE.md) que personalizam as respostas do Claude.
+
+Encaminha para o workflow profile-user que orquestra o fluxo completo: gate de consentimento, análise de sessão ou fallback de questionário, geração de perfil, exibição de resultados e seleção de artefatos.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/profile-user.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Flags de $ARGUMENTS:
+- `--questionnaire` -- Pular análise de sessão completamente, usar apenas questionário
+- `--refresh` -- Reconstruir perfil mesmo quando existe, fazer backup do perfil antigo, mostrar diff de dimensão
+</context>
+
+<process>
+Execute o workflow profile-user do início ao fim.
+
+O workflow cuida de toda a lógica, incluindo:
+1. Inicialização e detecção de perfil existente
+2. Gate de consentimento antes da análise de sessão
+3. Escaneamento de sessão e verificações de suficiência de dados
+4. Análise de sessão (agente profiler) ou fallback de questionário
+5. Resolução de divisão entre projetos
+6. Escrita do perfil em USER-PROFILE.md
+7. Exibição de resultado com card de relatório e destaques
+8. Seleção de artefato (preferencias-dev, seções CLAUDE.md)
+9. Geração sequencial de artefatos
+10. Resumo com diff de atualização (se aplicável)
+</process>