@luanpdd/kit-mcp 0.2.1 → 0.4.0

package/kit/framework/workflows/check-todos.md

@@ -0,0 +1,177 @@
+<purpose>
+Listar todos os todos pendentes, permitir seleção, carregar contexto completo do todo selecionado e encaminhar para a ação adequada.
+</purpose>
+
+<required_reading>
+Leia todos os arquivos referenciados pelo execution_context do prompt que invocou antes de começar.
+</required_reading>
+
+<process>
+
+<step name="init_context">
+Carregar contexto de todos:
+
+```bash
+INIT=$(node "./.claude/framework/bin/tools.cjs" init todos)
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Extrair do JSON de init: `todo_count`, `todos`, `pending_dir`.
+
+Se `todo_count` for 0:
+```
+Nenhum todo pendente.
+
+Todos são capturados durante sessões de trabalho com /adicionar-tarefa.
+
+---
+
+Deseja:
+
+1. Continuar com a fase atual (/progresso)
+2. Adicionar um todo agora (/adicionar-tarefa)
+```
+
+Sair.
+</step>
+
+<step name="parse_filter">
+Verificar filtro de área nos argumentos:
+- `/verificar-tarefas` → mostrar todos
+- `/verificar-tarefas api` → filtrar apenas para area:api
+</step>
+
+<step name="list_todos">
+Usar o array `todos` do contexto de init (já filtrado por área se especificado).
+
+Analisar e exibir como lista numerada:
+
+```
+Todos Pendentes:
+
+1. Adicionar refresh de token auth (api, há 2 dias)
+2. Corrigir problema de z-index do modal (ui, há 1 dia)
+3. Refatorar pool de conexão do banco de dados (database, há 5h)
+
+---
+
+Responda com um número para ver detalhes, ou:
+- `/verificar-tarefas [área]` para filtrar por área
+- `q` para sair
+```
+
+Formatar idade como tempo relativo a partir do timestamp criado.
+</step>
+
+<step name="handle_selection">
+Aguardar o usuário responder com um número.
+
+Se válido: carregar todo selecionado, prosseguir.
+Se inválido: "Seleção inválida. Responda com um número (1-[N]) ou `q` para sair."
+</step>
+
+<step name="load_context">
+Ler o arquivo de todo completamente. Exibir:
+
+```
+## [título]
+
+**Área:** [área]
+**Criado:** [data] (há [tempo relativo])
+**Arquivos:** [lista ou "Nenhum"]
+
+### Problema
+[conteúdo da seção de problema]
+
+### Solução
+[conteúdo da seção de solução]
+```
+
+Se o campo `files` tiver entradas, leia e resuma brevemente cada um.
+</step>
+
+<step name="check_roadmap">
+Verificar roadmap (pode usar init progress ou verificar existência de arquivo diretamente):
+
+Se `.planning/ROADMAP.md` existir:
+1. Verificar se a área do todo corresponde a uma fase futura
+2. Verificar se os arquivos do todo se sobrepõem ao escopo de uma fase
+3. Anotar qualquer correspondência para as opções de ação
+</step>
+
+<step name="offer_actions">
+**Se o todo mapear para uma fase do roadmap:**
+
+Usar AskUserQuestion:
+- header: "Ação"
+- question: "Este todo está relacionado à Fase [N]: [nome]. O que você gostaria de fazer?"
+- options:
+  - "Trabalhar nisso agora" — mover para feito, começar a trabalhar
+  - "Adicionar ao plano da fase" — incluir ao planejar a Fase [N]
+  - "Explorar abordagem" — pensar antes de decidir
+  - "Devolver" — retornar à lista
+
+**Se não houver correspondência no roadmap:**
+
+Usar AskUserQuestion:
+- header: "Ação"
+- question: "O que você gostaria de fazer com este todo?"
+- options:
+  - "Trabalhar nisso agora" — mover para feito, começar a trabalhar
+  - "Criar uma fase" — /adicionar-fase com este escopo
+  - "Explorar abordagem" — pensar antes de decidir
+  - "Devolver" — retornar à lista
+</step>
+
+<step name="execute_action">
+**Trabalhar nisso agora:**
+```bash
+mv ".planning/todos/pending/[filename]" ".planning/todos/done/"
+```
+Atualizar contagem de todos no STATE.md. Apresentar contexto do problema/solução. Começar o trabalho ou perguntar como prosseguir.
+
+**Adicionar ao plano da fase:**
+Anotar referência do todo nas notas de planejamento da fase. Manter no pendente. Retornar à lista ou sair.
+
+**Criar uma fase:**
+Exibir: `/adicionar-fase [descrição do todo]`
+Manter no pendente. Usuário executa o comando em contexto novo.
+
+**Explorar abordagem:**
+Manter no pendente. Iniciar discussão sobre o problema e abordagens.
+
+**Devolver:**
+Retornar ao passo list_todos.
+</step>
+
+<step name="update_state">
+Após qualquer ação que altere a contagem de todos:
+
+Re-executar `init todos` para obter contagem atualizada, depois atualizar seção "### Pending Todos" do STATE.md se existir.
+</step>
+
+<step name="git_commit">
+Se o todo foi movido para done/, commitar a mudança:
+
+```bash
+git rm --cached .planning/todos/pending/[filename] 2>/dev/null || true
+node "./.claude/framework/bin/tools.cjs" commit "docs: start work on todo - [título]" --files .planning/todos/done/[filename] .planning/STATE.md
+```
+
+A ferramenta respeita a configuração `commit_docs` e gitignore automaticamente.
+
+Confirmar: "Commitado: docs: start work on todo - [título]"
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Todos os todos pendentes listados com título, área, idade
+- [ ] Filtro de área aplicado se especificado
+- [ ] Contexto completo do todo selecionado carregado
+- [ ] Contexto do roadmap verificado para correspondência de fase
+- [ ] Ações adequadas oferecidas
+- [ ] Ação selecionada executada
+- [ ] STATE.md atualizado se contagem de todos mudou
+- [ ] Mudanças commitadas no git (se todo movido para done/)
+</success_criteria>

package/kit/framework/workflows/cleanup.md

@@ -0,0 +1,152 @@
+<purpose>
+
+Arquivar diretórios de fase acumulados de milestones concluídos em `.planning/milestones/v{X.Y}-phases/`. Identifica quais fases pertencem a cada milestone concluído, mostra um resumo de simulação e move os diretórios após confirmação.
+
+</purpose>
+
+<required_reading>
+
+1. `.planning/MILESTONES.md`
+2. Listagem do diretório `.planning/milestones/`
+3. Listagem do diretório `.planning/phases/`
+
+</required_reading>
+
+<process>
+
+<step name="identify_completed_milestones">
+
+Leia `.planning/MILESTONES.md` para identificar milestones concluídos e suas versões.
+
+```bash
+cat .planning/MILESTONES.md
+```
+
+Extrair cada versão de milestone (ex: v1.0, v1.1, v2.0).
+
+Verificar quais diretórios de arquivo de milestone já existem:
+
+```bash
+ls -d .planning/milestones/v*-phases 2>/dev/null || true
+```
+
+Filtrar para milestones que NÃO têm ainda um diretório de arquivo `-phases`.
+
+Se todos os milestones já tiverem arquivos de fase:
+
+```
+Todos os milestones concluídos já têm diretórios de fase arquivados. Nada para limpar.
+```
+
+Parar aqui.
+
+</step>
+
+<step name="determine_phase_membership">
+
+Para cada milestone concluído sem arquivo `-phases`, leia o snapshot de ROADMAP arquivado para determinar quais fases pertencem a ele:
+
+```bash
+cat .planning/milestones/v{X.Y}-ROADMAP.md
+```
+
+Extrair números e nomes de fase do roadmap arquivado (ex: Fase 1: Foundation, Fase 2: Auth).
+
+Verificar quais desses diretórios de fase ainda existem em `.planning/phases/`:
+
+```bash
+ls -d .planning/phases/*/ 2>/dev/null || true
+```
+
+Corresponder diretórios de fase à associação de milestone. Incluir apenas diretórios que ainda existem em `.planning/phases/`.
+
+</step>
+
+<step name="show_dry_run">
+
+Apresentar um resumo de simulação para cada milestone:
+
+```
+## Resumo de Limpeza
+
+### v{X.Y} — {Nome do Milestone}
+Estes diretórios de fase serão arquivados:
+- 01-foundation/
+- 02-auth/
+- 03-core-features/
+
+Destino: .planning/milestones/v{X.Y}-phases/
+
+### v{X.Z} — {Nome do Milestone}
+Estes diretórios de fase serão arquivados:
+- 04-security/
+- 05-hardening/
+
+Destino: .planning/milestones/v{X.Z}-phases/
+```
+
+Se nenhum diretório de fase permanecer para arquivar (todos já movidos ou deletados):
+
+```
+Nenhum diretório de fase encontrado para arquivar. As fases podem ter sido removidas ou arquivadas anteriormente.
+```
+
+Parar aqui.
+
+AskUserQuestion: "Prosseguir com o arquivamento?" com opções: "Sim — arquivar fases listadas" | "Cancelar"
+
+Se "Cancelar": Parar.
+
+</step>
+
+<step name="archive_phases">
+
+Para cada milestone, mover diretórios de fase:
+
+```bash
+mkdir -p .planning/milestones/v{X.Y}-phases
+```
+
+Para cada diretório de fase pertencente a este milestone:
+
+```bash
+mv .planning/phases/{dir} .planning/milestones/v{X.Y}-phases/
+```
+
+Repetir para todos os milestones no conjunto de limpeza.
+
+</step>
+
+<step name="commit">
+
+Commitar as mudanças:
+
+```bash
+node "./.claude/framework/bin/tools.cjs" commit "chore: archive phase directories from completed milestones" --files .planning/milestones/ .planning/phases/
+```
+
+</step>
+
+<step name="report">
+
+```
+Arquivado:
+{Para cada milestone}
+- v{X.Y}: {N} diretórios de fase → .planning/milestones/v{X.Y}-phases/
+
+.planning/phases/ limpo.
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+
+- [ ] Todos os milestones concluídos sem arquivos de fase existentes identificados
+- [ ] Associação de fase determinada a partir de snapshots de ROADMAP arquivados
+- [ ] Resumo de simulação mostrado e confirmado pelo usuário
+- [ ] Diretórios de fase movidos para `.planning/milestones/v{X.Y}-phases/`
+- [ ] Mudanças commitadas
+
+</success_criteria>