kakaroto-config 1.0.0 → 1.0.2

package/config/agents/visual-validator.md

@@ -138,6 +138,23 @@ For each modified component file:
 
 ---
 
+### 6.5 Form Submit Test (SE form modificado)
+
+**Trigger:** Arquivo `*FormModal.tsx` ou `*Form.tsx` modificado.
+
+1. Identificar forms modificados via git diff
+2. Navegar ao form (browser_navigate)
+3. Preencher campos com dados válidos (browser_fill_form)
+4. Clicar submit
+5. Verificar:
+   - Sem erros de console
+   - Toast/mensagem de sucesso aparece
+   - Modal fecha ou redireciona
+
+**Nota:** Step condicional. Só executar se form de criação/edição foi modificado.
+
+---
+
 ### 7. Fix Loop (Max 3 Attempts)
 
 ```

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

@@ -0,0 +1,120 @@
+# Fase 1: Reproduce
+
+Responsabilidade: **ONDE** esta o bug + **COMO** reproduzir + **EVIDENCIA** concreta
+
+---
+
+## Passo 1: Triage
+
+Classificar o bug por keywords em $ARGUMENTS:
+
+| Categoria | Keywords |
+|-----------|----------|
+| Backend/Service | service, funcao, null, undefined, dados, firestore, db, retorna |
+| API/Endpoint | endpoint, API, request, response, 4xx, 5xx, validation, handler |
+| UI/Frontend | UI, componente, renderiza, tela, botao, estado, react, tsx |
+| Job/Cron | job, cron, schedule, nao executou, analytics, executor |
+| Integration | credencial, token, auth, OAuth, secret, API externa |
+| Test | teste, test, falha, assertion, mock, spec |
+| Infra/Deploy | VM, startup, env, terraform, deploy, container, docker, GCP, faltando |
+
+**SE** nenhuma keyword match → Default: **Backend/Service**
+
+```
+TRIAGE:
+Keywords encontradas: [...]
+Categoria: [Backend/API/UI/Job/Integration/Test/Infra]
+```
+
+---
+
+## Passo 2: Carregar Contexto
+
+```
+mcp__memory__search_nodes({ query: "config" })
+mcp__memory__search_nodes({ query: "<termos-do-bug>" })
+```
+
+---
+
+## Passo 3: Contexto Rapido
+
+### 3.1 Logs de Producao
+
+**SE** `.claude/debug-logs.json` existe e `enabled=true`:
+```bash
+{valor de commands.quick}
+```
+
+### 3.2 Exploracao Basica
+
+```
+Grep: termos do bug em services/, api/, cron/, components/
+Glob: arquivos com nomes relacionados
+```
+
+```
+LOCALIZACAO:
+Arquivos candidatos: [arquivo1.ts, arquivo2.ts]
+Funcoes suspeitas: [funcao1(), funcao2()]
+```
+
+---
+
+## Passo 4: Executar Playbook
+
+ACAO: Read ~/.claude/commands/debug/playbooks/{categoria}.md
+
+| Categoria | Playbook |
+|-----------|----------|
+| Backend/Service | backend.md |
+| API/Endpoint | api.md |
+| UI/Frontend | ui.md |
+| Job/Cron | job.md |
+| Integration | integration.md |
+| Test | test.md |
+| Infra/Deploy | infra.md |
+
+---
+
+## Passo 5: Criar Artefato
+
+ACAO: Read ~/.claude/commands/debug/templates/diagnosis-script.md
+
+---
+
+## Passo 6: Gate de Reproducao
+
+ACAO: Read ~/.claude/commands/debug/validators/evidence-requirements.md
+
+---
+
+## Passo 7: Persistir Reproducao
+
+ACAO: Read ~/.claude/commands/debug/templates/reproduction-doc.md
+
+---
+
+## Passo 8: Checkpoint
+
+```javascript
+TodoWrite({
+  todos: [
+    { content: "Reproduce: triage + playbook", status: "completed", activeForm: "Bug triaged" },
+    { content: "Reproduce: artefato + evidencia", status: "completed", activeForm: "Evidence collected" },
+    { content: "Investigate: analisar causa raiz", status: "pending", activeForm: "Analyzing root cause" }
+  ]
+})
+```
+
+---
+
+## Output
+
+Bug reproduzido com evidencia em `.claude/debug/reproduction.md`.
+
+---
+
+## PROXIMA FASE
+
+ACAO OBRIGATORIA: Read ~/.claude/commands/debug/02-investigate.md

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

@@ -0,0 +1,93 @@
+# Fase 2: Investigate
+
+Responsabilidade: **POR QUE** o bug acontece + **CAUSA RAIZ**
+
+---
+
+## Principio
+
+> Fixes corrigem LOGICA, nao filtram SINTOMAS.
+> Antes de propor FILTRO/IGNORE: por que o erro e gerado em primeiro lugar?
+
+---
+
+## Passo 1: Context
+
+**SE** continuacao direta de 01-reproduce: Contexto ja disponivel.
+**SE** retomando sessao: `Read .claude/debug/reproduction.md`
+
+---
+
+## Passo 2: Explorar Codigo
+
+```
+Grep: termos do bug
+Glob: arquivos com nomes relacionados
+git log --oneline --grep="fix" -- [arquivos suspeitos]
+```
+
+Identificar:
+- Arquivos/funcoes envolvidos
+- Como erros sao tratados nesta area
+- Ha validacao que deveria existir?
+
+---
+
+## Passo 3: Rastreamento de Fluxo
+
+**SE** bug envolve dados incorretos (null, undefined, formato invalido):
+
+ACAO: Read ~/.claude/commands/debug/techniques/flow-tracing.md
+
+---
+
+## Passo 4: Geracao de Hipoteses
+
+ACAO: Read ~/.claude/commands/debug/techniques/hypothesis-generation.md
+
+---
+
+## Passo 5: Sequential Thinking
+
+ACAO: Read ~/.claude/commands/debug/techniques/sequential-thinking-config.md
+
+**SE** categoria = Infra/Deploy:
+Consultar secao "Fase: Investigate" em playbooks/infra.md
+
+---
+
+## Passo 6: Validar Causa Raiz
+
+ACAO: Read ~/.claude/commands/debug/validators/root-cause-validation.md
+
+---
+
+## Passo 7: Documentar Causa Raiz
+
+ACAO: Read ~/.claude/commands/debug/templates/root-cause-doc.md
+
+---
+
+## Passo 8: Checkpoint
+
+```javascript
+TodoWrite({
+  todos: [
+    { content: "Reproduce: bug reproduzido", status: "completed", activeForm: "Bug reproduced" },
+    { content: "Investigate: causa raiz validada", status: "completed", activeForm: "Root cause validated" },
+    { content: "Fix: implementar correcao", status: "pending", activeForm: "Implementing fix" }
+  ]
+})
+```
+
+---
+
+## Output
+
+Causa raiz documentada em `.claude/debug/root-cause.md`.
+
+---
+
+## PROXIMA FASE
+
+ACAO OBRIGATORIA: Read ~/.claude/commands/debug/03-fix.md

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

@@ -0,0 +1,110 @@
+# Fase 3: Fix
+
+Responsabilidade: Implementar fix de forma AUTONOMA.
+
+---
+
+## Passo 1: Validacao Pre-Fix
+
+### 1.1 Revisao da Categorizacao
+
+Na fase Investigate voce categorizou seu fix como:
+- [ ] CORRECAO DE LOGICA → Prossiga
+- [ ] FILTRO/IGNORE → **PARE!** Volte para Investigate
+- [ ] WORKAROUND → **PARE!** Volte para Investigate
+
+### 1.2 Gate para FILTRO/IGNORE
+
+**SE** fix envolve adicionar a lista de ignore/skip/filter:
+1. Por que o erro esta sendo gerado em primeiro lugar?
+2. Esse padrao pode aparecer em erros legitimos?
+3. Existe forma de corrigir a logica em vez de filtrar?
+
+**SE nao conseguir justificar**: Volte para 02-investigate.md
+
+---
+
+## Passo 2: Gate de Criticidade
+
+ACAO: Read ~/.claude/commands/debug/validators/criticality-gate.md
+
+---
+
+## Passo 3: Gate de Permanencia
+
+ACAO: Read ~/.claude/commands/debug/validators/fix-permanence.md
+
+---
+
+## Passo 4: Teste de Regressao
+
+### 4.1 Criar Teste que Reproduz o Bug
+
+```typescript
+describe('[contexto do bug]', () => {
+  it('should [comportamento esperado]', () => {
+    // Arrange: setup que causa o bug
+    // Act: acao que dispara o bug
+    // Assert: verificar comportamento correto
+  })
+})
+```
+
+### 4.2 Verificar que Teste FALHA
+
+```bash
+npm test -- --testPathPattern="[arquivo]"
+```
+
+O teste DEVE falhar antes do fix. Se passar, o teste nao reproduz o bug.
+
+---
+
+## Passo 5: Implementar Fix
+
+```
+FIX:
+Arquivo: [arquivo:linha]
+Antes: [codigo atual]
+Depois: [codigo novo]
+Justificativa: [por que resolve a causa raiz]
+```
+
+Regras:
+- APENAS o necessario para resolver a causa raiz
+- NAO refatorar codigo nao relacionado
+- Seguir patterns existentes do projeto
+
+---
+
+## Passo 6: Verificar Fix
+
+```bash
+npm test -- --testPathPattern="[arquivo]"
+```
+
+---
+
+## Passo 7: Checkpoint
+
+```javascript
+TodoWrite({
+  todos: [
+    { content: "Investigate: causa raiz identificada", status: "completed", activeForm: "Root cause identified" },
+    { content: "Fix: teste + correcao implementada", status: "completed", activeForm: "Fix implemented" },
+    { content: "Verify: validar quality gates", status: "pending", activeForm: "Validating quality gates" }
+  ]
+})
+```
+
+---
+
+## Output
+
+Fix implementado. Teste de regressao passando.
+
+---
+
+## PROXIMA FASE
+
+ACAO OBRIGATORIA: Read ~/.claude/commands/debug/04-verify.md

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

@@ -0,0 +1,155 @@
+# Fase 4: Verify
+
+Responsabilidade: Verificar e finalizar de forma AUTONOMA.
+
+---
+
+## Passo 1: Quality Gates
+
+```bash
+npm test && npx tsc --noEmit && npm run build
+```
+
+**Se falhar:** ACAO: Read ~/.claude/commands/debug/self-healing.md
+
+---
+
+## Passo 2: Re-executar Reproducao
+
+O script de debug DEVE ser re-executado para confirmar resolucao.
+
+### 2.1 Executar Script
+
+```bash
+npx tsx scripts/debug-{nome-do-bug}.ts
+```
+
+**SE** script nao existe: `ls scripts/debug-*.ts` e executar mais recente.
+
+### 2.2 Comparacao de Output
+
+| Momento | Output |
+|---------|--------|
+| **ANTES** (de `.claude/debug/reproduction.md`) | [output original] |
+| **DEPOIS** | [output atual] |
+
+### 2.3 Decision Gate
+
+**SE** output ainda mostra bug:
+- Fix NAO resolveu a causa raiz
+- ACAO: Read ~/.claude/commands/debug/self-healing.md
+
+**SE** bug resolvido:
+- **SE** categoria = Infra/Deploy: Consultar playbooks/infra.md
+- **SENAO**: Prosseguir para 2.4
+
+### 2.4 Converter Script em Teste de Regressao (se aplicavel)
+
+**SE** script retornou 0 (bug ausente) E arquivo modificado em `cron/`, `services/`, `api/`, `utils/`:
+
+1. Identificar arquivo de teste destino:
+   ```
+   services/foo.ts  → services/foo.test.ts
+   cron/bar.ts      → cron/bar.test.ts (ou criar)
+   ```
+
+2. Converter estrutura do script:
+   ```
+   diagnose()           → describe('regression: {bug}')
+   // 1. Setup          → beforeEach ou inline
+   // 2. Reproducao     → it('should {comportamento correto}', ...)
+   // 3. Verificacao    → expect(...).toBe(...)
+   bugPresente ? 1 : 0  → expect(bugPresente).toBe(false)
+   ```
+
+3. Adicionar ao arquivo de teste:
+   ```typescript
+   describe('regression: {descricao-do-bug}', () => {
+     it('should {comportamento correto apos fix}', async () => {
+       // [codigo adaptado do script de debug]
+       expect(resultado).toBe(esperado);
+     });
+   });
+   ```
+
+4. Validar: `npm test -- --filter="{arquivo}"`
+
+**SE** bug NAO e testavel automaticamente (UI, Infra, Config):
+- Pular conversao, apenas documentar em reproduction.md
+
+**NOTA:** A conversao e recomendada, nao obrigatoria. Usar julgamento.
+
+---
+
+## Passo 3: Memory Sync (se bug nao-obvio)
+
+```javascript
+mcp__memory__create_entities({
+  entities: [{
+    name: "{prefix}:bug:{nome-descritivo}",
+    entityType: "bug",
+    observations: ["Sintoma: [...]", "Causa raiz: [...]", "Solucao: [...]"]
+  }]
+})
+```
+
+---
+
+## Passo 4: Cleanup
+
+### 4.1 Script de Debug
+
+**SE** script foi convertido em teste (2.4):
+```bash
+rm scripts/debug-{nome-do-bug}.ts  # Codigo ja esta no teste
+```
+
+**SE** script NAO foi convertido (bug nao-testavel):
+```bash
+rm scripts/debug-{nome-do-bug}.ts  # Documentacao fica em reproduction.md
+```
+
+### 4.2 Manter Documentacao
+
+NAO deletar:
+- `.claude/debug/reproduction.md`
+- `.claude/debug/root-cause.md`
+
+### 4.3 Verificar Git Status
+
+```bash
+git status
+```
+
+**SE** teste de regressao foi criado: deve aparecer arquivo novo ou modificado
+
+---
+
+## Passo 5: Checkpoint
+
+```javascript
+TodoWrite({
+  todos: [
+    { content: "Fix: correcao implementada", status: "completed", activeForm: "Fix implemented" },
+    { content: "Verify: quality gates + bug confirmado", status: "completed", activeForm: "Verified" },
+    { content: "Verify: teste de regressao (se aplicavel)", status: "completed", activeForm: "Regression test checked" },
+    { content: "Verify: cleanup feito", status: "completed", activeForm: "Cleanup done" },
+    { content: "Commit: commitar e push", status: "pending", activeForm: "Committing" }
+  ]
+})
+```
+
+---
+
+## Regras Inviolaveis
+
+1. PROIBIDO prosseguir com testes/build falhando
+2. PROIBIDO prosseguir sem re-executar script
+3. PROIBIDO mais de 3 tentativas no self-healing
+4. PROIBIDO deixar script de debug em scripts/ (converter para teste ou deletar)
+
+---
+
+## PROXIMA FASE
+
+ACAO OBRIGATORIA: Read ~/.claude/commands/debug/05-commit.md

package/config/commands/debug/05-commit.md

@@ -0,0 +1,106 @@
+# Fase 5: Commit & Push
+
+## Contexto
+Bug resolvido, verify passou. Commitar e fazer push de forma AUTONOMA.
+
+---
+
+## Passo 1: Verificar Mudancas
+
+```bash
+git status
+```
+
+**Se nao houver mudancas:** Reportar "Nada a commitar" → FIM
+
+---
+
+## Passo 2: Commit
+
+```bash
+git add -A
+git commit -m "$(cat <<'EOF'
+fix: {descricao do bug resolvido em ingles}
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+EOF
+)"
+```
+
+**Sempre prefixo `fix:`** - workflow e de debug.
+
+---
+
+## Passo 3: Push
+
+```bash
+git push
+```
+
+**Se falhar:** Reportar erro ao user.
+
+---
+
+## Passo 4: Memory Sync
+
+Sincronizar conhecimento adquirido durante debug (NÃO bugs - esses são efêmeros).
+
+```javascript
+Task({
+  subagent_type: "memory-sync",
+  prompt: "Sincronizar knowledge graph após debug. IMPORTANTE: NÃO salvar o bug em si. Salvar apenas: patterns descobertos, fluxos entendidos, procedimentos documentados, decisões arquiteturais. Se nenhum conhecimento novo significativo foi adquirido, reportar 'Sem alterações'.",
+  description: "Sync memory graph"
+})
+```
+
+**O que salvar:**
+- Pattern novo descoberto durante investigação
+- Fluxo complexo que levou tempo entender
+- Procedimento de debug que pode ser reutilizado
+
+**O que NÃO salvar:**
+- O bug em si (fix está no código)
+- Detalhes específicos do erro
+- Stack traces ou logs
+
+---
+
+## Passo 5: Checkpoint Final
+
+```javascript
+TodoWrite({
+  todos: [
+    { content: "Reproduce: bug reproduzido", status: "completed", activeForm: "Bug reproduced" },
+    { content: "Investigate: causa raiz identificada", status: "completed", activeForm: "Root cause identified" },
+    { content: "Fix: correcao implementada", status: "completed", activeForm: "Fix implemented" },
+    { content: "Verify: quality gates passando", status: "completed", activeForm: "Quality gates passed" },
+    { content: "Commit: commitado e pushed", status: "completed", activeForm: "Committed and pushed" },
+    { content: "Memory: conhecimento sincronizado", status: "completed", activeForm: "Knowledge synced" }
+  ]
+})
+```
+
+---
+
+## Passo 6: Confirmar
+
+```bash
+git log --oneline -1
+```
+
+Reportar ao user: fix commitado e pushed.
+
+---
+
+## Regras
+
+1. **1 fix = 1 commit**
+2. **Sempre `fix:` como prefixo**
+3. **Mensagem em ingles**
+4. **NUNCA** --force push
+5. **NUNCA** commitar se verify falhou
+
+---
+
+## PROXIMA FASE
+ACAO OBRIGATORIA: Read ~/.claude/commands/debug/06-evaluate.md