@luanpdd/kit-mcp 1.30.1 → 1.31.0

package/kit/framework/workflows/remove-phase.md

@@ -1,155 +1,155 @@
-<purpose>
-Remove uma fase futura não iniciada do roadmap do projeto, exclui seu diretório, renumera todas as fases subsequentes para manter uma sequência linear limpa e commita a mudança. O commit git serve como registro histórico da remoção.
-</purpose>
-
-<required_reading>
-Leia todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
-</required_reading>
-
-<process>
-
-<step name="parse_arguments">
-Analise os argumentos do comando:
-- O argumento é o número da fase a remover (inteiro ou decimal)
-- Exemplo: `/remover-fase 17` → fase = 17
-- Exemplo: `/remover-fase 16.1` → fase = 16.1
-
-Se nenhum argumento fornecido:
-
-```
-ERRO: Número de fase obrigatório
-Uso: /remover-fase <número-da-fase>
-Exemplo: /remover-fase 17
-```
-
-Encerre.
-</step>
-
-<step name="init_context">
-Carregue o contexto de operação de fase:
-
-```bash
-INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "${target}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Extraia: `phase_found`, `phase_dir`, `phase_number`, `commit_docs`, `roadmap_exists`.
-
-Leia também o conteúdo do STATE.md e ROADMAP.md para analisar a posição atual.
-</step>
-
-<step name="validate_future_phase">
-Verifique se a fase é uma fase futura (não iniciada):
-
-1. Compare a fase alvo com a fase atual do STATE.md
-2. O alvo deve ser > número da fase atual
-
-Se alvo <= fase atual:
-
-```
-ERRO: Não é possível remover a Fase {alvo}
-
-Apenas fases futuras podem ser removidas:
-- Fase atual: {atual}
-- A Fase {alvo} é atual ou está concluída
-
-Para abandonar o trabalho atual, use /pausar-trabalho.
-```
-
-Encerre.
-</step>
-
-<step name="confirm_removal">
-Apresente o resumo da remoção e confirme:
-
-```
-Removendo Fase {alvo}: {Nome}
-
-Isso irá:
-- Excluir: .planning/phases/{alvo}-{slug}/
-- Renumerar todas as fases subsequentes
-- Atualizar: ROADMAP.md, STATE.md
-
-Prosseguir? (s/n)
-```
-
-Aguarde a confirmação.
-</step>
-
-<step name="execute_removal">
-**Delegue toda a operação de remoção ao tools:**
-
-```bash
-RESULT=$(node "./.claude/framework/bin/tools.cjs" phase remove "${target}")
-```
-
-Se a fase tiver planos executados (arquivos SUMMARY.md), tools retornará um erro. Use `--force` apenas se o usuário confirmar:
-
-```bash
-RESULT=$(node "./.claude/framework/bin/tools.cjs" phase remove "${target}" --force)
-```
-
-O CLI cuida de:
-- Excluir o diretório da fase
-- Renumerar todos os diretórios subsequentes (em ordem reversa para evitar conflitos)
-- Renomear todos os arquivos dentro dos diretórios renumerados (PLAN.md, SUMMARY.md, etc.)
-- Atualizar o ROADMAP.md (removendo a seção, renumerando todas as referências de fase, atualizando dependências)
-- Atualizar o STATE.md (decrementando a contagem de fases)
-
-Extraia do resultado: `removed`, `directory_deleted`, `renamed_directories`, `renamed_files`, `roadmap_updated`, `state_updated`.
-</step>
-
-<step name="commit">
-Stage e commit da remoção:
-
-```bash
-node "./.claude/framework/bin/tools.cjs" commit "chore: remover fase {alvo} ({nome-original-da-fase})" --files .planning/
-```
-
-A mensagem do commit preserva o registro histórico do que foi removido.
-</step>
-
-<step name="completion">
-Apresente o resumo de conclusão:
-
-```
-Fase {alvo} ({nome-original}) removida.
-
-Mudanças:
-- Excluído: .planning/phases/{alvo}-{slug}/
-- Renumerados: {N} diretórios e {M} arquivos
-- Atualizado: ROADMAP.md, STATE.md
-- Commitado: chore: remover fase {alvo} ({nome-original})
-
----
-
-## O Que Vem A Seguir
-
-Gostaria de:
-- `/progresso` — ver status do roadmap atualizado
-- Continuar com a fase atual
-- Revisar o roadmap
-
----
-```
-</step>
-
-</process>
-
-<anti_patterns>
-
-- Não remover fases concluídas (com arquivos SUMMARY.md) sem --force
-- Não remover fases atuais ou passadas
-- Não renumerar manualmente — use `tools phase remove` que trata toda a renumeração
-- Não adicionar notas de "fase removida" ao STATE.md — o commit git é o registro
-- Não modificar diretórios de fases concluídas
-</anti_patterns>
-
-<success_criteria>
-A remoção da fase está concluída quando:
-
-- [ ] Fase alvo validada como futura/não iniciada
-- [ ] `tools phase remove` executado com sucesso
-- [ ] Mudanças commitadas com mensagem descritiva
-- [ ] Usuário informado das mudanças
-</success_criteria>
+<purpose>
+Remove uma fase futura não iniciada do roadmap do projeto, exclui seu diretório, renumera todas as fases subsequentes para manter uma sequência linear limpa e commita a mudança. O commit git serve como registro histórico da remoção.
+</purpose>
+
+<required_reading>
+Leia todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
+</required_reading>
+
+<process>
+
+<step name="parse_arguments">
+Analise os argumentos do comando:
+- O argumento é o número da fase a remover (inteiro ou decimal)
+- Exemplo: `/remover-fase 17` → fase = 17
+- Exemplo: `/remover-fase 16.1` → fase = 16.1
+
+Se nenhum argumento fornecido:
+
+```
+ERRO: Número de fase obrigatório
+Uso: /remover-fase <número-da-fase>
+Exemplo: /remover-fase 17
+```
+
+Encerre.
+</step>
+
+<step name="init_context">
+Carregue o contexto de operação de fase:
+
+```bash
+INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "${target}")
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Extraia: `phase_found`, `phase_dir`, `phase_number`, `commit_docs`, `roadmap_exists`.
+
+Leia também o conteúdo do STATE.md e ROADMAP.md para analisar a posição atual.
+</step>
+
+<step name="validate_future_phase">
+Verifique se a fase é uma fase futura (não iniciada):
+
+1. Compare a fase alvo com a fase atual do STATE.md
+2. O alvo deve ser > número da fase atual
+
+Se alvo <= fase atual:
+
+```
+ERRO: Não é possível remover a Fase {alvo}
+
+Apenas fases futuras podem ser removidas:
+- Fase atual: {atual}
+- A Fase {alvo} é atual ou está concluída
+
+Para abandonar o trabalho atual, use /pausar-trabalho.
+```
+
+Encerre.
+</step>
+
+<step name="confirm_removal">
+Apresente o resumo da remoção e confirme:
+
+```
+Removendo Fase {alvo}: {Nome}
+
+Isso irá:
+- Excluir: .planning/phases/{alvo}-{slug}/
+- Renumerar todas as fases subsequentes
+- Atualizar: ROADMAP.md, STATE.md
+
+Prosseguir? (s/n)
+```
+
+Aguarde a confirmação.
+</step>
+
+<step name="execute_removal">
+**Delegue toda a operação de remoção ao tools:**
+
+```bash
+RESULT=$(node "./.claude/framework/bin/tools.cjs" phase remove "${target}")
+```
+
+Se a fase tiver planos executados (arquivos SUMMARY.md), tools retornará um erro. Use `--force` apenas se o usuário confirmar:
+
+```bash
+RESULT=$(node "./.claude/framework/bin/tools.cjs" phase remove "${target}" --force)
+```
+
+O CLI cuida de:
+- Excluir o diretório da fase
+- Renumerar todos os diretórios subsequentes (em ordem reversa para evitar conflitos)
+- Renomear todos os arquivos dentro dos diretórios renumerados (PLAN.md, SUMMARY.md, etc.)
+- Atualizar o ROADMAP.md (removendo a seção, renumerando todas as referências de fase, atualizando dependências)
+- Atualizar o STATE.md (decrementando a contagem de fases)
+
+Extraia do resultado: `removed`, `directory_deleted`, `renamed_directories`, `renamed_files`, `roadmap_updated`, `state_updated`.
+</step>
+
+<step name="commit">
+Stage e commit da remoção:
+
+```bash
+node "./.claude/framework/bin/tools.cjs" commit "chore: remover fase {alvo} ({nome-original-da-fase})" --files .planning/
+```
+
+A mensagem do commit preserva o registro histórico do que foi removido.
+</step>
+
+<step name="completion">
+Apresente o resumo de conclusão:
+
+```
+Fase {alvo} ({nome-original}) removida.
+
+Mudanças:
+- Excluído: .planning/phases/{alvo}-{slug}/
+- Renumerados: {N} diretórios e {M} arquivos
+- Atualizado: ROADMAP.md, STATE.md
+- Commitado: chore: remover fase {alvo} ({nome-original})
+
+---
+
+## O Que Vem A Seguir
+
+Gostaria de:
+- `/progresso` — ver status do roadmap atualizado
+- Continuar com a fase atual
+- Revisar o roadmap
+
+---
+```
+</step>
+
+</process>
+
+<anti_patterns>
+
+- Não remover fases concluídas (com arquivos SUMMARY.md) sem --force
+- Não remover fases atuais ou passadas
+- Não renumerar manualmente — use `tools phase remove` que trata toda a renumeração
+- Não adicionar notas de "fase removida" ao STATE.md — o commit git é o registro
+- Não modificar diretórios de fases concluídas
+</anti_patterns>
+
+<success_criteria>
+A remoção da fase está concluída quando:
+
+- [ ] Fase alvo validada como futura/não iniciada
+- [ ] `tools phase remove` executado com sucesso
+- [ ] Mudanças commitadas com mensagem descritiva
+- [ ] Usuário informado das mudanças
+</success_criteria>

package/kit/framework/workflows/remove-workspace.md

@@ -1,90 +1,90 @@
-<purpose>
-Remove um workspace framework, limpando git worktrees e excluindo o diretório do workspace.
-</purpose>
-
-<required_reading>
-Leia todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
-</required_reading>
-
-<process>
-
-## 1. Configuração
-
-Extraia o nome do workspace de $ARGUMENTS.
-
-```bash
-INIT=$(node "./.claude/framework/bin/tools.cjs" init remove-workspace "$WORKSPACE_NAME")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Analise o JSON para: `workspace_name`, `workspace_path`, `has_manifest`, `strategy`, `repos`, `repo_count`, `dirty_repos`, `has_dirty_repos`.
-
-**Se nenhum nome de workspace fornecido:**
-
-Primeiro execute `/listar-workspaces` para mostrar os workspaces disponíveis, depois pergunte:
-
-Use AskUserQuestion:
-- header: "Remover Workspace"
-- question: "Qual workspace você quer remover?"
-- requireAnswer: true
-
-Execute init novamente com o nome fornecido.
-
-## 2. Verificações de Segurança
-
-**Se `has_dirty_repos` for true:**
-
-```
-Não é possível remover o workspace "$WORKSPACE_NAME" — os seguintes repositórios têm mudanças não commitadas:
-
-  - repo1
-  - repo2
-
-Faça commit ou stash das mudanças nesses repositórios antes de remover o workspace:
-  cd $WORKSPACE_PATH/repo1
-  git stash   # ou git commit
-```
-
-Encerre. NÃO prossiga.
-
-## 3. Confirmar Remoção
-
-Use AskUserQuestion:
-- header: "Confirmar Remoção"
-- question: "Remover o workspace '$WORKSPACE_NAME' em $WORKSPACE_PATH? Isso excluirá todos os arquivos no diretório do workspace. Digite o nome do workspace para confirmar:"
-- requireAnswer: true
-
-**Se a resposta não corresponder a `$WORKSPACE_NAME`:** Encerre com "Remoção cancelada."
-
-## 4. Limpar Worktrees
-
-**Se a estratégia for `worktree`:**
-
-Para cada repositório no workspace:
-
-```bash
-cd "$SOURCE_REPO_PATH"
-git worktree remove "$WORKSPACE_PATH/$REPO_NAME" 2>&1 || true
-```
-
-Se `git worktree remove` falhar, avise mas continue:
-```
-Aviso: Não foi possível remover o worktree de $REPO_NAME — o repositório fonte pode ter sido movido ou excluído.
-```
-
-## 5. Excluir Diretório do Workspace
-
-```bash
-rm -rf "$WORKSPACE_PATH"
-```
-
-## 6. Relatório
-
-```
-Workspace "$WORKSPACE_NAME" removido.
-
-  Caminho: $WORKSPACE_PATH (excluído)
-  Repositórios: $REPO_COUNT worktrees limpos
-```
-
-</process>
+<purpose>
+Remove um workspace framework, limpando git worktrees e excluindo o diretório do workspace.
+</purpose>
+
+<required_reading>
+Leia todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
+</required_reading>
+
+<process>
+
+## 1. Configuração
+
+Extraia o nome do workspace de $ARGUMENTS.
+
+```bash
+INIT=$(node "./.claude/framework/bin/tools.cjs" init remove-workspace "$WORKSPACE_NAME")
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Analise o JSON para: `workspace_name`, `workspace_path`, `has_manifest`, `strategy`, `repos`, `repo_count`, `dirty_repos`, `has_dirty_repos`.
+
+**Se nenhum nome de workspace fornecido:**
+
+Primeiro execute `/listar-workspaces` para mostrar os workspaces disponíveis, depois pergunte:
+
+Use AskUserQuestion:
+- header: "Remover Workspace"
+- question: "Qual workspace você quer remover?"
+- requireAnswer: true
+
+Execute init novamente com o nome fornecido.
+
+## 2. Verificações de Segurança
+
+**Se `has_dirty_repos` for true:**
+
+```
+Não é possível remover o workspace "$WORKSPACE_NAME" — os seguintes repositórios têm mudanças não commitadas:
+
+  - repo1
+  - repo2
+
+Faça commit ou stash das mudanças nesses repositórios antes de remover o workspace:
+  cd $WORKSPACE_PATH/repo1
+  git stash   # ou git commit
+```
+
+Encerre. NÃO prossiga.
+
+## 3. Confirmar Remoção
+
+Use AskUserQuestion:
+- header: "Confirmar Remoção"
+- question: "Remover o workspace '$WORKSPACE_NAME' em $WORKSPACE_PATH? Isso excluirá todos os arquivos no diretório do workspace. Digite o nome do workspace para confirmar:"
+- requireAnswer: true
+
+**Se a resposta não corresponder a `$WORKSPACE_NAME`:** Encerre com "Remoção cancelada."
+
+## 4. Limpar Worktrees
+
+**Se a estratégia for `worktree`:**
+
+Para cada repositório no workspace:
+
+```bash
+cd "$SOURCE_REPO_PATH"
+git worktree remove "$WORKSPACE_PATH/$REPO_NAME" 2>&1 || true
+```
+
+Se `git worktree remove` falhar, avise mas continue:
+```
+Aviso: Não foi possível remover o worktree de $REPO_NAME — o repositório fonte pode ter sido movido ou excluído.
+```
+
+## 5. Excluir Diretório do Workspace
+
+```bash
+rm -rf "$WORKSPACE_PATH"
+```
+
+## 6. Relatório
+
+```
+Workspace "$WORKSPACE_NAME" removido.
+
+  Caminho: $WORKSPACE_PATH (excluído)
+  Repositórios: $REPO_COUNT worktrees limpos
+```
+
+</process>

package/kit/framework/workflows/research-phase.md

@@ -1,82 +1,82 @@
-<purpose>
-Pesquisa como implementar uma fase. Spawna phase-researcher com o contexto da fase.
-
-Comando de pesquisa independente. Para a maioria dos workflows, use `/planejar-fase` que integra a pesquisa automaticamente.
-</purpose>
-
-<available_agent_types>
-Tipos de subagente framework válidos (use os nomes exatos — não use 'general-purpose' como fallback):
-- phase-researcher — Pesquisa abordagens técnicas para uma fase
-</available_agent_types>
-
-<process>
-
-## Passo 0: Resolver Perfil de Modelo
-
-@./.claude/framework/references/model-profile-resolution.md
-
-Resolva o modelo para:
-- `phase-researcher`
-
-## Passo 1: Normalizar e Validar a Fase
-
-@./.claude/framework/references/phase-argument-parsing.md
-
-```bash
-PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${PHASE}")
-```
-
-Se `found` for false: Erro e encerre.
-
-## Passo 2: Verificar Pesquisa Existente
-
-```bash
-ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null || true
-```
-
-Se existir: Ofereça opções de atualizar/visualizar/pular.
-
-## Passo 3: Coletar Contexto da Fase
-
-```bash
-INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "${PHASE}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-# Extrair: phase_dir, padded_phase, phase_number, state_path, requirements_path, context_path
-AGENT_SKILLS_RESEARCHER=$(node "./.claude/framework/bin/tools.cjs" agent-skills researcher 2>/dev/null)
-```
-
-## Passo 4: Spawnar Pesquisador
-
-```
-Task(
-  prompt="<objective>
-Research implementation approach for Phase {phase}: {name}
-</objective>
-
-<files_to_read>
-- {context_path} (USER DECISIONS from /discuss-phase)
-- {requirements_path} (Project requirements)
-- {state_path} (Project decisions and history)
-</files_to_read>
-
-${AGENT_SKILLS_RESEARCHER}
-
-<additional_context>
-Phase description: {description}
-</additional_context>
-
-<output>
-Write to: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
-</output>",
-  subagent_type="phase-researcher",
-  model="{researcher_model}"
-)
-```
-
-## Passo 5: Tratar Retorno
-
-- `## RESEARCH COMPLETE` — Exibir resumo, oferecer: Planejar/Aprofundar/Revisar/Concluído
-- `## CHECKPOINT REACHED` — Apresentar ao usuário, spawnar continuação
-- `## RESEARCH INCONCLUSIVE` — Mostrar tentativas, oferecer: Adicionar contexto/Tentar modo diferente/Manual
-
-</process>
+<purpose>
+Pesquisa como implementar uma fase. Spawna phase-researcher com o contexto da fase.
+
+Comando de pesquisa independente. Para a maioria dos workflows, use `/planejar-fase` que integra a pesquisa automaticamente.
+</purpose>
+
+<available_agent_types>
+Tipos de subagente framework válidos (use os nomes exatos — não use 'general-purpose' como fallback):
+- phase-researcher — Pesquisa abordagens técnicas para uma fase
+</available_agent_types>
+
+<process>
+
+## Passo 0: Resolver Perfil de Modelo
+
+@./.claude/framework/references/model-profile-resolution.md
+
+Resolva o modelo para:
+- `phase-researcher`
+
+## Passo 1: Normalizar e Validar a Fase
+
+@./.claude/framework/references/phase-argument-parsing.md
+
+```bash
+PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${PHASE}")
+```
+
+Se `found` for false: Erro e encerre.
+
+## Passo 2: Verificar Pesquisa Existente
+
+```bash
+ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null || true
+```
+
+Se existir: Ofereça opções de atualizar/visualizar/pular.
+
+## Passo 3: Coletar Contexto da Fase
+
+```bash
+INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "${PHASE}")
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+# Extrair: phase_dir, padded_phase, phase_number, state_path, requirements_path, context_path
+AGENT_SKILLS_RESEARCHER=$(node "./.claude/framework/bin/tools.cjs" agent-skills researcher 2>/dev/null)
+```
+
+## Passo 4: Spawnar Pesquisador
+
+```
+Task(
+  prompt="<objective>
+Research implementation approach for Phase {phase}: {name}
+</objective>
+
+<files_to_read>
+- {context_path} (USER DECISIONS from /discuss-phase)
+- {requirements_path} (Project requirements)
+- {state_path} (Project decisions and history)
+</files_to_read>
+
+${AGENT_SKILLS_RESEARCHER}
+
+<additional_context>
+Phase description: {description}
+</additional_context>
+
+<output>
+Write to: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
+</output>",
+  subagent_type="phase-researcher",
+  model="{researcher_model}"
+)
+```
+
+## Passo 5: Tratar Retorno
+
+- `## RESEARCH COMPLETE` — Exibir resumo, oferecer: Planejar/Aprofundar/Revisar/Concluído
+- `## CHECKPOINT REACHED` — Apresentar ao usuário, spawnar continuação
+- `## RESEARCH INCONCLUSIVE` — Mostrar tentativas, oferecer: Adicionar contexto/Tentar modo diferente/Manual
+
+</process>