kakaroto-config 1.0.0 → 1.0.2

package/config/commands/debug/01-investigate.md

@@ -1,119 +0,0 @@
-# Fase 1: Investigate
-
-## Passo 1: Carregar Contexto
-
-```
-mcp__memory__search_nodes({ query: "config" })
-mcp__memory__search_nodes({ query: "<termos-do-bug>" })
-```
-
-Extrair termos relevantes de $ARGUMENTS e buscar bugs similares já resolvidos.
-
----
-
-## Passo 2: Reproduzir Bug
-
-### 2.1 Executar Passos
-Tentar reproduzir com informações fornecidas.
-
-### 2.2 Documentar
-```
-REPRODUÇÃO:
-- Passos: [...]
-- Input: [...]
-- Output esperado: [...]
-- Output real: [...]
-- Reproduzido: SIM/NAO
-```
-
-### 2.3 Gate
-Se NÃO reproduziu: usar AskUserQuestion para mais detalhes.
-Se reproduziu: continuar.
-
----
-
-## Passo 3: Verificar Estado Externo (OBRIGATÓRIO para scraping/browser)
-
-**SE o bug envolve:** web scraping, Playwright, Puppeteer, seletores, ou qualquer interação com páginas web externas:
-
-### 3.1 VERIFICAR ANTES DE ASSUMIR
-
-```
-1. mcp__playwright__browser_navigate({ url: "[URL do bug]" })
-2. mcp__playwright__browser_wait_for({ time: 3 })
-3. mcp__playwright__browser_snapshot({})
-```
-
-### 3.2 Comparar Estado Atual vs Esperado
-
-- O que o código espera encontrar?
-- O que realmente existe na página?
-- Quais seletores existem/mudaram?
-
-### 3.3 Gate
-
-- [ ] Estado atual da página VERIFICADO com Playwright?
-- [ ] Diferenças entre esperado e real DOCUMENTADAS?
-
-**PROIBIDO:** Assumir que "a página mudou" sem verificar. SEMPRE abrir a URL e constatar.
-
----
-
-## Passo 4: Explorar Código Relacionado
-
-### 4.1 Buscar no Codebase
-```
-Grep: termos do bug
-Glob: arquivos com nomes relacionados
-git log --oneline --grep="fix" -- [arquivos suspeitos]
-```
-
-### 4.2 Identificar
-- Arquivos/funções envolvidos
-- Como erros são tratados nesta área
-- Há validação que deveria existir?
-- Há helper existente que resolve?
-
----
-
-## Passo 5: 5 Whys (Causa Raiz)
-
-Para cada "Por que?", fornecer EVIDÊNCIA de código:
-
-```
-ANÁLISE DE CAUSA RAIZ:
-
-Sintoma: [o que está acontecendo]
-
-Por que #1: [resposta]
-  Evidência: [arquivo:linha] - [código]
-
-Por que #2: [resposta]
-  Evidência: [arquivo:linha] - [código]
-
-Por que #3: [resposta]
-  Evidência: [arquivo:linha] - [código]
-
-CAUSA RAIZ: [declaração clara]
-```
-
----
-
-## Passo 6: Validar Causa Raiz
-
-A causa raiz deve ser:
-- [ ] Algo que você pode MUDAR
-- [ ] Suportada por evidência de código
-- [ ] Explica TODOS os sintomas
-
-Se não validar: voltar ao Passo 5.
-
----
-
-## Output
-
-Causa raiz documentada com evidência.
-
----
-## PRÓXIMA FASE
-AÇÃO OBRIGATÓRIA: Read ~/.claude/commands/debug/02-fix.md

package/config/commands/debug/02-fix.md

@@ -1,108 +0,0 @@
-# Fase 2: Fix
-
-## Contexto
-Causa raiz identificada. Implementar fix de forma AUTÔNOMA.
-
----
-
-## Passo 0: Gate de Criticidade
-
-### 0.1 Identificar Paths Afetados
-
-Extrair arquivos da causa raiz documentada na investigacao (fase 01-investigate).
-
-### 0.2 Lista de Paths Criticos
-
-```
-PATHS_CRITICOS:
-- **/auth/**
-- **/payment/**
-- **/migration*/**
-- **/oauth*
-- **/credential*
-- **/secret*
-- api/middleware.ts
-- services/*Service.ts (core services)
-```
-
-### 0.3 Decision Gate
-
-**SE** arquivos afetados ∩ PATHS_CRITICOS **nao vazio**:
-
-1. Documentar fix planejado:
-   - Causa raiz (com evidencia)
-   - Arquivos a modificar
-   - Mudancas propostas
-   - Riscos identificados
-
-2. Chamar `EnterPlanMode`
-   - Escrever plano de fix em `.claude/plans/debug-fix-{timestamp}.md`
-   - User aprova ou rejeita via ExitPlanMode
-
-3. Apos aprovacao: Prosseguir para Passo 1
-
-**SENAO** (nao critico):
-Prosseguir direto para Passo 1 (autonomia total)
-
----
-
-## Passo 1: Teste de Regressao
-
-### 1.1 Criar Teste que Reproduz o Bug
-```typescript
-describe('[contexto do bug]', () => {
-  it('should [comportamento esperado]', () => {
-    // Arrange: setup que causa o bug
-    // Act: ação que dispara o bug
-    // Assert: verificar comportamento correto
-  })
-})
-```
-
-### 1.2 Verificar que Teste FALHA
-```bash
-npm test -- --testPathPattern="[arquivo]"
-```
-
-O teste DEVE falhar antes do fix. Se passar, o teste não reproduz o bug.
-
----
-
-## Passo 2: Implementar Fix
-
-### 2.1 Fix Mínimo
-```
-FIX:
-Arquivo: [arquivo:linha]
-Antes: [código atual]
-Depois: [código novo]
-Justificativa: [por que resolve a causa raiz]
-```
-
-### 2.2 Regras
-- APENAS o necessário para resolver a causa raiz
-- NÃO refatorar código não relacionado
-- NÃO adicionar features
-- Seguir patterns existentes do projeto
-
----
-
-## Passo 3: Verificar Fix
-
-### 3.1 Teste Deve Passar
-```bash
-npm test -- --testPathPattern="[arquivo]"
-```
-
-### 3.2 Bug Não Reproduz
-Executar passos originais. Bug não deve ocorrer.
-
----
-
-## Output
-
-Fix implementado. Teste de regressão passando.
-
----
-## PRÓXIMA FASE
-AÇÃO OBRIGATÓRIA: Read ~/.claude/commands/debug/03-verify.md

package/config/commands/debug/03-verify.md

@@ -1,66 +0,0 @@
-# Fase 3: Verify
-
-## Contexto
-Fix implementado. Verificar e finalizar de forma AUTÔNOMA.
-
----
-
-## Passo 1: Quality Gates
-
-Rodar em sequência:
-```bash
-npm test
-npx tsc --noEmit
-npm run build
-```
-
-**Se falhar:** Corrigir e rodar novamente. Não prosseguir até passar.
-
----
-
-## Passo 2: Verificação Final
-
-- [ ] Testes passam
-- [ ] TypeScript sem erros
-- [ ] Build bem-sucedido
-- [ ] Bug não reproduz mais
-
----
-
-## Passo 3: Memory Sync (se bug não-óbvio)
-
-Se o bug foi difícil de encontrar, salvar na memory:
-
-```javascript
-mcp__memory__create_entities({
-  entities: [{
-    name: "{prefix}:bug:{nome-descritivo}",
-    entityType: "bug",
-    observations: [
-      "Sintoma: [...]",
-      "Causa raiz: [...]",
-      "Solução: [...]",
-      "Arquivos: [...]"
-    ]
-  }]
-})
-```
-
----
-
-## Passo 4: Relatório Final
-
-Reportar ao user:
-- Bug resolvido
-- Causa raiz identificada
-- Fix implementado
-- Teste de regressão criado
-- Quality gates passando
-
----
-
-## Regras Invioláveis
-
-1. **PROIBIDO** prosseguir com testes falhando
-2. **PROIBIDO** prosseguir com build falhando
-3. **PROIBIDO** perguntar ao user (só reportar no final)