@luanpdd/kit-mcp 1.30.1 → 1.31.0

package/kit/commands/sync-main.md

@@ -1,68 +1,68 @@
----
-name: sync-main
-description: Atualiza a branch local com os commits da main. Se houver conflitos, pergunta qual priorizar.
-allowed-tools:
-  - Bash
----
-
-<safety_rules>
-NUNCA execute git push para main ou origin/main.
-NUNCA mude para a branch main (git checkout main / git switch main).
-Este comando só traz código da main para a branch local — nunca o contrário.
-</safety_rules>
-
-<process>
-
-## 1 — Proteção: bloquear se estiver na main
-
-```bash
-git branch --show-current
-```
-
-Se a branch atual for `main`, encerre com:
-> "⛔ Você está na branch main. Mude para uma branch de feature antes de continuar."
-
-## 2 — Buscar atualizações e verificar se há algo novo
-
-```bash
-git fetch origin
-git log --oneline origin/main ^HEAD
-```
-
-Se não houver nenhum commit novo em `origin/main`, informe:
-> "Sua branch já está atualizada com a main."
-E encerre.
-
-## 3 — Aplicar os commits da main na branch local
-
-```bash
-git merge origin/main
-```
-
-### Se não houver conflitos:
-Mostre um resumo com:
-- Quantos commits foram integrados
-- Lista dos arquivos modificados (`git diff --name-only HEAD~1 HEAD` ou similar)
-
-Encerre.
-
-### Se houver conflitos:
-
-Liste os arquivos conflitantes e pergunte:
-> "Encontrei conflitos nos arquivos abaixo. Qual é a prioridade?
-> [1] main — usa o código da main nos conflitos
-> [2] local — mantém o seu código nos conflitos"
-
-Aguarde a resposta.
-
-**Se [1] main:**
-Para cada arquivo conflitante: `git checkout --theirs <arquivo>`
-Depois: `git add . && git commit`
-
-**Se [2] local:**
-Para cada arquivo conflitante: `git checkout --ours <arquivo>`
-Depois: `git add . && git commit`
-
-Mostre o resumo final: branch atual, status limpo, commits integrados.
-
-</process>
+---
+name: sync-main
+description: Atualiza a branch local com os commits da main. Se houver conflitos, pergunta qual priorizar.
+allowed-tools:
+  - Bash
+---
+
+<safety_rules>
+NUNCA execute git push para main ou origin/main.
+NUNCA mude para a branch main (git checkout main / git switch main).
+Este comando só traz código da main para a branch local — nunca o contrário.
+</safety_rules>
+
+<process>
+
+## 1 — Proteção: bloquear se estiver na main
+
+```bash
+git branch --show-current
+```
+
+Se a branch atual for `main`, encerre com:
+> "⛔ Você está na branch main. Mude para uma branch de feature antes de continuar."
+
+## 2 — Buscar atualizações e verificar se há algo novo
+
+```bash
+git fetch origin
+git log --oneline origin/main ^HEAD
+```
+
+Se não houver nenhum commit novo em `origin/main`, informe:
+> "Sua branch já está atualizada com a main."
+E encerre.
+
+## 3 — Aplicar os commits da main na branch local
+
+```bash
+git merge origin/main
+```
+
+### Se não houver conflitos:
+Mostre um resumo com:
+- Quantos commits foram integrados
+- Lista dos arquivos modificados (`git diff --name-only HEAD~1 HEAD` ou similar)
+
+Encerre.
+
+### Se houver conflitos:
+
+Liste os arquivos conflitantes e pergunte:
+> "Encontrei conflitos nos arquivos abaixo. Qual é a prioridade?
+> [1] main — usa o código da main nos conflitos
+> [2] local — mantém o seu código nos conflitos"
+
+Aguarde a resposta.
+
+**Se [1] main:**
+Para cada arquivo conflitante: `git checkout --theirs <arquivo>`
+Depois: `git add . && git commit`
+
+**Se [2] local:**
+Para cada arquivo conflitante: `git checkout --ours <arquivo>`
+Depois: `git add . && git commit`
+
+Mostre o resumo final: branch atual, status limpo, commits integrados.
+
+</process>

package/kit/commands/validar-fase.md

@@ -1,35 +1,35 @@
----
-name: validar-fase
-description: Audita retroativamente e preenche lacunas de validação Nyquist para uma fase concluída
-argument-hint: "[número da fase]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Glob
-  - Grep
-  - Task
-  - AskUserQuestion
----
-<objective>
-Audita a cobertura de validação Nyquist para uma fase concluída. Três estados:
-- (A) VALIDATION.md existe — auditar e preencher lacunas
-- (B) Sem VALIDATION.md, SUMMARY.md existe — reconstruir a partir de artefatos
-- (C) Fase não executada — sair com orientação
-
-Saída: VALIDATION.md atualizado + arquivos de teste gerados.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/validate-phase.md
-</execution_context>
-
-<context>
-Fase: $ARGUMENTS — opcional, padrão é a última fase concluída.
-</context>
-
-<process>
-Execute @./.claude/framework/workflows/validate-phase.md.
-Preserve todos os gates do workflow.
-</process>
+---
+name: validar-fase
+description: Audita retroativamente e preenche lacunas de validação Nyquist para uma fase concluída
+argument-hint: "[número da fase]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Audita a cobertura de validação Nyquist para uma fase concluída. Três estados:
+- (A) VALIDATION.md existe — auditar e preencher lacunas
+- (B) Sem VALIDATION.md, SUMMARY.md existe — reconstruir a partir de artefatos
+- (C) Fase não executada — sair com orientação
+
+Saída: VALIDATION.md atualizado + arquivos de teste gerados.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/validate-phase.md
+</execution_context>
+
+<context>
+Fase: $ARGUMENTS — opcional, padrão é a última fase concluída.
+</context>
+
+<process>
+Execute @./.claude/framework/workflows/validate-phase.md.
+Preserve todos os gates do workflow.
+</process>

package/kit/commands/verificar-tarefas.md

@@ -1,45 +1,45 @@
----
-name: verificar-tarefas
-description: Lista todos os todos pendentes e seleciona um para trabalhar
-argument-hint: [filtro de área]
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - AskUserQuestion
----
-
-<objective>
-Lista todos os todos pendentes, permite seleção, carrega o contexto completo do todo selecionado e encaminha para a ação adequada.
-
-Encaminha para o workflow check-todos que cuida de:
-- Contagem e listagem de todos com filtro por área
-- Seleção interativa com carregamento completo de contexto
-- Checagem de correlação com roadmap
-- Roteamento de ação (trabalhar agora, adicionar à fase, brainstorm, criar fase)
-- Atualizações do STATE.md e commits git
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/check-todos.md
-</execution_context>
-
-<context>
-Argumentos: $ARGUMENTS (filtro de área opcional)
-
-Estado dos todos e correlação com roadmap são carregados no workflow usando `init todos` e leituras específicas.
-</context>
-
-<process>
-**Seguir o workflow check-todos** de `@./.claude/framework/workflows/check-todos.md`.
-
-O workflow cuida de toda a lógica, incluindo:
-1. Verificação de existência de todos
-2. Filtro por área
-3. Listagem e seleção interativa
-4. Carregamento completo de contexto com resumos de arquivo
-5. Checagem de correlação com roadmap
-6. Oferta e execução de ação
-7. Atualizações do STATE.md
-8. Commits git
+---
+name: verificar-tarefas
+description: Lista todos os todos pendentes e seleciona um para trabalhar
+argument-hint: [filtro de área]
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Lista todos os todos pendentes, permite seleção, carrega o contexto completo do todo selecionado e encaminha para a ação adequada.
+
+Encaminha para o workflow check-todos que cuida de:
+- Contagem e listagem de todos com filtro por área
+- Seleção interativa com carregamento completo de contexto
+- Checagem de correlação com roadmap
+- Roteamento de ação (trabalhar agora, adicionar à fase, brainstorm, criar fase)
+- Atualizações do STATE.md e commits git
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/check-todos.md
+</execution_context>
+
+<context>
+Argumentos: $ARGUMENTS (filtro de área opcional)
+
+Estado dos todos e correlação com roadmap são carregados no workflow usando `init todos` e leituras específicas.
+</context>
+
+<process>
+**Seguir o workflow check-todos** de `@./.claude/framework/workflows/check-todos.md`.
+
+O workflow cuida de toda a lógica, incluindo:
+1. Verificação de existência de todos
+2. Filtro por área
+3. Listagem e seleção interativa
+4. Carregamento completo de contexto com resumos de arquivo
+5. Checagem de correlação com roadmap
+6. Oferta e execução de ação
+7. Atualizações do STATE.md
+8. Commits git
 </process>

package/kit/commands/verificar-trabalho.md

@@ -1,64 +1,64 @@
----
-name: verificar-trabalho
-description: Valida funcionalidades construídas através de UAT conversacional
-argument-hint: "[número da fase, ex: '4']"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Edit
-  - Write
-  - Task
----
-<objective>
-Valida funcionalidades construídas através de testes conversacionais com estado persistente.
-
-Propósito: Confirmar que o que o Claude construiu realmente funciona da perspectiva do usuário. Um teste por vez, respostas em texto simples, sem interrogatório. Quando problemas são encontrados, automaticamente diagnostica, planeja correções e prepara para execução.
-
-Saída: {phase_num}-UAT.md rastreando todos os resultados de teste. Se problemas encontrados: lacunas diagnosticadas, planos de correção verificados prontos para /executar-fase
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/verify-work.md
-@./.claude/framework/templates/UAT.md
-</execution_context>
-
-<context>
-Fase: $ARGUMENTS (opcional)
-- Se fornecido: Testar fase específica (ex: "4")
-- Se não fornecido: Verificar sessões ativas ou solicitar fase
-
-Arquivos de contexto são resolvidos dentro do workflow (`init verify-work`) e delegados via blocos `<files_to_read>`.
-</context>
-
-<process>
-Execute o workflow verify-work de @./.claude/framework/workflows/verify-work.md do início ao fim.
-Preserve todos os gates do workflow (gerenciamento de sessão, apresentação de testes, diagnóstico, planejamento de correções, roteamento).
-</process>
-
-<observability_integration>
-**Integração com Core Analysis Loop em logs reais (v1.9):**
-
-Quando `workflow.observability_uat_validation = true` (default) e o projeto tem MCP Supabase disponível, o workflow inclui passo de validação observacional após UAT conversacional:
-
-1. Para cada test passing no UAT, invocar o agente [`incident-investigator`](../agents/incident-investigator.md) em modo "validation":
-   ```
-   Task(subagent_type="incident-investigator", prompt="
-     mode: validation
-     symptom: validar que feature de Phase {N} efetivamente emitiu spans/eventos esperados
-     time_window: última 1h
-     expected_attributes: {result.success: true, build_id: {current_build}}
-   ")
-   ```
-2. O agente queryará via `mcp__supabase__get_logs` ou `mcp__supabase__execute_sql` para confirmar:
-   - Spans com nome esperado existem
-   - Atributos canônicos foram emitidos (não só código existe — comportamento real)
-   - `result.success` baseline está dentro do esperado
-3. Se confirmado: UAT.md inclui evidência observacional (não só "funciona em UI"). Status `passed` ✓.
-4. Se ausente: UAT.md flag `human_needed` com sugestão "verificar instrumentação não está pegando".
-
-**Skill consultada:** [`core-analysis-loop`](../skills/core-analysis-loop/SKILL.md) — para o caso de UAT falhar e precisar investigar.
-
-**REQ:** INT-FW-03.
-</observability_integration>
+---
+name: verificar-trabalho
+description: Valida funcionalidades construídas através de UAT conversacional
+argument-hint: "[número da fase, ex: '4']"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Edit
+  - Write
+  - Task
+---
+<objective>
+Valida funcionalidades construídas através de testes conversacionais com estado persistente.
+
+Propósito: Confirmar que o que o Claude construiu realmente funciona da perspectiva do usuário. Um teste por vez, respostas em texto simples, sem interrogatório. Quando problemas são encontrados, automaticamente diagnostica, planeja correções e prepara para execução.
+
+Saída: {phase_num}-UAT.md rastreando todos os resultados de teste. Se problemas encontrados: lacunas diagnosticadas, planos de correção verificados prontos para /executar-fase
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/verify-work.md
+@./.claude/framework/templates/UAT.md
+</execution_context>
+
+<context>
+Fase: $ARGUMENTS (opcional)
+- Se fornecido: Testar fase específica (ex: "4")
+- Se não fornecido: Verificar sessões ativas ou solicitar fase
+
+Arquivos de contexto são resolvidos dentro do workflow (`init verify-work`) e delegados via blocos `<files_to_read>`.
+</context>
+
+<process>
+Execute o workflow verify-work de @./.claude/framework/workflows/verify-work.md do início ao fim.
+Preserve todos os gates do workflow (gerenciamento de sessão, apresentação de testes, diagnóstico, planejamento de correções, roteamento).
+</process>
+
+<observability_integration>
+**Integração com Core Analysis Loop em logs reais (v1.9):**
+
+Quando `workflow.observability_uat_validation = true` (default) e o projeto tem MCP Supabase disponível, o workflow inclui passo de validação observacional após UAT conversacional:
+
+1. Para cada test passing no UAT, invocar o agente [`incident-investigator`](../agents/incident-investigator.md) em modo "validation":
+   ```
+   Task(subagent_type="incident-investigator", prompt="
+     mode: validation
+     symptom: validar que feature de Phase {N} efetivamente emitiu spans/eventos esperados
+     time_window: última 1h
+     expected_attributes: {result.success: true, build_id: {current_build}}
+   ")
+   ```
+2. O agente queryará via `mcp__supabase__get_logs` ou `mcp__supabase__execute_sql` para confirmar:
+   - Spans com nome esperado existem
+   - Atributos canônicos foram emitidos (não só código existe — comportamento real)
+   - `result.success` baseline está dentro do esperado
+3. Se confirmado: UAT.md inclui evidência observacional (não só "funciona em UI"). Status `passed` ✓.
+4. Se ausente: UAT.md flag `human_needed` com sugestão "verificar instrumentação não está pegando".
+
+**Skill consultada:** [`core-analysis-loop`](../skills/core-analysis-loop/SKILL.md) — para o caso de UAT falhar e precisar investigar.
+
+**REQ:** INT-FW-03.
+</observability_integration>