kakaroto-config 1.0.0 → 1.0.1

package/README.md

@@ -5,43 +5,149 @@ Claude Code configuration for autonomous development workflows.
 ## Quick Install
 
 ```bash
+# Local installation (recommended - installs to ./.claude/)
 npx kakaroto-config
+
+# Global installation (installs to ~/.claude/)
+npx kakaroto-config --global
+```
+
+**Local is recommended** because each project can have its own customizations while inheriting the global rules.
+
+## Updating
+
+To update to the latest version, run the same command again:
+
+```bash
+# Update local installation
+npx kakaroto-config@latest
+
+# Update global installation
+npx kakaroto-config@latest --global
 ```
 
-This installs the configuration to `~/.claude/`.
+The installer will detect the existing `.claude/` folder and ask if you want to overwrite.
 
-## What's Included
+> **Note:** If you previously installed globally (`~/.claude/`) and want to switch to local (`./.claude/`), just run `npx kakaroto-config@latest` in your project folder. Both can coexist - Claude Code will use local config when available.
 
-### Skills (Commands)
+## What Gets Installed
 
-| Skill | Description |
-|-------|-------------|
-| `/feature` | Full feature development workflow (interview → spec → plan → implement → quality) |
-| `/debug` | Bug resolution with 5 Whys methodology (investigate → fix → verify) |
-| `/gate` | Quality gate before PR (runs 7 validation agents) |
+```
+.claude/
+├── CLAUDE.md              # Global rules (autonomy, coding standards)
+├── ARCHITECTURE.md        # Full documentation of the system
+├── commands/              # Skills (invoked via /skill)
+│   ├── feature.md         # /feature orchestrator
+│   ├── feature/           # 5 phases: interview → spec → plan → implement → quality
+│   ├── debug.md           # /debug orchestrator
+│   ├── debug/             # 5 phases: reproduce → investigate → fix → verify → commit
+│   └── gate.md            # /gate - quality gate before PR
+└── agents/                # 7 specialized subagents
+    ├── test-fixer.md
+    ├── code-reviewer.md
+    ├── code-simplifier.md
+    ├── dry-enforcer.md
+    ├── visual-validator.md
+    ├── terraform-validator.md
+    └── memory-sync.md
+```
+
+## Skills (Commands)
+
+| Skill | Trigger | Description |
+|-------|---------|-------------|
+| `/feature` | "adicionar", "implementar", "criar" | Full feature workflow with spec, planning, and quality gates |
+| `/debug` | "bug", "erro", "problema" | Bug resolution with 5 Whys methodology |
+| `/gate` | Manual | Run all 7 quality agents before PR |
 
-### Agents (Subagents)
+## Agents (Subagents)
 
 | Agent | Purpose |
 |-------|---------|
 | `test-fixer` | Runs tests, fixes failures, creates missing tests |
 | `code-reviewer` | Reviews code quality, security, auto-fixes issues |
 | `code-simplifier` | Reduces complexity, improves readability |
-| `dry-enforcer` | Detects duplication, suggests reuse |
+| `dry-enforcer` | Detects duplication, suggests code reuse |
 | `visual-validator` | Validates UI with Playwright |
 | `terraform-validator` | Validates env vars and Terraform consistency |
 | `memory-sync` | Syncs knowledge to MCP Memory |
 
 ## Philosophy
 
-- **FAZER, não perguntar** - Agents fix issues automatically
-- **BUSCAR, não pedir contexto** - Use MCP Memory and codebase exploration
-- **Código sem teste = PR rejeitado** - Tests are mandatory
-- **Erros: corrigir e continuar** - Don't stop on failures
+The configuration enforces autonomous development:
+
+| Principle | Meaning |
+|-----------|---------|
+| **FAZER, nao perguntar** | Agents fix issues automatically, don't ask for confirmation |
+| **BUSCAR, nao pedir contexto** | Use MCP Memory and codebase exploration, don't ask user for context |
+| **Codigo sem teste = PR rejeitado** | Tests are mandatory (blocking) |
+| **Erros: corrigir e continuar** | Fix errors automatically, don't stop workflow |
+
+## After Installation
+
+### 1. Create Project CLAUDE.md (Optional but Recommended)
+
+Create a `CLAUDE.md` in your project root with project-specific info:
+
+```markdown
+# Project Name
+
+## Commands
+- `npm run dev` - Start dev server
+- `npm run build` - Build
+- `npm run test` - Run tests
+
+## Structure
+- `src/` - Source code
+- `tests/` - Tests
+
+## MCP Memory Namespace
+Prefix: `myproject:`
+```
+
+### 2. Add Custom Skills (Optional)
+
+Create `.claude/commands/your-skill.md` for project-specific workflows.
+
+## Workflow Examples
+
+### Feature Development
+
+```
+User: "adiciona filtro de data na listagem"
+         ↓
+Claude automatically triggers /feature
+         ↓
+01-interview → Explores codebase, asks clarifying questions
+02-spec      → Generates technical specification
+03-planner   → Creates implementation plan (requires approval)
+04-implement → Writes code following spec and plan
+05-quality   → Runs all 7 quality agents
+         ↓
+Ready for PR
+```
+
+### Bug Resolution
+
+```
+User: "erro ao salvar formulario"
+         ↓
+Claude automatically triggers /debug
+         ↓
+01-reproduce   → Reproduces the bug
+02-investigate → 5 Whys analysis with evidence
+03-fix         → Minimal fix + mandatory test
+04-verify      → Confirms fix works
+05-commit      → Creates commit
+         ↓
+Done
+```
 
-## Documentation
+## Requirements
 
-After installation, read `~/.claude/ARCHITECTURE.md` for full documentation.
+- Claude Code CLI
+- MCP Memory server (optional, for knowledge persistence)
+- Playwright MCP (optional, for visual validation)
 
 ## License
 

package/bin/install.js

@@ -5,7 +5,26 @@ const path = require('path');
 const os = require('os');
 const readline = require('readline');
 
-const CLAUDE_DIR = path.join(os.homedir(), '.claude');
+const args = process.argv.slice(2);
+const isGlobal = args.includes('--global');
+const showHelp = args.includes('--help') || args.includes('-h');
+
+if (showHelp) {
+  console.log(`
+Usage: npx kakaroto-config [options]
+
+Options:
+  --global    Install to ~/.claude/ (global, all projects)
+  --help, -h  Show this help message
+
+Default: Install to ./.claude/ (local, current project)
+`);
+  process.exit(0);
+}
+
+const CLAUDE_DIR = isGlobal
+  ? path.join(os.homedir(), '.claude')
+  : path.join(process.cwd(), '.claude');
 const CONFIG_DIR = path.join(__dirname, '..', 'config');
 
 const rl = readline.createInterface({
@@ -52,9 +71,12 @@ function countFiles(dir) {
 }
 
 async function main() {
+  const targetPath = isGlobal ? '~/.claude/' : './.claude/ (local)';
+  const targetDisplay = isGlobal ? '~/.claude/' : '.claude/';
+
   console.log('\n🥋 kakaroto-config - Claude Code Configuration\n');
-  console.log('This will install the following to ~/.claude/:');
-  console.log('  - CLAUDE.md (global rules)');
+  console.log(`This will install the following to ${targetPath}:`);
+  console.log('  - CLAUDE.md (rules)');
   console.log('  - ARCHITECTURE.md (documentation)');
   console.log('  - commands/ (skills: /feature, /debug, /gate)');
   console.log('  - agents/ (7 specialized subagents)\n');
@@ -63,7 +85,7 @@ async function main() {
   console.log(`Total: ${fileCount} files\n`);
 
   if (fs.existsSync(CLAUDE_DIR)) {
-    const answer = await question('~/.claude/ already exists. Overwrite? (y/N): ');
+    const answer = await question(`${targetDisplay} already exists. Overwrite? (y/N): `);
     if (answer.toLowerCase() !== 'y') {
       console.log('\nAborted. No changes made.');
       rl.close();
@@ -89,7 +111,7 @@ async function main() {
     console.log('  2. Try /feature to create a new feature');
     console.log('  3. Try /debug to fix a bug');
     console.log('  4. Try /gate before creating a PR\n');
-    console.log('Read ~/.claude/ARCHITECTURE.md for full documentation.\n');
+    console.log(`Read ${targetDisplay}ARCHITECTURE.md for full documentation.\n`);
   } catch (err) {
     console.error('Error during installation:', err.message);
     process.exit(1);

package/config/ARCHITECTURE.md

@@ -97,9 +97,11 @@ Este documento descreve a arquitetura de configuracao do Claude Code, otimizada
 │   │
 │   ├── debug.md             # /debug - orquestrador
 │   ├── debug/
-│   │   ├── 01-investigate.md # Fase 1: 5 Whys
-│   │   ├── 02-fix.md         # Fase 2: correcao minima
-│   │   └── 03-verify.md      # Fase 3: confirmar fix
+│   │   ├── 01-reproduce.md   # Fase 1: reproduzir bug
+│   │   ├── 02-investigate.md # Fase 2: 5 Whys
+│   │   ├── 03-fix.md         # Fase 3: correcao minima
+│   │   ├── 04-verify.md      # Fase 4: confirmar fix
+│   │   └── 05-commit.md      # Fase 5: commit
 │   │
 │   └── gate.md              # /gate - quality gate completo
 │
@@ -216,22 +218,28 @@ User: "erro ao publicar video"
            │
            ▼
 ┌────────────────────────┐     ┌────────────────────────┐
-│   01-investigate.md    │────►│   02-fix.md            │
-│   - Reproduzir bug     │     │   - Gate de criticidade│
-│   - 5 Whys com         │     │   - EnterPlanMode se   │
-│     EVIDENCIA          │     │     path critico       │
-└────────────────────────┘     │   - Fix MINIMO         │
-                               │   - Testes obrigatorio │
-                               └───────────┬────────────┘
+│   01-reproduce.md      │────►│   02-investigate.md    │
+│   - Criar teste que    │     │   - 5 Whys com         │
+│     reproduz o bug     │     │     EVIDENCIA          │
+│   - Confirmar falha    │     │   - Root cause         │
+└────────────────────────┘     └───────────┬────────────┘
                                            │
                                            ▼
-                               ┌────────────────────────┐
-                               │   03-verify.md         │
-                               │   - Reproduzir fix     │
-                               │   - Quality gates      │
-                               │   - Salvar bug raro    │
-                               │     em MCP Memory      │
-                               └────────────────────────┘
+┌────────────────────────┐     ┌────────────────────────┐
+│   04-verify.md         │◄────│   03-fix.md            │
+│   - Rodar teste        │     │   - Fix MINIMO         │
+│   - Confirmar que      │     │   - Apenas o necessario│
+│     passou             │     │   - Nao refatorar      │
+└───────────┬────────────┘     └────────────────────────┘
+            │
+            ▼
+┌────────────────────────┐
+│   05-commit.md         │
+│   - Commit do fix      │
+│   - Padrao de mensagem │
+│   - Memory sync se     │
+│     bug raro           │
+└────────────────────────┘
 ```
 
 ### /gate (Quality Gate Antes de PR)

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

@@ -0,0 +1,118 @@
+# Fase 1: Reproduce
+
+## 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 ja resolvidos.
+
+---
+
+## Passo 2: Reproduzir Bug
+
+### 2.1 Executar Passos
+Tentar reproduzir com informacoes fornecidas.
+
+### 2.2 Documentar
+```
+REPRODUCAO:
+- Passos: [...]
+- Input: [...]
+- Output esperado: [...]
+- Output real: [...]
+- Reproduzido: SIM/NAO
+```
+
+---
+
+## Passo 3: Verificar Estado Externo (SE web/scraping)
+
+**APENAS SE** o bug envolve: web scraping, Playwright, Puppeteer, seletores, ou interacao com paginas 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 codigo espera encontrar?
+- O que realmente existe na pagina?
+- Quais seletores existem/mudaram?
+
+**PROIBIDO:** Assumir que "a pagina mudou" sem verificar.
+
+---
+
+## Passo 4: Gate de Reproducao
+
+**SE** reproduziu com sucesso:
+- Prosseguir para Passo 5
+
+**SE NAO** reproduziu:
+- Usar `AskUserQuestion` para obter mais detalhes
+- Documentar o que foi tentado
+- NAO prosseguir ate reproduzir
+
+---
+
+## Passo 5: Persistir Reproducao
+
+Salvar documentacao em `.claude/debug/reproduction.md`:
+
+```markdown
+# Reproducao: [descricao curta do bug]
+
+**Data:** [timestamp]
+**Bug:** [descricao original de $ARGUMENTS]
+
+## Passos de Reproducao
+1. [passo executado]
+2. [passo executado]
+
+## Input
+[dados de entrada usados]
+
+## Output Esperado
+[o que deveria acontecer]
+
+## Output Real
+[o que aconteceu - evidencia do bug]
+
+## Observacoes Iniciais
+[hipoteses formadas durante reproducao]
+
+## Estado Externo (se aplicavel)
+[observacoes do Playwright/browser]
+```
+
+---
+
+## Passo 6: Checkpoint
+
+```javascript
+TodoWrite({
+  todos: [
+    { content: "Reproduce: contexto carregado", status: "completed", activeForm: "Loading context" },
+    { content: "Reproduce: bug reproduzido", status: "completed", activeForm: "Reproducing bug" },
+    { content: "Reproduce: reproducao persistida", status: "completed", activeForm: "Persisting reproduction" },
+    { content: "Investigate: analisar causa raiz", status: "pending", activeForm: "Analyzing root cause" }
+  ]
+})
+```
+
+---
+
+## Output
+
+Bug reproduzido e documentado 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,87 @@
+# Fase 2: Investigate
+
+## Passo 0: Context
+
+**SE** continuacao direta de 01-reproduce (mesma sessao):
+  Contexto ja disponivel, prosseguir.
+
+**SE** retomando sessao interrompida:
+```
+Read .claude/debug/reproduction.md
+```
+
+---
+
+## Passo 1: Explorar Codigo Relacionado
+
+### 1.1 Buscar no Codebase
+```
+Grep: termos do bug
+Glob: arquivos com nomes relacionados
+git log --oneline --grep="fix" -- [arquivos suspeitos]
+```
+
+### 1.2 Identificar
+- Arquivos/funcoes envolvidos
+- Como erros sao tratados nesta area
+- Ha validacao que deveria existir?
+- Ha helper existente que resolve?
+
+---
+
+## Passo 2: 5 Whys (Causa Raiz)
+
+Para cada "Por que?", fornecer EVIDENCIA de codigo:
+
+```
+ANALISE DE CAUSA RAIZ:
+
+Sintoma: [o que esta acontecendo]
+
+Por que #1: [resposta]
+  Evidencia: [arquivo:linha] - [codigo]
+
+Por que #2: [resposta]
+  Evidencia: [arquivo:linha] - [codigo]
+
+Por que #3: [resposta]
+  Evidencia: [arquivo:linha] - [codigo]
+
+CAUSA RAIZ: [declaracao clara]
+```
+
+---
+
+## Passo 3: Validar Causa Raiz
+
+A causa raiz deve ser:
+- [ ] Algo que voce pode MUDAR
+- [ ] Suportada por evidencia de codigo
+- [ ] Explica TODOS os sintomas
+
+**SE** nao validar: voltar ao Passo 2.
+
+---
+
+## Passo 4: Checkpoint
+
+```javascript
+TodoWrite({
+  todos: [
+    { content: "Reproduce: bug reproduzido", status: "completed", activeForm: "Bug reproduced" },
+    { content: "Investigate: codigo explorado", status: "completed", activeForm: "Code explored" },
+    { content: "Investigate: causa raiz identificada", status: "completed", activeForm: "Root cause identified" },
+    { content: "Fix: implementar correcao", status: "pending", activeForm: "Implementing fix" }
+  ]
+})
+```
+
+---
+
+## Output
+
+Causa raiz documentada com evidencia.
+
+---
+## PROXIMA FASE
+ACAO OBRIGATORIA: Read ~/.claude/commands/debug/03-fix.md

package/config/commands/debug/{02-fix.md → 03-fix.md}

@@ -1,7 +1,7 @@
-# Fase 2: Fix
+# Fase 3: Fix
 
 ## Contexto
-Causa raiz identificada. Implementar fix de forma AUTÔNOMA.
+Causa raiz identificada. Implementar fix de forma AUTONOMA.
 
 ---
 
@@ -9,7 +9,7 @@ Causa raiz identificada. Implementar fix de forma AUTÔNOMA.
 
 ### 0.1 Identificar Paths Afetados
 
-Extrair arquivos da causa raiz documentada na investigacao (fase 01-investigate).
+Extrair arquivos da causa raiz documentada na investigacao (fase 02-investigate).
 
 ### 0.2 Lista de Paths Criticos
 
@@ -53,7 +53,7 @@ Prosseguir direto para Passo 1 (autonomia total)
 describe('[contexto do bug]', () => {
   it('should [comportamento esperado]', () => {
     // Arrange: setup que causa o bug
-    // Act: ação que dispara o bug
+    // Act: acao que dispara o bug
     // Assert: verificar comportamento correto
   })
 })
@@ -64,25 +64,25 @@ describe('[contexto do bug]', () => {
 npm test -- --testPathPattern="[arquivo]"
 ```
 
-O teste DEVE falhar antes do fix. Se passar, o teste não reproduz o bug.
+O teste DEVE falhar antes do fix. Se passar, o teste nao reproduz o bug.
 
 ---
 
 ## Passo 2: Implementar Fix
 
-### 2.1 Fix Mínimo
+### 2.1 Fix Minimo
 ```
 FIX:
 Arquivo: [arquivo:linha]
-Antes: [código atual]
-Depois: [código novo]
+Antes: [codigo atual]
+Depois: [codigo 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
+- APENAS o necessario para resolver a causa raiz
+- NAO refatorar codigo nao relacionado
+- NAO adicionar features
 - Seguir patterns existentes do projeto
 
 ---
@@ -94,15 +94,30 @@ Justificativa: [por que resolve a causa raiz]
 npm test -- --testPathPattern="[arquivo]"
 ```
 
-### 3.2 Bug Não Reproduz
-Executar passos originais. Bug não deve ocorrer.
+### 3.2 Bug Nao Reproduz
+Executar passos originais. Bug nao deve ocorrer.
+
+---
+
+## Passo 4: Checkpoint
+
+```javascript
+TodoWrite({
+  todos: [
+    { content: "Investigate: causa raiz identificada", status: "completed", activeForm: "Root cause identified" },
+    { content: "Fix: teste de regressao criado", status: "completed", activeForm: "Regression test created" },
+    { content: "Fix: correcao implementada", status: "completed", activeForm: "Fix implemented" },
+    { content: "Verify: validar quality gates", status: "pending", activeForm: "Validating quality gates" }
+  ]
+})
+```
 
 ---
 
 ## Output
 
-Fix implementado. Teste de regressão passando.
+Fix implementado. Teste de regressao passando.
 
 ---
-## PRÓXIMA FASE
-AÇÃO OBRIGATÓRIA: Read ~/.claude/commands/debug/03-verify.md
+## PROXIMA FASE
+ACAO OBRIGATORIA: Read ~/.claude/commands/debug/04-verify.md

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

@@ -0,0 +1,81 @@
+# Fase 4: Verify
+
+## Contexto
+Fix implementado. Verificar e finalizar de forma AUTONOMA.
+
+---
+
+## Passo 1: Quality Gates
+
+Rodar em sequencia:
+```bash
+npm test
+npx tsc --noEmit
+npm run build
+```
+
+**Se falhar:** Corrigir e rodar novamente. Nao prosseguir ate passar.
+
+---
+
+## Passo 2: Verificacao Final
+
+- [ ] Testes passam
+- [ ] TypeScript sem erros
+- [ ] Build bem-sucedido
+- [ ] Bug nao reproduz mais
+
+---
+
+## Passo 3: Memory Sync (se bug nao-obvio)
+
+Se o bug foi dificil de encontrar, salvar na memory:
+
+```javascript
+mcp__memory__create_entities({
+  entities: [{
+    name: "{prefix}:bug:{nome-descritivo}",
+    entityType: "bug",
+    observations: [
+      "Sintoma: [...]",
+      "Causa raiz: [...]",
+      "Solucao: [...]",
+      "Arquivos: [...]"
+    ]
+  }]
+})
+```
+
+---
+
+## Passo 4: Checkpoint
+
+```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: commitar e push", status: "pending", activeForm: "Committing changes" }
+  ]
+})
+```
+
+---
+
+## Output
+
+Quality gates passando. Pronto para commit.
+
+---
+
+## Regras Inviolaveis
+
+1. **PROIBIDO** prosseguir com testes falhando
+2. **PROIBIDO** prosseguir com build falhando
+3. **PROIBIDO** perguntar ao user (so reportar no final)
+
+---
+## PROXIMA FASE
+ACAO OBRIGATORIA: Read ~/.claude/commands/debug/05-commit.md

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

@@ -0,0 +1,76 @@
+# 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: 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" }
+  ]
+})
+```
+
+---
+
+## Passo 5: 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

package/config/commands/debug.md

@@ -6,11 +6,11 @@ model: opus
 Investigar e resolver: $ARGUMENTS
 
 ## INICIAR
-AÇÃO OBRIGATÓRIA: Read ~/.claude/commands/debug/01-investigate.md
-Seguir instruções. Cada fase aponta para a próxima.
+ACAO OBRIGATORIA: Read ~/.claude/commands/debug/01-reproduce.md
+Seguir instrucoes. Cada fase aponta para a proxima.
 
 ## Fluxo
-Investigate → Fix → Verify → Fim (SEM PARADAS)
+Reproduce → Investigate → Fix → Verify → Commit → Fim (SEM PARADAS)
 
 ## Regras
 1. ZERO paradas até o final

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kakaroto-config",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Claude Code configuration by Pedro Jahara - autonomous workflows for /feature, /debug, /gate",
   "bin": {
     "kakaroto-config": "./bin/install.js"

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/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)