@luanpdd/kit-mcp 0.2.1 → 0.3.0

package/kit/framework/templates/discussion-log.md

@@ -0,0 +1,63 @@
+# Template de Log de Discussão
+
+Template para `.planning/phases/XX-name/{phase_num}-DISCUSSION-LOG.md` — trilha de auditoria das sessões de Q&A do discuss-phase.
+
+**Propósito:** Trilha de auditoria de software para tomada de decisão. Captura todas as opções consideradas, não apenas a selecionada. Separado do CONTEXT.md que é o artefato de implementação consumido por agentes downstream.
+
+**NÃO para consumo por LLM.** Este arquivo nunca deve ser referenciado em blocos `<files_to_read>` ou prompts de agentes.
+
+## Formato
+
+```markdown
+# Fase [X]: [Nome] - Log de Discussão
+
+> **Apenas trilha de auditoria.** Não usar como entrada para agentes de planejamento, pesquisa ou execução.
+> Decisões estão capturadas no CONTEXT.md — este log preserva as alternativas consideradas.
+
+**Data:** [data ISO]
+**Fase:** [número da fase]-[nome da fase]
+**Áreas discutidas:** [lista separada por vírgulas]
+
+---
+
+## [Nome da Área 1]
+
+| Opção | Descrição | Selecionada |
+|-------|-----------|-------------|
+| [Opção 1] | [Breve descrição] | |
+| [Opção 2] | [Breve descrição] | ✓ |
+| [Opção 3] | [Breve descrição] | |
+
+**Escolha do usuário:** [Opção selecionada ou resposta de texto livre literal]
+**Notas:** [Quaisquer esclarecimentos ou justificativas fornecidos durante a discussão]
+
+---
+
+## [Nome da Área 2]
+
+...
+
+---
+
+## A Critério do Claude
+
+[Áreas delegadas ao julgamento do Claude — listar o que foi diferido e por quê]
+
+## Ideias Diferidas
+
+[Ideias mencionadas mas fora do escopo desta fase]
+
+---
+
+*Fase: XX-nome*
+*Log de discussão gerado: [data]*
+```
+
+## Regras
+
+- Gerado automaticamente ao final de toda sessão do discuss-phase
+- Inclui TODAS as opções consideradas, não apenas a selecionada
+- Inclui notas e esclarecimentos em formato livre do usuário
+- Claramente marcado como apenas-auditoria, não um artefato de implementação
+- NÃO interfere com a geração do CONTEXT.md ou comportamento de agentes downstream
+- Comitado junto com CONTEXT.md no mesmo commit git

package/kit/framework/templates/milestone-archive.md

@@ -0,0 +1,123 @@
+# Template de Arquivo de Milestone
+
+Este template é usado pelo workflow complete-milestone para criar arquivos em `.planning/milestones/`.
+
+---
+
+## Template do Arquivo
+
+# Milestone v{{VERSION}}: {{MILESTONE_NAME}}
+
+**Status:** ✅ ENTREGUE {{DATE}}
+**Fases:** {{PHASE_START}}-{{PHASE_END}}
+**Total de Planos:** {{TOTAL_PLANS}}
+
+## Visão Geral
+
+{{MILESTONE_DESCRIPTION}}
+
+## Fases
+
+{{PHASES_SECTION}}
+
+[Para cada fase neste milestone, inclua:]
+
+### Fase {{PHASE_NUM}}: {{PHASE_NAME}}
+
+**Objetivo**: {{PHASE_GOAL}}
+**Depende de**: {{DEPENDS_ON}}
+**Planos**: {{PLAN_COUNT}} planos
+
+Planos:
+
+- [x] {{PHASE}}-01: {{PLAN_DESCRIPTION}}
+- [x] {{PHASE}}-02: {{PLAN_DESCRIPTION}}
+      [... todos os planos ...]
+
+**Detalhes:**
+{{PHASE_DETAILS_FROM_ROADMAP}}
+
+**Para fases decimais, inclua o marcador (INSERIDA):**
+
+### Fase 2.1: Patch de Segurança Crítico (INSERIDA)
+
+**Objetivo**: Corrigir vulnerabilidade de bypass de autenticação
+**Depende de**: Fase 2
+**Planos**: 1 plano
+
+Planos:
+
+- [x] 02.1-01: Corrigir vulnerabilidade de auth
+
+**Detalhes:**
+{{PHASE_DETAILS_FROM_ROADMAP}}
+
+---
+
+## Resumo do Milestone
+
+**Fases Decimais:**
+
+- Fase 2.1: Patch de Segurança Crítico (inserida após Fase 2 para correção urgente)
+- Fase 5.1: Hotfix de Performance (inserida após Fase 5 para problema em produção)
+
+**Decisões Chave:**
+{{DECISIONS_FROM_PROJECT_STATE}}
+[Exemplo:]
+
+- Decisão: Usar divisão do ROADMAP.md (Justificativa: Custo constante de contexto)
+- Decisão: Numeração de fases decimais (Justificativa: Semântica clara de inserção)
+
+**Problemas Resolvidos:**
+{{ISSUES_RESOLVED_DURING_MILESTONE}}
+[Exemplo:]
+
+- Corrigido overflow de contexto com mais de 100 fases
+- Resolvida confusão de inserção de fase
+
+**Problemas Diferidos:**
+{{ISSUES_DEFERRED_TO_LATER}}
+[Exemplo:]
+
+- Hierarquização do PROJECT-STATE.md (diferido até decisões > 300)
+
+**Dívida Técnica Incorrida:**
+{{SHORTCUTS_NEEDING_FUTURE_WORK}}
+[Exemplo:]
+
+- Alguns workflows ainda têm caminhos hardcoded (corrigir na Fase 5)
+
+---
+
+_Para o status atual do projeto, veja .planning/ROADMAP.md_
+
+---
+
+## Diretrizes de Uso
+
+<guidelines>
+**Quando criar arquivos de milestone:**
+- Após completar todas as fases em um milestone (v1.0, v1.1, v2.0, etc.)
+- Acionado pelo workflow complete-milestone
+- Antes de planejar o trabalho do próximo milestone
+
+**Como preencher o template:**
+
+- Substitua {{PLACEHOLDERS}} pelos valores reais
+- Extraia detalhes das fases do ROADMAP.md
+- Documente fases decimais com o marcador (INSERIDA)
+- Inclua decisões chave do PROJECT-STATE.md ou arquivos SUMMARY
+- Liste problemas resolvidos vs. diferidos
+- Capture dívida técnica para referência futura
+
+**Local do arquivo:**
+
+- Salve em `.planning/milestones/v{VERSION}-{NAME}.md`
+- Exemplo: `.planning/milestones/v1.0-mvp.md`
+
+**Após arquivar:**
+
+- Atualize ROADMAP.md para colapsar o milestone completo em uma tag `<details>`
+- Atualize PROJECT.md para o formato brownfield com seção de Estado Atual
+- Continue a numeração de fases no próximo milestone (nunca reiniciar em 01)
+  </guidelines>

package/kit/framework/templates/milestone.md

@@ -0,0 +1,115 @@
+# Template de Entrada de Milestone
+
+Adicione esta entrada em `.planning/MILESTONES.md` ao completar um milestone:
+
+```markdown
+## v[X.Y] [Nome] (Entregue: YYYY-MM-DD)
+
+**Entregue:** [Uma frase descrevendo o que foi lançado]
+
+**Fases concluídas:** [X-Y] ([Z] planos no total)
+
+**Principais conquistas:**
+- [Grande conquista 1]
+- [Grande conquista 2]
+- [Grande conquista 3]
+- [Grande conquista 4]
+
+**Estatísticas:**
+- [X] arquivos criados/modificados
+- [Y] linhas de código (linguagem principal)
+- [Z] fases, [N] planos, [M] tarefas
+- [D] dias do início ao lançamento (ou de milestone a milestone)
+
+**Intervalo git:** `feat(XX-XX)` → `feat(YY-YY)`
+
+**O que vem a seguir:** [Breve descrição dos objetivos do próximo milestone, ou "Projeto concluído"]
+
+---
+```
+
+<structure>
+Se MILESTONES.md não existir, crie-o com o cabeçalho:
+
+```markdown
+# Milestones do Projeto: [Nome do Projeto]
+
+[Entradas em ordem cronológica inversa — mais recente primeiro]
+```
+</structure>
+
+<guidelines>
+**Quando criar milestones:**
+- MVP v1.0 inicial lançado
+- Lançamentos de versão major (v2.0, v3.0)
+- Milestones de funcionalidades significativas (v1.1, v1.2)
+- Antes de arquivar o planejamento (capturar o que foi lançado)
+
+**Não criar milestones para:**
+- Conclusões de fases individuais (workflow normal)
+- Trabalho em andamento (aguardar até ser lançado)
+- Correções de bugs menores que não constituem um lançamento
+
+**Estatísticas a incluir:**
+- Contar arquivos modificados: `git diff --stat feat(XX-XX)..feat(YY-YY) | tail -1`
+- Contar LOC: `find . -name "*.swift" -o -name "*.ts" | xargs wc -l` (ou extensão relevante)
+- Contagens de fase/plano/tarefa do ROADMAP
+- Cronograma do primeiro commit da fase ao último commit da fase
+
+**Formato do intervalo git:**
+- Primeiro commit do milestone → último commit do milestone
+- Exemplo: `feat(01-01)` → `feat(04-01)` para fases 1-4
+</guidelines>
+
+<example>
+```markdown
+# Milestones do Projeto: WeatherBar
+
+## v1.1 Segurança & Polimento (Entregue: 2025-12-10)
+
+**Entregue:** Hardening de segurança com integração ao Keychain e tratamento abrangente de erros
+
+**Fases concluídas:** 5-6 (3 planos no total)
+
+**Principais conquistas:**
+- Migrou armazenamento de chave API de texto plano para macOS Keychain
+- Implementou tratamento abrangente de erros para falhas de rede
+- Adicionou integração de relatório de crashes com Sentry
+- Corrigiu vazamento de memória no timer de auto-refresh
+
+**Estatísticas:**
+- 23 arquivos modificados
+- 650 linhas de Swift adicionadas
+- 2 fases, 3 planos, 12 tarefas
+- 8 dias do v1.0 ao v1.1
+
+**Intervalo git:** `feat(05-01)` → `feat(06-02)`
+
+**O que vem a seguir:** redesign SwiftUI v2.0 com suporte a widgets
+
+---
+
+## v1.0 MVP (Entregue: 2025-11-25)
+
+**Entregue:** App de clima na barra de menu com condições atuais e previsão de 3 dias
+
+**Fases concluídas:** 1-4 (7 planos no total)
+
+**Principais conquistas:**
+- App na barra de menu com UI popover (AppKit)
+- Integração com OpenWeather API com auto-refresh
+- Exibição do clima atual com ícone de condições
+- Lista de previsão de 3 dias com temperaturas máx/mín
+- Assinado e notarizado para distribuição
+
+**Estatísticas:**
+- 47 arquivos criados
+- 2.450 linhas de Swift
+- 4 fases, 7 planos, 28 tarefas
+- 12 dias do início ao lançamento
+
+**Intervalo git:** `feat(01-01)` → `feat(04-01)`
+
+**O que vem a seguir:** auditoria de segurança e hardening para v1.1
+```
+</example>