@luanpdd/kit-mcp 0.2.1 → 0.4.0

package/kit/commands/pesquisar-fase.md

@@ -0,0 +1,195 @@
+---
+name: pesquisar-fase
+description: Pesquisa como implementar uma fase (standalone — geralmente use /planejar-fase)
+argument-hint: "[fase]"
+allowed-tools:
+  - Read
+  - Bash
+  - Task
+---
+
+<objective>
+Pesquisa como implementar uma fase. Invoca o agente phase-researcher com o contexto da fase.
+
+**Nota:** Este é um comando de pesquisa standalone. Para a maioria dos fluxos, use `/planejar-fase` que integra a pesquisa automaticamente.
+
+**Use este comando quando:**
+- Você quer pesquisar sem planejar ainda
+- Você quer re-pesquisar após o planejamento estar completo
+- Você precisa investigar antes de decidir se uma fase é viável
+
+**Papel do orquestrador:** Analisar fase, validar contra o roadmap, verificar pesquisa existente, reunir contexto, invocar agente pesquisador, apresentar resultados.
+
+**Por que subagente:** Pesquisa consome contexto rapidamente (WebSearch, consultas Context7, verificação de fontes). Contexto fresco de 200k para investigação. Contexto principal fica enxuto para interação com o usuário.
+</objective>
+
+<available_agent_types>
+Tipos de subagentes framework válidos (use nomes exatos — não use 'general-purpose' como fallback):
+- phase-researcher — Pesquisa abordagens técnicas para uma fase
+</available_agent_types>
+
+<context>
+Número da fase: $ARGUMENTS (obrigatório)
+
+Normalizar entrada da fase no passo 1 antes de qualquer busca de diretório.
+</context>
+
+<process>
+
+## 0. Inicializar Contexto
+
+```bash
+INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$ARGUMENTS")
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Extrair do JSON de init: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
+
+Resolver modelo do pesquisador:
+```bash
+RESEARCHER_MODEL=$(node "./.claude/framework/bin/tools.cjs" resolve-model phase-researcher --raw)
+```
+
+## 1. Validar Fase
+
+```bash
+PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${phase_number}")
+```
+
+**Se `found` for false:** Erro e sair. **Se `found` for true:** Extrair `phase_number`, `phase_name`, `goal` do JSON.
+
+## 2. Verificar Pesquisa Existente
+
+```bash
+ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
+```
+
+**Se existir:** Oferecer: 1) Atualizar pesquisa, 2) Ver existente, 3) Pular. Aguardar resposta.
+
+**Se não existir:** Continuar.
+
+## 3. Reunir Contexto da Fase
+
+Usar caminhos do INIT (não colocar conteúdo de arquivos inline no contexto do orquestrador):
+- `requirements_path`
+- `context_path`
+- `state_path`
+
+Apresentar resumo com descrição da fase e quais arquivos o pesquisador vai carregar.
+
+## 4. Invocar Agente phase-researcher
+
+Modos de pesquisa: ecosystem (padrão), feasibility, implementation, comparison.
+
+```markdown
+<research_type>
+Pesquisa de Fase — investigando COMO implementar uma fase específica bem.
+</research_type>
+
+<key_insight>
+A questão NÃO é "qual biblioteca devo usar?"
+
+A questão é: "O que eu não sei que não sei?"
+
+Para esta fase, descobrir:
+- Qual é o padrão de arquitetura estabelecido?
+- Quais bibliotecas formam o stack padrão?
+- Quais problemas as pessoas comumente encontram?
+- Qual é o SOTA vs o que o treinamento do Claude acha que é SOTA?
+- O que NÃO deve ser feito manualmente?
+</key_insight>
+
+<objective>
+Pesquisar abordagem de implementação para Fase {phase_number}: {phase_name}
+Modo: ecosystem
+</objective>
+
+<files_to_read>
+- {requirements_path} (Requisitos)
+- {context_path} (Contexto da fase do discutir-fase, se existir)
+- {state_path} (Decisões e bloqueadores anteriores do projeto)
+</files_to_read>
+
+<additional_context>
+**Descrição da fase:** {phase_description}
+</additional_context>
+
+<downstream_consumer>
+Seu RESEARCH.md será carregado pelo `/planejar-fase` que usa seções específicas:
+- `## Standard Stack` → Planos usam essas bibliotecas
+- `## Architecture Patterns` → Estrutura de tarefas segue esses padrões
+- `## Don't Hand-Roll` → Tarefas NUNCA constroem soluções customizadas para problemas listados
+- `## Common Pitfalls` → Etapas de verificação checam por esses problemas
+- `## Code Examples` → Ações de tarefas referenciam esses padrões
+
+Seja prescritivo, não exploratório. "Use X" não "Considere X ou Y."
+</downstream_consumer>
+
+<quality_gate>
+Antes de declarar completo, verificar:
+- [ ] Todos os domínios investigados (não apenas alguns)
+- [ ] Afirmações negativas verificadas com documentação oficial
+- [ ] Múltiplas fontes para afirmações críticas
+- [ ] Níveis de confiança atribuídos honestamente
+- [ ] Nomes de seções correspondem ao que o planejar-fase espera
+</quality_gate>
+
+<output>
+Escrever em: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
+</output>
+```
+
+```
+Task(
+  prompt=filled_prompt,
+  subagent_type="phase-researcher",
+  model="{researcher_model}",
+  description="Pesquisar Fase {phase}"
+)
+```
+
+## 5. Tratar Retorno do Agente
+
+**`## RESEARCH COMPLETE`:** Exibir resumo, oferecer: Planejar fase, Aprofundar, Revisar completo, Concluído.
+
+**`## CHECKPOINT REACHED`:** Apresentar ao usuário, obter resposta, invocar continuação.
+
+**`## RESEARCH INCONCLUSIVE`:** Mostrar o que foi tentado, oferecer: Adicionar contexto, Tentar modo diferente, Manual.
+
+## 6. Invocar Agente de Continuação
+
+```markdown
+<objective>
+Continuar pesquisa para Fase {phase_number}: {phase_name}
+</objective>
+
+<prior_state>
+<files_to_read>
+- .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Pesquisa existente)
+</files_to_read>
+</prior_state>
+
+<checkpoint_response>
+**Tipo:** {checkpoint_type}
+**Resposta:** {user_response}
+</checkpoint_response>
+```
+
+```
+Task(
+  prompt=continuation_prompt,
+  subagent_type="phase-researcher",
+  model="{researcher_model}",
+  description="Continuar pesquisa Fase {phase}"
+)
+```
+
+</process>
+
+<success_criteria>
+- [ ] Fase validada contra o roadmap
+- [ ] Pesquisa existente verificada
+- [ ] phase-researcher invocado com contexto
+- [ ] Checkpoints tratados corretamente
+- [ ] Usuário sabe os próximos passos
+</success_criteria>

package/kit/commands/planejar-fase.md

@@ -0,0 +1,47 @@
+---
+name: planejar-fase
+description: Cria plano detalhado da fase (PLAN.md) com loop de verificação
+argument-hint: "[phase] [--auto] [--research] [--skip-research] [--gaps] [--skip-verify] [--prd <file>] [--reviews] [--text]"
+agent: planner
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - WebFetch
+  - mcp__context7__*
+---
+<objective>
+Criar prompts de fase executáveis (arquivos PLAN.md) para uma fase do roadmap com pesquisa e verificação integradas.
+
+**Fluxo padrão:** Pesquisa (se necessário) → Planejar → Verificar → Concluído
+
+**Papel do orquestrador:** Analisar argumentos, validar fase, pesquisar domínio (a menos que pulado), invocar planner, verificar com plan-checker, iterar até aprovação ou máximo de iterações, apresentar resultados.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/plan-phase.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Número da fase: $ARGUMENTS (opcional — auto-detecta a próxima fase não planejada se omitido)
+
+**Flags:**
+- `--research` — Forçar re-pesquisa mesmo que RESEARCH.md exista
+- `--skip-research` — Pular pesquisa, ir direto para planejamento
+- `--gaps` — Modo de fechamento de lacunas (lê VERIFICATION.md, pula pesquisa)
+- `--skip-verify` — Pular loop de verificação
+- `--prd <file>` — Usar um arquivo PRD/critérios de aceite em vez de discutir-fase. Analisa requisitos em CONTEXT.md automaticamente. Pula discutir-fase completamente.
+- `--reviews` — Replanejar incorporando feedback de revisão cross-AI do REVIEWS.md (produzido por `/revisar`)
+- `--text` — Usar listas numeradas em texto simples em vez de menus TUI (necessário para sessões remotas `/rc`)
+
+Normalizar entrada da fase no passo 2 antes de qualquer pesquisa de diretório.
+</context>
+
+<process>
+Execute o workflow plan-phase de @./.claude/framework/workflows/plan-phase.md do início ao fim.
+Preserve todos os checkpoints do workflow (validação, pesquisa, planejamento, loop de verificação, roteamento).
+</process>

package/kit/commands/planejar-lacunas.md

@@ -0,0 +1,34 @@
+---
+name: planejar-lacunas
+description: Cria fases para fechar todas as lacunas identificadas pela auditoria de milestone
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+<objective>
+Criar todas as fases necessárias para fechar lacunas identificadas pelo `/auditar-marco`.
+
+Lê MILESTONE-AUDIT.md, agrupa lacunas em fases lógicas, cria entradas de fase no ROADMAP.md e oferece planejar cada fase.
+
+Um comando cria todas as fases de correção — sem `/adicionar-fase` manual por lacuna.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/plan-milestone-gaps.md
+</execution_context>
+
+<context>
+**Resultados da auditoria:**
+Glob: .planning/v*-MILESTONE-AUDIT.md (usar o mais recente)
+
+Intenção original e estado atual de planejamento são carregados sob demanda dentro do workflow.
+</context>
+
+<process>
+Execute o workflow plan-milestone-gaps de @./.claude/framework/workflows/plan-milestone-gaps.md do início ao fim.
+Preserve todos os checkpoints do workflow (carregamento de auditoria, priorização, agrupamento de fases, confirmação do usuário, atualizações de roadmap).
+</process>

package/kit/commands/plantar-ideia.md

@@ -0,0 +1,26 @@
+---
+name: plantar-ideia
+description: Captura uma ideia prospectiva com condições de gatilho — surge automaticamente no milestone certo
+argument-hint: "[resumo da ideia]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Capturar uma ideia grande demais para agora, mas que deve surgir automaticamente quando o milestone certo chegar. Seeds resolvem a deterioração de contexto: em vez de uma linha em Deferred que ninguém lê, uma seed preserva o WHY completo, QUANDO surgir e trilhas de pão para os detalhes.
+
+Cria: .planning/seeds/SEED-NNN-slug.md
+Consumido por: /novo-marco (escaneia seeds e apresenta correspondências)
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/plant-seed.md
+</execution_context>
+
+<process>
+Execute o workflow plant-seed de @./.claude/framework/workflows/plant-seed.md do início ao fim.
+</process>

package/kit/commands/progresso.md

@@ -0,0 +1,24 @@
+---
+name: progresso
+description: Verifica o progresso do projeto, mostra contexto e roteia para próxima ação (executar ou planejar)
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+  - SlashCommand
+---
+<objective>
+Verificar o progresso do projeto, resumir trabalho recente e o que está à frente, então rotear inteligentemente para a próxima ação — seja executar um plano existente ou criar o próximo.
+
+Fornece consciência situacional antes de continuar o trabalho.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/progress.md
+</execution_context>
+
+<process>
+Execute o workflow progress de @./.claude/framework/workflows/progress.md do início ao fim.
+Preserve toda a lógica de roteamento (Rotas A a F) e tratamento de casos extremos.
+</process>

package/kit/commands/proximo.md

@@ -0,0 +1,24 @@
+---
+name: proximo
+description: Avança automaticamente para o próximo passo lógico no workflow framework
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+  - SlashCommand
+---
+<objective>
+Detectar o estado atual do projeto e automaticamente invocar o próximo passo lógico do workflow framework.
+Sem argumentos necessários — lê STATE.md, ROADMAP.md e diretórios de fase para determinar o que vem a seguir.
+
+Projetado para workflows multi-projeto rápidos onde lembrar em qual fase/passo você está é overhead.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/next.md
+</execution_context>
+
+<process>
+Execute o workflow next de @./.claude/framework/workflows/next.md do início ao fim.
+</process>