@luanpdd/kit-mcp 1.20.0 → 1.21.0

package/kit/framework/templates/discovery.md

@@ -1,146 +1,146 @@
-# Template de Discovery
-
-Template para `.planning/phases/XX-name/DISCOVERY.md` - pesquisa rasa para decisões de biblioteca/opção.
-
-**Propósito:** Responder perguntas "qual biblioteca/opção devemos usar" durante a discovery obrigatória no plan-phase.
-
-Para pesquisa profunda de ecossistema ("como especialistas constroem isso"), use `/research-phase` que produz RESEARCH.md.
-
----
-
-## Template do Arquivo
-
-```markdown
----
-phase: XX-name
-type: discovery
-topic: [discovery-topic]
----
-
-<session_initialization>
-Before beginning discovery, verify today's date:
-!`date +%Y-%m-%d`
-
-Use this date when searching for "current" or "latest" information.
-Example: If today is 2025-11-22, search for "2025" not "2024".
-</session_initialization>
-
-<discovery_objective>
-Discover [topic] to inform [phase name] implementation.
-
-Purpose: [What decision/implementation this enables]
-Scope: [Boundaries]
-Output: DISCOVERY.md with recommendation
-</discovery_objective>
-
-<discovery_scope>
-<include>
-- [Question to answer]
-- [Area to investigate]
-- [Specific comparison if needed]
-</include>
-
-<exclude>
-- [Out of scope for this discovery]
-- [Defer to implementation phase]
-</exclude>
-</discovery_scope>
-
-<discovery_protocol>
-
-**Source Priority:**
-1. **Context7 MCP** - For library/framework documentation (current, authoritative)
-2. **Official Docs** - For platform-specific or non-indexed libraries
-3. **WebSearch** - For comparisons, trends, community patterns (verify all findings)
-
-**Quality Checklist:**
-Before completing discovery, verify:
-- [ ] All claims have authoritative sources (Context7 or official docs)
-- [ ] Negative claims ("X is not possible") verified with official documentation
-- [ ] API syntax/configuration from Context7 or official docs (never WebSearch alone)
-- [ ] WebSearch findings cross-checked with authoritative sources
-- [ ] Recent updates/changelogs checked for breaking changes
-- [ ] Alternative approaches considered (not just first solution found)
-
-**Confidence Levels:**
-- HIGH: Context7 or official docs confirm
-- MEDIUM: WebSearch + Context7/official docs confirm
-- LOW: WebSearch only or training knowledge only (mark for validation)
-
-</discovery_protocol>
-
-
-<output_structure>
-Create `.planning/phases/XX-name/DISCOVERY.md`:
-
-```markdown
-# Descoberta: [Tópico]
-
-## Resumo
-[Resumo executivo de 2-3 parágrafos — o que foi pesquisado, o que foi encontrado, o que é recomendado]
-
-## Recomendação Principal
-[O que fazer e por quê — seja específico e acionável]
-
-## Alternativas Consideradas
-[O que mais foi avaliado e por que não foi escolhido]
-
-## Descobertas Chave
-
-### [Categoria 1]
-- [Descoberta com URL de fonte e relevância para nosso caso]
-
-### [Categoria 2]
-- [Descoberta com URL de fonte e relevância]
-
-## Exemplos de Código
-[Padrões de implementação relevantes, se aplicável]
-
-## Metadados
-
-<metadata>
-<confidence level="high|medium|low">
-[Por que este nível de confiança — baseado na qualidade das fontes e verificação]
-</confidence>
-
-<sources>
-- [Fontes autoritativas primárias usadas]
-</sources>
-
-<open_questions>
-[O que não pôde ser determinado ou precisa de validação durante a implementação]
-</open_questions>
-
-<validation_checkpoints>
-[Se a confiança for LOW ou MEDIUM, liste coisas específicas a verificar durante a implementação]
-</validation_checkpoints>
-</metadata>
-```
-</output_structure>
-
-<success_criteria>
-- All scope questions answered with authoritative sources
-- Quality checklist items completed
-- Clear primary recommendation
-- Low-confidence findings marked with validation checkpoints
-- Ready to inform PLAN.md creation
-</success_criteria>
-
-<guidelines>
-**Quando usar discovery:**
-- Escolha de tecnologia incerta (biblioteca A vs B)
-- Melhores práticas necessárias para integração desconhecida
-- Investigação de API/biblioteca necessária
-- Decisão única pendente
-
-**Quando NÃO usar:**
-- Padrões estabelecidos (CRUD, auth com biblioteca conhecida)
-- Detalhes de implementação (diferir para execução)
-- Perguntas respondíveis a partir do contexto existente do projeto
-
-**Quando usar RESEARCH.md em vez disso:**
-- Domínios niche/complexos (3D, jogos, áudio, shaders)
-- Necessidade de conhecimento de ecossistema, não apenas escolha de biblioteca
-- Perguntas "como especialistas constroem isso"
-- Use `/research-phase` para esses casos
-</guidelines>
+# Template de Discovery
+
+Template para `.planning/phases/XX-name/DISCOVERY.md` - pesquisa rasa para decisões de biblioteca/opção.
+
+**Propósito:** Responder perguntas "qual biblioteca/opção devemos usar" durante a discovery obrigatória no plan-phase.
+
+Para pesquisa profunda de ecossistema ("como especialistas constroem isso"), use `/research-phase` que produz RESEARCH.md.
+
+---
+
+## Template do Arquivo
+
+```markdown
+---
+phase: XX-name
+type: discovery
+topic: [discovery-topic]
+---
+
+<session_initialization>
+Before beginning discovery, verify today's date:
+!`date +%Y-%m-%d`
+
+Use this date when searching for "current" or "latest" information.
+Example: If today is 2025-11-22, search for "2025" not "2024".
+</session_initialization>
+
+<discovery_objective>
+Discover [topic] to inform [phase name] implementation.
+
+Purpose: [What decision/implementation this enables]
+Scope: [Boundaries]
+Output: DISCOVERY.md with recommendation
+</discovery_objective>
+
+<discovery_scope>
+<include>
+- [Question to answer]
+- [Area to investigate]
+- [Specific comparison if needed]
+</include>
+
+<exclude>
+- [Out of scope for this discovery]
+- [Defer to implementation phase]
+</exclude>
+</discovery_scope>
+
+<discovery_protocol>
+
+**Source Priority:**
+1. **Context7 MCP** - For library/framework documentation (current, authoritative)
+2. **Official Docs** - For platform-specific or non-indexed libraries
+3. **WebSearch** - For comparisons, trends, community patterns (verify all findings)
+
+**Quality Checklist:**
+Before completing discovery, verify:
+- [ ] All claims have authoritative sources (Context7 or official docs)
+- [ ] Negative claims ("X is not possible") verified with official documentation
+- [ ] API syntax/configuration from Context7 or official docs (never WebSearch alone)
+- [ ] WebSearch findings cross-checked with authoritative sources
+- [ ] Recent updates/changelogs checked for breaking changes
+- [ ] Alternative approaches considered (not just first solution found)
+
+**Confidence Levels:**
+- HIGH: Context7 or official docs confirm
+- MEDIUM: WebSearch + Context7/official docs confirm
+- LOW: WebSearch only or training knowledge only (mark for validation)
+
+</discovery_protocol>
+
+
+<output_structure>
+Create `.planning/phases/XX-name/DISCOVERY.md`:
+
+```markdown
+# Descoberta: [Tópico]
+
+## Resumo
+[Resumo executivo de 2-3 parágrafos — o que foi pesquisado, o que foi encontrado, o que é recomendado]
+
+## Recomendação Principal
+[O que fazer e por quê — seja específico e acionável]
+
+## Alternativas Consideradas
+[O que mais foi avaliado e por que não foi escolhido]
+
+## Descobertas Chave
+
+### [Categoria 1]
+- [Descoberta com URL de fonte e relevância para nosso caso]
+
+### [Categoria 2]
+- [Descoberta com URL de fonte e relevância]
+
+## Exemplos de Código
+[Padrões de implementação relevantes, se aplicável]
+
+## Metadados
+
+<metadata>
+<confidence level="high|medium|low">
+[Por que este nível de confiança — baseado na qualidade das fontes e verificação]
+</confidence>
+
+<sources>
+- [Fontes autoritativas primárias usadas]
+</sources>
+
+<open_questions>
+[O que não pôde ser determinado ou precisa de validação durante a implementação]
+</open_questions>
+
+<validation_checkpoints>
+[Se a confiança for LOW ou MEDIUM, liste coisas específicas a verificar durante a implementação]
+</validation_checkpoints>
+</metadata>
+```
+</output_structure>
+
+<success_criteria>
+- All scope questions answered with authoritative sources
+- Quality checklist items completed
+- Clear primary recommendation
+- Low-confidence findings marked with validation checkpoints
+- Ready to inform PLAN.md creation
+</success_criteria>
+
+<guidelines>
+**Quando usar discovery:**
+- Escolha de tecnologia incerta (biblioteca A vs B)
+- Melhores práticas necessárias para integração desconhecida
+- Investigação de API/biblioteca necessária
+- Decisão única pendente
+
+**Quando NÃO usar:**
+- Padrões estabelecidos (CRUD, auth com biblioteca conhecida)
+- Detalhes de implementação (diferir para execução)
+- Perguntas respondíveis a partir do contexto existente do projeto
+
+**Quando usar RESEARCH.md em vez disso:**
+- Domínios niche/complexos (3D, jogos, áudio, shaders)
+- Necessidade de conhecimento de ecossistema, não apenas escolha de biblioteca
+- Perguntas "como especialistas constroem isso"
+- Use `/research-phase` para esses casos
+</guidelines>

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

@@ -1,63 +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
+# 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

@@ -1,123 +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>
+# 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>