@luanpdd/kit-mcp 1.20.0 → 1.21.0

package/kit/framework/templates/UI-SPEC.md

@@ -1,100 +1,100 @@
----
-phase: {N}
-slug: {phase-slug}
-status: draft
-shadcn_initialized: false
-preset: none
-created: {date}
----
-
-# Fase {N} — Contrato de Design de UI
-
-> Contrato visual e de interação para fases de frontend. Gerado por ui-researcher, verificado por ui-checker.
-
----
-
-## Sistema de Design
-
-| Propriedade | Valor |
-|-------------|-------|
-| Ferramenta | {shadcn / none} |
-| Preset | {string do preset ou "não aplicável"} |
-| Biblioteca de componentes | {radix / base-ui / none} |
-| Biblioteca de ícones | {biblioteca} |
-| Fonte | {fonte} |
-
----
-
-## Escala de Espaçamento
-
-Valores declarados (devem ser múltiplos de 4):
-
-| Token | Valor | Uso |
-|-------|-------|-----|
-| xs | 4px | Espaçamentos de ícones, padding inline |
-| sm | 8px | Espaçamento compacto de elementos |
-| md | 16px | Espaçamento padrão de elementos |
-| lg | 24px | Padding de seção |
-| xl | 32px | Espaços de layout |
-| 2xl | 48px | Quebras principais de seção |
-| 3xl | 64px | Espaçamento de nível de página |
-
-Exceções: {listar quaisquer, ou "nenhuma"}
-
----
-
-## Tipografia
-
-| Papel | Tamanho | Peso | Altura de Linha |
-|-------|---------|------|-----------------|
-| Body | {px} | {weight} | {ratio} |
-| Label | {px} | {weight} | {ratio} |
-| Heading | {px} | {weight} | {ratio} |
-| Display | {px} | {weight} | {ratio} |
-
----
-
-## Cores
-
-| Papel | Valor | Uso |
-|-------|-------|-----|
-| Dominante (60%) | {hex} | Fundo, superfícies |
-| Secundário (30%) | {hex} | Cards, sidebar, nav |
-| Destaque (10%) | {hex} | {listar elementos específicos apenas} |
-| Destrutivo | {hex} | Somente ações destrutivas |
-
-Destaque reservado para: {lista explícita — nunca "todos os elementos interativos"}
-
----
-
-## Contrato de Copywriting
-
-| Elemento | Texto |
-|----------|-------|
-| CTA Principal | {verbo + substantivo específico} |
-| Título de estado vazio | {texto} |
-| Corpo de estado vazio | {texto + próximo passo} |
-| Estado de erro | {problema + caminho para solução} |
-| Confirmação destrutiva | {nome da ação}: {texto de confirmação} |
-
----
-
-## Segurança de Registry
-
-| Registry | Blocos Usados | Gate de Segurança |
-|----------|---------------|-------------------|
-| shadcn oficial | {lista} | não necessário |
-| {nome de terceiro} | {lista} | visualização shadcn + diff necessário |
-
----
-
-## Aprovação do Checker
-
-- [ ] Dimensão 1 Copywriting: PASS
-- [ ] Dimensão 2 Visuais: PASS
-- [ ] Dimensão 3 Cores: PASS
-- [ ] Dimensão 4 Tipografia: PASS
-- [ ] Dimensão 5 Espaçamento: PASS
-- [ ] Dimensão 6 Segurança de Registry: PASS
-
-**Aprovação:** {pending / approved YYYY-MM-DD}
+---
+phase: {N}
+slug: {phase-slug}
+status: draft
+shadcn_initialized: false
+preset: none
+created: {date}
+---
+
+# Fase {N} — Contrato de Design de UI
+
+> Contrato visual e de interação para fases de frontend. Gerado por ui-researcher, verificado por ui-checker.
+
+---
+
+## Sistema de Design
+
+| Propriedade | Valor |
+|-------------|-------|
+| Ferramenta | {shadcn / none} |
+| Preset | {string do preset ou "não aplicável"} |
+| Biblioteca de componentes | {radix / base-ui / none} |
+| Biblioteca de ícones | {biblioteca} |
+| Fonte | {fonte} |
+
+---
+
+## Escala de Espaçamento
+
+Valores declarados (devem ser múltiplos de 4):
+
+| Token | Valor | Uso |
+|-------|-------|-----|
+| xs | 4px | Espaçamentos de ícones, padding inline |
+| sm | 8px | Espaçamento compacto de elementos |
+| md | 16px | Espaçamento padrão de elementos |
+| lg | 24px | Padding de seção |
+| xl | 32px | Espaços de layout |
+| 2xl | 48px | Quebras principais de seção |
+| 3xl | 64px | Espaçamento de nível de página |
+
+Exceções: {listar quaisquer, ou "nenhuma"}
+
+---
+
+## Tipografia
+
+| Papel | Tamanho | Peso | Altura de Linha |
+|-------|---------|------|-----------------|
+| Body | {px} | {weight} | {ratio} |
+| Label | {px} | {weight} | {ratio} |
+| Heading | {px} | {weight} | {ratio} |
+| Display | {px} | {weight} | {ratio} |
+
+---
+
+## Cores
+
+| Papel | Valor | Uso |
+|-------|-------|-----|
+| Dominante (60%) | {hex} | Fundo, superfícies |
+| Secundário (30%) | {hex} | Cards, sidebar, nav |
+| Destaque (10%) | {hex} | {listar elementos específicos apenas} |
+| Destrutivo | {hex} | Somente ações destrutivas |
+
+Destaque reservado para: {lista explícita — nunca "todos os elementos interativos"}
+
+---
+
+## Contrato de Copywriting
+
+| Elemento | Texto |
+|----------|-------|
+| CTA Principal | {verbo + substantivo específico} |
+| Título de estado vazio | {texto} |
+| Corpo de estado vazio | {texto + próximo passo} |
+| Estado de erro | {problema + caminho para solução} |
+| Confirmação destrutiva | {nome da ação}: {texto de confirmação} |
+
+---
+
+## Segurança de Registry
+
+| Registry | Blocos Usados | Gate de Segurança |
+|----------|---------------|-------------------|
+| shadcn oficial | {lista} | não necessário |
+| {nome de terceiro} | {lista} | visualização shadcn + diff necessário |
+
+---
+
+## Aprovação do Checker
+
+- [ ] Dimensão 1 Copywriting: PASS
+- [ ] Dimensão 2 Visuais: PASS
+- [ ] Dimensão 3 Cores: PASS
+- [ ] Dimensão 4 Tipografia: PASS
+- [ ] Dimensão 5 Espaçamento: PASS
+- [ ] Dimensão 6 Segurança de Registry: PASS
+
+**Aprovação:** {pending / approved YYYY-MM-DD}

package/kit/framework/templates/VALIDATION.md

@@ -1,76 +1,76 @@
----
-phase: {N}
-slug: {phase-slug}
-status: draft
-nyquist_compliant: false
-wave_0_complete: false
-created: {date}
----
-
-# Fase {N} — Estratégia de Validação
-
-> Contrato de validação por fase para amostragem de feedback durante a execução.
-
----
-
-## Infraestrutura de Testes
-
-| Propriedade | Valor |
-|-------------|-------|
-| **Framework** | {pytest 7.x / jest 29.x / vitest / go test / outro} |
-| **Arquivo de config** | {caminho ou "nenhum — Wave 0 instala"} |
-| **Comando de execução rápida** | `{comando rápido}` |
-| **Comando de suite completa** | `{comando completo}` |
-| **Tempo estimado** | ~{N} segundos |
-
----
-
-## Taxa de Amostragem
-
-- **Após cada commit de tarefa:** Execute `{comando de execução rápida}`
-- **Após cada wave do plano:** Execute `{comando de suite completa}`
-- **Antes de `/verificar-trabalho`:** Suite completa deve estar verde
-- **Latência máxima de feedback:** {N} segundos
-
----
-
-## Mapa de Verificação Por Tarefa
-
-| ID da Tarefa | Plano | Wave | Requisito | Tipo de Teste | Comando Automatizado | Arquivo Existe | Status |
-|--------------|-------|------|-----------|---------------|---------------------|----------------|--------|
-| {N}-01-01 | 01 | 1 | REQ-{XX} | unit | `{comando}` | ✅ / ❌ W0 | ⬜ pending |
-
-*Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky*
-
----
-
-## Requisitos do Wave 0
-
-- [ ] `{tests/test_file.py}` — stubs para REQ-{XX}
-- [ ] `{tests/conftest.py}` — fixtures compartilhadas
-- [ ] `{framework install}` — se nenhum framework detectado
-
-*Se nenhum: "Infraestrutura existente cobre todos os requisitos da fase."*
-
----
-
-## Verificações Somente Manuais
-
-| Comportamento | Requisito | Por que Manual | Instruções de Teste |
-|---------------|-----------|----------------|---------------------|
-| {comportamento} | REQ-{XX} | {motivo} | {passos} |
-
-*Se nenhum: "Todos os comportamentos da fase têm verificação automatizada."*
-
----
-
-## Aprovação de Validação
-
-- [ ] Todas as tarefas têm verify `<automated>` ou dependências Wave 0
-- [ ] Continuidade de amostragem: sem 3 tarefas consecutivas sem verificação automatizada
-- [ ] Wave 0 cobre todas as referências MISSING
-- [ ] Sem flags de modo watch
-- [ ] Latência de feedback < {N}s
-- [ ] `nyquist_compliant: true` definido no frontmatter
-
-**Aprovação:** {pending / approved YYYY-MM-DD}
+---
+phase: {N}
+slug: {phase-slug}
+status: draft
+nyquist_compliant: false
+wave_0_complete: false
+created: {date}
+---
+
+# Fase {N} — Estratégia de Validação
+
+> Contrato de validação por fase para amostragem de feedback durante a execução.
+
+---
+
+## Infraestrutura de Testes
+
+| Propriedade | Valor |
+|-------------|-------|
+| **Framework** | {pytest 7.x / jest 29.x / vitest / go test / outro} |
+| **Arquivo de config** | {caminho ou "nenhum — Wave 0 instala"} |
+| **Comando de execução rápida** | `{comando rápido}` |
+| **Comando de suite completa** | `{comando completo}` |
+| **Tempo estimado** | ~{N} segundos |
+
+---
+
+## Taxa de Amostragem
+
+- **Após cada commit de tarefa:** Execute `{comando de execução rápida}`
+- **Após cada wave do plano:** Execute `{comando de suite completa}`
+- **Antes de `/verificar-trabalho`:** Suite completa deve estar verde
+- **Latência máxima de feedback:** {N} segundos
+
+---
+
+## Mapa de Verificação Por Tarefa
+
+| ID da Tarefa | Plano | Wave | Requisito | Tipo de Teste | Comando Automatizado | Arquivo Existe | Status |
+|--------------|-------|------|-----------|---------------|---------------------|----------------|--------|
+| {N}-01-01 | 01 | 1 | REQ-{XX} | unit | `{comando}` | ✅ / ❌ W0 | ⬜ pending |
+
+*Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky*
+
+---
+
+## Requisitos do Wave 0
+
+- [ ] `{tests/test_file.py}` — stubs para REQ-{XX}
+- [ ] `{tests/conftest.py}` — fixtures compartilhadas
+- [ ] `{framework install}` — se nenhum framework detectado
+
+*Se nenhum: "Infraestrutura existente cobre todos os requisitos da fase."*
+
+---
+
+## Verificações Somente Manuais
+
+| Comportamento | Requisito | Por que Manual | Instruções de Teste |
+|---------------|-----------|----------------|---------------------|
+| {comportamento} | REQ-{XX} | {motivo} | {passos} |
+
+*Se nenhum: "Todos os comportamentos da fase têm verificação automatizada."*
+
+---
+
+## Aprovação de Validação
+
+- [ ] Todas as tarefas têm verify `<automated>` ou dependências Wave 0
+- [ ] Continuidade de amostragem: sem 3 tarefas consecutivas sem verificação automatizada
+- [ ] Wave 0 cobre todas as referências MISSING
+- [ ] Sem flags de modo watch
+- [ ] Latência de feedback < {N}s
+- [ ] `nyquist_compliant: true` definido no frontmatter
+
+**Aprovação:** {pending / approved YYYY-MM-DD}

package/kit/framework/templates/claude-md.md

@@ -1,122 +1,122 @@
-# Template CLAUDE.md
-
-Template para `CLAUDE.md` na raiz do projeto — gerado automaticamente por `tools generate-claude-md`.
-
-Contém 6 seções delimitadas por marcadores. Cada seção é atualizável independentemente.
-O subcomando `generate-claude-md` gerencia 5 seções (project, stack, conventions, architecture, workflow enforcement).
-A seção de perfil é gerenciada exclusivamente por `generate-claude-profile`.
-
----
-
-## Templates de Seção
-
-### Seção Project
-```
-<!-- framework:project-start source:PROJECT.md -->
-## Project
-
-{{project_content}}
-<!-- framework:project-end -->
-```
-
-**Texto de fallback:**
-```
-Project not yet initialized. Run /novo-projeto to set up.
-```
-
-### Seção Stack
-```
-<!-- framework:stack-start source:STACK.md -->
-## Technology Stack
-
-{{stack_content}}
-<!-- framework:stack-end -->
-```
-
-**Texto de fallback:**
-```
-Technology stack not yet documented. Will populate after codebase mapping or first phase.
-```
-
-### Seção Conventions
-```
-<!-- framework:conventions-start source:CONVENTIONS.md -->
-## Conventions
-
-{{conventions_content}}
-<!-- framework:conventions-end -->
-```
-
-**Texto de fallback:**
-```
-Conventions not yet established. Will populate as patterns emerge during development.
-```
-
-### Seção Architecture
-```
-<!-- framework:architecture-start source:ARCHITECTURE.md -->
-## Architecture
-
-{{architecture_content}}
-<!-- framework:architecture-end -->
-```
-
-**Texto de fallback:**
-```
-Architecture not yet mapped. Follow existing patterns found in the codebase.
-```
-
-### Seção Workflow Enforcement
-```
-<!-- framework:workflow-start source:framework defaults -->
-## framework Workflow Enforcement
-
-Before using Edit, Write, or other file-changing tools, start work through a framework command so planning artifacts and execution context stay in sync.
-
-Use these entry points:
-- `/quick` for small fixes, doc updates, and ad-hoc tasks
-- `/debug` for investigation and bug fixing
-- `/executar-fase` for planned phase work
-
-Do not make direct repo edits outside a framework workflow unless the user explicitly asks to bypass it.
-<!-- framework:workflow-end -->
-```
-
-### Seção Profile (Apenas Placeholder)
-```
-<!-- framework:profile-start -->
-## Developer Profile
-
-> Profile not yet configured. Run `/profile-user` to generate your developer profile.
-> This section is managed by `generate-claude-profile` — do not edit manually.
-<!-- framework:profile-end -->
-```
-
-**Nota:** Esta seção NÃO é gerenciada por `generate-claude-md`. É gerenciada exclusivamente
-por `generate-claude-profile`. O placeholder acima é usado apenas ao criar um novo
-arquivo CLAUDE.md quando ainda não existe seção de perfil.
-
----
-
-## Ordem das Seções
-
-1. **Project** — Identidade e propósito (o que é este projeto)
-2. **Stack** — Escolhas de tecnologia (quais ferramentas são usadas)
-3. **Conventions** — Padrões de código e regras (como o código é escrito)
-4. **Architecture** — Estrutura do sistema (como os componentes se encaixam)
-5. **Workflow Enforcement** — Pontos de entrada framework padrão para trabalho que altera arquivos
-6. **Profile** — Preferências comportamentais do desenvolvedor (como interagir)
-
-## Formato dos Marcadores
-
-- Início: `<!-- framework:{name}-start source:{file} -->`
-- Fim: `<!-- framework:{name}-end -->`
-- Atributo source permite atualizações direcionadas quando arquivos fonte mudam
-- Correspondência parcial no marcador de início (sem `-->` de fechamento) para detecção
-
-## Comportamento de Fallback
-
-Quando um arquivo fonte está faltando, o texto de fallback fornece orientação acionável para o Claude:
-- Orienta o comportamento do Claude na ausência de dados
-- Não são avisos de "faltando" ou placeholders
-- Cada fallback diz ao Claude o que fazer, não apenas o que está ausente
+# Template CLAUDE.md
+
+Template para `CLAUDE.md` na raiz do projeto — gerado automaticamente por `tools generate-claude-md`.
+
+Contém 6 seções delimitadas por marcadores. Cada seção é atualizável independentemente.
+O subcomando `generate-claude-md` gerencia 5 seções (project, stack, conventions, architecture, workflow enforcement).
+A seção de perfil é gerenciada exclusivamente por `generate-claude-profile`.
+
+---
+
+## Templates de Seção
+
+### Seção Project
+```
+<!-- framework:project-start source:PROJECT.md -->
+## Project
+
+{{project_content}}
+<!-- framework:project-end -->
+```
+
+**Texto de fallback:**
+```
+Project not yet initialized. Run /novo-projeto to set up.
+```
+
+### Seção Stack
+```
+<!-- framework:stack-start source:STACK.md -->
+## Technology Stack
+
+{{stack_content}}
+<!-- framework:stack-end -->
+```
+
+**Texto de fallback:**
+```
+Technology stack not yet documented. Will populate after codebase mapping or first phase.
+```
+
+### Seção Conventions
+```
+<!-- framework:conventions-start source:CONVENTIONS.md -->
+## Conventions
+
+{{conventions_content}}
+<!-- framework:conventions-end -->
+```
+
+**Texto de fallback:**
+```
+Conventions not yet established. Will populate as patterns emerge during development.
+```
+
+### Seção Architecture
+```
+<!-- framework:architecture-start source:ARCHITECTURE.md -->
+## Architecture
+
+{{architecture_content}}
+<!-- framework:architecture-end -->
+```
+
+**Texto de fallback:**
+```
+Architecture not yet mapped. Follow existing patterns found in the codebase.
+```
+
+### Seção Workflow Enforcement
+```
+<!-- framework:workflow-start source:framework defaults -->
+## framework Workflow Enforcement
+
+Before using Edit, Write, or other file-changing tools, start work through a framework command so planning artifacts and execution context stay in sync.
+
+Use these entry points:
+- `/quick` for small fixes, doc updates, and ad-hoc tasks
+- `/debug` for investigation and bug fixing
+- `/executar-fase` for planned phase work
+
+Do not make direct repo edits outside a framework workflow unless the user explicitly asks to bypass it.
+<!-- framework:workflow-end -->
+```
+
+### Seção Profile (Apenas Placeholder)
+```
+<!-- framework:profile-start -->
+## Developer Profile
+
+> Profile not yet configured. Run `/profile-user` to generate your developer profile.
+> This section is managed by `generate-claude-profile` — do not edit manually.
+<!-- framework:profile-end -->
+```
+
+**Nota:** Esta seção NÃO é gerenciada por `generate-claude-md`. É gerenciada exclusivamente
+por `generate-claude-profile`. O placeholder acima é usado apenas ao criar um novo
+arquivo CLAUDE.md quando ainda não existe seção de perfil.
+
+---
+
+## Ordem das Seções
+
+1. **Project** — Identidade e propósito (o que é este projeto)
+2. **Stack** — Escolhas de tecnologia (quais ferramentas são usadas)
+3. **Conventions** — Padrões de código e regras (como o código é escrito)
+4. **Architecture** — Estrutura do sistema (como os componentes se encaixam)
+5. **Workflow Enforcement** — Pontos de entrada framework padrão para trabalho que altera arquivos
+6. **Profile** — Preferências comportamentais do desenvolvedor (como interagir)
+
+## Formato dos Marcadores
+
+- Início: `<!-- framework:{name}-start source:{file} -->`
+- Fim: `<!-- framework:{name}-end -->`
+- Atributo source permite atualizações direcionadas quando arquivos fonte mudam
+- Correspondência parcial no marcador de início (sem `-->` de fechamento) para detecção
+
+## Comportamento de Fallback
+
+Quando um arquivo fonte está faltando, o texto de fallback fornece orientação acionável para o Claude:
+- Orienta o comportamento do Claude na ausência de dados
+- Não são avisos de "faltando" ou placeholders
+- Cada fallback diz ao Claude o que fazer, não apenas o que está ausente