@luanpdd/kit-mcp 1.20.0 → 1.21.0

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

@@ -1,130 +1,130 @@
-<purpose>
-Inserir uma fase decimal para trabalho urgente descoberto no meio do milestone entre fases inteiras existentes. Usa numeração decimal (72.1, 72.2, etc.) para preservar a sequência lógica de fases planejadas enquanto acomoda inserções urgentes sem renumerar todo o roadmap.
-</purpose>
-
-<required_reading>
-Leia todos os arquivos referenciados pelo execution_context do prompt que invocou antes de começar.
-</required_reading>
-
-<process>
-
-<step name="parse_arguments">
-Analisar os argumentos do comando:
-- Primeiro argumento: número de fase inteiro após o qual inserir
-- Argumentos restantes: descrição da fase
-
-Exemplo: `/inserir-fase 72 Corrigir bug crítico de auth`
--> after = 72
--> description = "Corrigir bug crítico de auth"
-
-Se argumentos ausentes:
-
-```
-ERRO: Número de fase e descrição são obrigatórios
-Uso: /inserir-fase <após> <descrição>
-Exemplo: /inserir-fase 72 Corrigir bug crítico de auth
-```
-
-Sair.
-
-Validar que o primeiro argumento é um inteiro.
-</step>
-
-<step name="init_context">
-Carregar contexto de operação de fase:
-
-```bash
-INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "${after_phase}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Verificar `roadmap_exists` do JSON de init. Se falso:
-```
-ERRO: Nenhum roadmap encontrado (.planning/ROADMAP.md)
-```
-Sair.
-</step>
-
-<step name="insert_phase">
-**Delegar a inserção de fase ao tools:**
-
-```bash
-RESULT=$(node "./.claude/framework/bin/tools.cjs" phase insert "${after_phase}" "${description}")
-```
-
-A CLI cuida de:
-- Verificar se a fase alvo existe no ROADMAP.md
-- Calcular o próximo número decimal de fase (verificando decimais existentes no disco)
-- Gerar slug a partir da descrição
-- Criar o diretório de fase (`.planning/phases/{N.M}-{slug}/`)
-- Inserir a entrada de fase no ROADMAP.md após a fase alvo com marcador (INSERTED)
-
-Extrair do resultado: `phase_number`, `after_phase`, `name`, `slug`, `directory`.
-</step>
-
-<step name="update_project_state">
-Atualizar STATE.md para refletir a fase inserida:
-
-1. Ler `.planning/STATE.md`
-2. Em "## Accumulated Context" → "### Roadmap Evolution" adicionar entrada:
-   ```
-   - Fase {decimal_phase} inserida após Fase {after_phase}: {description} (URGENTE)
-   ```
-
-Se a seção "Roadmap Evolution" não existir, criá-la.
-</step>
-
-<step name="completion">
-Apresentar resumo de conclusão:
-
-```
-Fase {decimal_phase} inserida após Fase {after_phase}:
-- Descrição: {description}
-- Diretório: .planning/phases/{decimal-phase}-{slug}/
-- Status: Ainda não planejada
-- Marcador: (INSERTED) - indica trabalho urgente
-
-Roadmap atualizado: .planning/ROADMAP.md
-Estado do projeto atualizado: .planning/STATE.md
-
----
-
-## Próximo Passo
-
-**Fase {decimal_phase}: {description}** -- inserção urgente
-
-`/planejar-fase {decimal_phase}`
-
-<sub>`/clear` primeiro -> janela de contexto fresca</sub>
-
----
-
-**Também disponível:**
-- Revisar impacto da inserção: Verificar se as dependências da Fase {next_integer} ainda fazem sentido
-- Revisar roadmap
-
----
-```
-</step>
-
-</process>
-
-<anti_patterns>
-
-- Não use isto para trabalho planejado no final do milestone (use /adicionar-fase)
-- Não insira antes da Fase 1 (decimal 0.1 não faz sentido)
-- Não renumere fases existentes
-- Não modifique o conteúdo da fase alvo
-- Não crie planos ainda (isso é /planejar-fase)
-- Não commite mudanças (o usuário decide quando commitar)
-</anti_patterns>
-
-<success_criteria>
-A inserção de fase está completa quando:
-
-- [ ] `tools phase insert` executado com sucesso
-- [ ] Diretório de fase criado
-- [ ] Roadmap atualizado com nova entrada de fase (inclui marcador "(INSERTED)")
-- [ ] STATE.md atualizado com nota de evolução do roadmap
-- [ ] Usuário informado dos próximos passos e implicações de dependências
-</success_criteria>
+<purpose>
+Inserir uma fase decimal para trabalho urgente descoberto no meio do milestone entre fases inteiras existentes. Usa numeração decimal (72.1, 72.2, etc.) para preservar a sequência lógica de fases planejadas enquanto acomoda inserções urgentes sem renumerar todo o roadmap.
+</purpose>
+
+<required_reading>
+Leia todos os arquivos referenciados pelo execution_context do prompt que invocou antes de começar.
+</required_reading>
+
+<process>
+
+<step name="parse_arguments">
+Analisar os argumentos do comando:
+- Primeiro argumento: número de fase inteiro após o qual inserir
+- Argumentos restantes: descrição da fase
+
+Exemplo: `/inserir-fase 72 Corrigir bug crítico de auth`
+-> after = 72
+-> description = "Corrigir bug crítico de auth"
+
+Se argumentos ausentes:
+
+```
+ERRO: Número de fase e descrição são obrigatórios
+Uso: /inserir-fase <após> <descrição>
+Exemplo: /inserir-fase 72 Corrigir bug crítico de auth
+```
+
+Sair.
+
+Validar que o primeiro argumento é um inteiro.
+</step>
+
+<step name="init_context">
+Carregar contexto de operação de fase:
+
+```bash
+INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "${after_phase}")
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Verificar `roadmap_exists` do JSON de init. Se falso:
+```
+ERRO: Nenhum roadmap encontrado (.planning/ROADMAP.md)
+```
+Sair.
+</step>
+
+<step name="insert_phase">
+**Delegar a inserção de fase ao tools:**
+
+```bash
+RESULT=$(node "./.claude/framework/bin/tools.cjs" phase insert "${after_phase}" "${description}")
+```
+
+A CLI cuida de:
+- Verificar se a fase alvo existe no ROADMAP.md
+- Calcular o próximo número decimal de fase (verificando decimais existentes no disco)
+- Gerar slug a partir da descrição
+- Criar o diretório de fase (`.planning/phases/{N.M}-{slug}/`)
+- Inserir a entrada de fase no ROADMAP.md após a fase alvo com marcador (INSERTED)
+
+Extrair do resultado: `phase_number`, `after_phase`, `name`, `slug`, `directory`.
+</step>
+
+<step name="update_project_state">
+Atualizar STATE.md para refletir a fase inserida:
+
+1. Ler `.planning/STATE.md`
+2. Em "## Accumulated Context" → "### Roadmap Evolution" adicionar entrada:
+   ```
+   - Fase {decimal_phase} inserida após Fase {after_phase}: {description} (URGENTE)
+   ```
+
+Se a seção "Roadmap Evolution" não existir, criá-la.
+</step>
+
+<step name="completion">
+Apresentar resumo de conclusão:
+
+```
+Fase {decimal_phase} inserida após Fase {after_phase}:
+- Descrição: {description}
+- Diretório: .planning/phases/{decimal-phase}-{slug}/
+- Status: Ainda não planejada
+- Marcador: (INSERTED) - indica trabalho urgente
+
+Roadmap atualizado: .planning/ROADMAP.md
+Estado do projeto atualizado: .planning/STATE.md
+
+---
+
+## Próximo Passo
+
+**Fase {decimal_phase}: {description}** -- inserção urgente
+
+`/planejar-fase {decimal_phase}`
+
+<sub>`/clear` primeiro -> janela de contexto fresca</sub>
+
+---
+
+**Também disponível:**
+- Revisar impacto da inserção: Verificar se as dependências da Fase {next_integer} ainda fazem sentido
+- Revisar roadmap
+
+---
+```
+</step>
+
+</process>
+
+<anti_patterns>
+
+- Não use isto para trabalho planejado no final do milestone (use /adicionar-fase)
+- Não insira antes da Fase 1 (decimal 0.1 não faz sentido)
+- Não renumere fases existentes
+- Não modifique o conteúdo da fase alvo
+- Não crie planos ainda (isso é /planejar-fase)
+- Não commite mudanças (o usuário decide quando commitar)
+</anti_patterns>
+
+<success_criteria>
+A inserção de fase está completa quando:
+
+- [ ] `tools phase insert` executado com sucesso
+- [ ] Diretório de fase criado
+- [ ] Roadmap atualizado com nova entrada de fase (inclui marcador "(INSERTED)")
+- [ ] STATE.md atualizado com nota de evolução do roadmap
+- [ ] Usuário informado dos próximos passos e implicações de dependências
+</success_criteria>

package/kit/framework/workflows/list-phase-assumptions.md

@@ -1,178 +1,178 @@
-<purpose>
-Surfaçar as premissas do Claude sobre uma fase antes do planejamento, permitindo que os usuários corrijam equívocos cedo.
-
-Diferença principal do discutir-fase: Isso é ANÁLISE do que o Claude pensa, não COLETA do que o usuário sabe. Sem saída de arquivo — puramente conversacional para provocar discussão.
-</purpose>
-
-<process>
-
-<step name="validate_phase" priority="first">
-Número da fase: $ARGUMENTS (obrigatório)
-
-**Se argumento ausente:**
-
-```
-Erro: Número de fase obrigatório.
-
-Uso: /listar-hipoteses-fase [número-fase]
-Exemplo: /listar-hipoteses-fase 3
-```
-
-Sair do workflow.
-
-**Se argumento fornecido:**
-Validar que a fase existe no roadmap:
-
-```bash
-cat .planning/ROADMAP.md | grep -i "Phase ${PHASE}"
-```
-
-**Se fase não encontrada:**
-
-```
-Erro: Fase ${PHASE} não encontrada no roadmap.
-
-Fases disponíveis:
-[listar fases do roadmap]
-```
-
-Sair do workflow.
-
-**Se fase encontrada:**
-Analisar detalhes da fase do roadmap:
-
-- Número da fase
-- Nome da fase
-- Descrição/objetivo da fase
-- Quaisquer detalhes de escopo mencionados
-
-Continuar para analyze_phase.
-</step>
-
-<step name="analyze_phase">
-Com base na descrição do roadmap e contexto do projeto, identificar premissas em cinco áreas:
-
-**1. Abordagem Técnica:**
-Quais bibliotecas, frameworks, padrões ou ferramentas o Claude usaria?
-- "Eu usaria a biblioteca X porque..."
-- "Eu seguiria o padrão Y porque..."
-- "Eu estruturaria isso como Z porque..."
-
-**2. Ordem de Implementação:**
-O que o Claude construiria primeiro, segundo, terceiro?
-- "Eu começaria com X porque é fundamental"
-- "Então Y porque depende de X"
-- "Por fim Z porque..."
-
-**3. Limites de Escopo:**
-O que está incluído vs excluído na interpretação do Claude?
-- "Esta fase inclui: A, B, C"
-- "Esta fase NÃO inclui: D, E, F"
-- "Ambiguidades de limite: G pode ir para qualquer lado"
-
-**4. Áreas de Risco:**
-Onde o Claude espera complexidade ou desafios?
-- "A parte complicada é X porque..."
-- "Problemas potenciais: Y, Z"
-- "Eu ficaria de olho em..."
-
-**5. Dependências:**
-O que o Claude assume que existe ou precisa estar em vigor?
-- "Isso assume X de fases anteriores"
-- "Dependências externas: Y, Z"
-- "Isso será consumido por..."
-
-Seja honesto sobre incerteza. Marque premissas com níveis de confiança:
-- "Bastante confiante: ..." (claro no roadmap)
-- "Assumindo: ..." (inferência razoável)
-- "Incerto: ..." (pode ir por múltiplos caminhos)
-</step>
-
-<step name="present_assumptions">
-Apresentar premissas em formato claro e escaneável:
-
-```
-## Minhas Premissas para a Fase ${PHASE}: ${PHASE_NAME}
-
-### Abordagem Técnica
-[Listar premissas sobre como implementar]
-
-### Ordem de Implementação
-[Listar premissas sobre sequenciamento]
-
-### Limites de Escopo
-**No escopo:** [o que está incluído]
-**Fora do escopo:** [o que está excluído]
-**Ambíguo:** [o que pode ir para qualquer lado]
-
-### Áreas de Risco
-[Listar desafios antecipados]
-
-### Dependências
-**De fases anteriores:** [o que é necessário]
-**Externas:** [necessidades de terceiros]
-**Alimenta:** [o que fases futuras precisam disso]
-
----
-
-**O que você acha?**
-
-Essas premissas são precisas? Me diga:
-- O que eu acertei
-- O que eu errei
-- O que estou perdendo
-```
-
-Aguardar resposta do usuário.
-</step>
-
-<step name="gather_feedback">
-**Se o usuário fornece correções:**
-
-Reconhecer as correções:
-
-```
-Correções principais:
-- [correção 1]
-- [correção 2]
-
-Isso muda meu entendimento significativamente. [Resumir novo entendimento]
-```
-
-**Se o usuário confirma premissas:**
-
-```
-Premissas validadas.
-```
-
-Continuar para offer_next.
-</step>
-
-<step name="offer_next">
-Apresentar próximos passos:
-
-```
-O que vem a seguir?
-1. Discutir contexto (/discutir-fase ${PHASE}) - Deixe-me fazer perguntas para construir contexto abrangente
-2. Planejar esta fase (/planejar-fase ${PHASE}) - Criar planos de execução detalhados
-3. Re-examinar premissas - Analisarei novamente com suas correções
-4. Por ora é suficiente
-```
-
-Aguardar seleção do usuário.
-
-Se "Discutir contexto": Observar que CONTEXT.md incorporará quaisquer correções discutidas aqui
-Se "Planejar esta fase": Prosseguir sabendo que as premissas são compreendidas
-Se "Re-examinar": Retornar para analyze_phase com entendimento atualizado
-</step>
-
-</process>
-
-<success_criteria>
-- Número de fase validado contra o roadmap
-- Premissas surfaçadas em cinco áreas: abordagem técnica, ordem de implementação, escopo, riscos, dependências
-- Níveis de confiança marcados onde apropriado
-- Prompt "O que você acha?" apresentado
-- Feedback do usuário reconhecido
-- Próximos passos claros oferecidos
-</success_criteria>
+<purpose>
+Surfaçar as premissas do Claude sobre uma fase antes do planejamento, permitindo que os usuários corrijam equívocos cedo.
+
+Diferença principal do discutir-fase: Isso é ANÁLISE do que o Claude pensa, não COLETA do que o usuário sabe. Sem saída de arquivo — puramente conversacional para provocar discussão.
+</purpose>
+
+<process>
+
+<step name="validate_phase" priority="first">
+Número da fase: $ARGUMENTS (obrigatório)
+
+**Se argumento ausente:**
+
+```
+Erro: Número de fase obrigatório.
+
+Uso: /listar-hipoteses-fase [número-fase]
+Exemplo: /listar-hipoteses-fase 3
+```
+
+Sair do workflow.
+
+**Se argumento fornecido:**
+Validar que a fase existe no roadmap:
+
+```bash
+cat .planning/ROADMAP.md | grep -i "Phase ${PHASE}"
+```
+
+**Se fase não encontrada:**
+
+```
+Erro: Fase ${PHASE} não encontrada no roadmap.
+
+Fases disponíveis:
+[listar fases do roadmap]
+```
+
+Sair do workflow.
+
+**Se fase encontrada:**
+Analisar detalhes da fase do roadmap:
+
+- Número da fase
+- Nome da fase
+- Descrição/objetivo da fase
+- Quaisquer detalhes de escopo mencionados
+
+Continuar para analyze_phase.
+</step>
+
+<step name="analyze_phase">
+Com base na descrição do roadmap e contexto do projeto, identificar premissas em cinco áreas:
+
+**1. Abordagem Técnica:**
+Quais bibliotecas, frameworks, padrões ou ferramentas o Claude usaria?
+- "Eu usaria a biblioteca X porque..."
+- "Eu seguiria o padrão Y porque..."
+- "Eu estruturaria isso como Z porque..."
+
+**2. Ordem de Implementação:**
+O que o Claude construiria primeiro, segundo, terceiro?
+- "Eu começaria com X porque é fundamental"
+- "Então Y porque depende de X"
+- "Por fim Z porque..."
+
+**3. Limites de Escopo:**
+O que está incluído vs excluído na interpretação do Claude?
+- "Esta fase inclui: A, B, C"
+- "Esta fase NÃO inclui: D, E, F"
+- "Ambiguidades de limite: G pode ir para qualquer lado"
+
+**4. Áreas de Risco:**
+Onde o Claude espera complexidade ou desafios?
+- "A parte complicada é X porque..."
+- "Problemas potenciais: Y, Z"
+- "Eu ficaria de olho em..."
+
+**5. Dependências:**
+O que o Claude assume que existe ou precisa estar em vigor?
+- "Isso assume X de fases anteriores"
+- "Dependências externas: Y, Z"
+- "Isso será consumido por..."
+
+Seja honesto sobre incerteza. Marque premissas com níveis de confiança:
+- "Bastante confiante: ..." (claro no roadmap)
+- "Assumindo: ..." (inferência razoável)
+- "Incerto: ..." (pode ir por múltiplos caminhos)
+</step>
+
+<step name="present_assumptions">
+Apresentar premissas em formato claro e escaneável:
+
+```
+## Minhas Premissas para a Fase ${PHASE}: ${PHASE_NAME}
+
+### Abordagem Técnica
+[Listar premissas sobre como implementar]
+
+### Ordem de Implementação
+[Listar premissas sobre sequenciamento]
+
+### Limites de Escopo
+**No escopo:** [o que está incluído]
+**Fora do escopo:** [o que está excluído]
+**Ambíguo:** [o que pode ir para qualquer lado]
+
+### Áreas de Risco
+[Listar desafios antecipados]
+
+### Dependências
+**De fases anteriores:** [o que é necessário]
+**Externas:** [necessidades de terceiros]
+**Alimenta:** [o que fases futuras precisam disso]
+
+---
+
+**O que você acha?**
+
+Essas premissas são precisas? Me diga:
+- O que eu acertei
+- O que eu errei
+- O que estou perdendo
+```
+
+Aguardar resposta do usuário.
+</step>
+
+<step name="gather_feedback">
+**Se o usuário fornece correções:**
+
+Reconhecer as correções:
+
+```
+Correções principais:
+- [correção 1]
+- [correção 2]
+
+Isso muda meu entendimento significativamente. [Resumir novo entendimento]
+```
+
+**Se o usuário confirma premissas:**
+
+```
+Premissas validadas.
+```
+
+Continuar para offer_next.
+</step>
+
+<step name="offer_next">
+Apresentar próximos passos:
+
+```
+O que vem a seguir?
+1. Discutir contexto (/discutir-fase ${PHASE}) - Deixe-me fazer perguntas para construir contexto abrangente
+2. Planejar esta fase (/planejar-fase ${PHASE}) - Criar planos de execução detalhados
+3. Re-examinar premissas - Analisarei novamente com suas correções
+4. Por ora é suficiente
+```
+
+Aguardar seleção do usuário.
+
+Se "Discutir contexto": Observar que CONTEXT.md incorporará quaisquer correções discutidas aqui
+Se "Planejar esta fase": Prosseguir sabendo que as premissas são compreendidas
+Se "Re-examinar": Retornar para analyze_phase com entendimento atualizado
+</step>
+
+</process>
+
+<success_criteria>
+- Número de fase validado contra o roadmap
+- Premissas surfaçadas em cinco áreas: abordagem técnica, ordem de implementação, escopo, riscos, dependências
+- Níveis de confiança marcados onde apropriado
+- Prompt "O que você acha?" apresentado
+- Feedback do usuário reconhecido
+- Próximos passos claros oferecidos
+</success_criteria>