kakaroto-config 1.0.0

package/config/commands/feature/03-planner.md

@@ -0,0 +1,123 @@
+# Fase 3: Planner
+
+## Passo 0: Context
+
+SE continuacao direta de 02-spec (mesma sessao):
+  Contexto ja disponivel, prosseguir
+
+SE retomando sessao interrompida:
+```
+Read .claude/specs/current.md
+```
+
+---
+
+## Passo 1: Pensamento Estruturado
+
+Usar `mcp__sequential-thinking__sequentialthinking` para planejar:
+
+1. **Thought 1**: Quais são as dependências entre tarefas?
+2. **Thought 2**: Qual ordem minimiza retrabalho?
+3. **Thought 3**: Quais riscos podem bloquear implementação?
+4. **Thought 4**: Onde reutilizar código vs criar novo?
+5. **Thought 5**: Quais testes preciso para cada tarefa?
+
+`totalThoughts`: 5-7
+
+---
+
+## Passo 2: Análise Anti-Duplicação (OBRIGATÓRIO)
+
+### 2.1 Mapeamento de Código Reutilizável
+| Necessidade | Código Existente | Arquivo:Linha | Ação |
+|-------------|------------------|---------------|------|
+| [o que precisa] | [helper/service] | [path:line] | Reutilizar/Estender/Criar |
+
+### 2.2 Oportunidades de Abstração
+Se 3+ lugares usam padrão similar, criar abstração:
+| Padrão Repetido | Locais | Proposta |
+|-----------------|--------|----------|
+| [código duplicado] | [arquivos] | [helper/hook] |
+
+### 2.3 Checklist
+- [ ] Justifiquei cada arquivo NOVO?
+- [ ] Verifiquei helpers similares existentes?
+- [ ] Código novo pode ser generalizado?
+
+---
+
+## Passo 3: Breakdown de Tarefas
+
+Criar lista ordenada baseada na spec:
+
+| # | Tarefa | Arquivos | Depende de |
+|---|--------|----------|------------|
+| 1 | [tarefa] | [arquivos] | - |
+| 1.1 | Testes para tarefa 1 | [*.test.ts] | 1 |
+| 2 | [tarefa] | [arquivos] | 1 |
+| 2.1 | Testes para tarefa 2 | [*.test.ts] | 2 |
+
+**Regras:**
+- Tarefas pequenas (< 30 min)
+- Uma responsabilidade por tarefa
+- Toda função nova = teste correspondente
+- Dependências claras
+
+---
+
+## Passo 4: Resumo de Arquivos
+
+**Criar:**
+- [novos arquivos]
+
+**Modificar:**
+- [arquivos existentes]
+
+**Deletar:**
+- [arquivos a remover]
+
+---
+
+## Passo 5: Riscos
+
+| Risco | Probabilidade | Mitigação |
+|-------|---------------|-----------|
+| [risco] | Alta/Média/Baixa | [como reduzir] |
+
+---
+
+## Passo 6: Quality Gates
+
+Apos implementacao:
+- [ ] `npm test` passa
+- [ ] `npx tsc --noEmit` sem erros
+- [ ] `npm run build` sucesso
+
+---
+
+## Passo 7: Persistir Plano
+
+1. Usar mesmo slug da spec (gerado em 02-spec)
+
+2. Salvar plano:
+   ```
+   Write .claude/plans/{slug}.md
+   Write .claude/plans/current.md (copia do conteudo)
+   ```
+
+---
+
+## Output
+
+1. Salvar plano (usar TodoWrite para tracking)
+2. Chamar `EnterPlanMode`
+3. **AGUARDAR aprovacao do user**
+
+---
+
+## Pos-Aprovacao
+
+Apos user aprovar via EnterPlanMode:
+
+ACAO OBRIGATORIA: Read ~/.claude/commands/feature/04-implement.md
+Executar implementacao de forma AUTONOMA.

package/config/commands/feature/04-implement.md

@@ -0,0 +1,74 @@
+# Fase 4: Implement
+
+## Contexto
+Plano foi aprovado. Executar de forma AUTÔNOMA até o fim.
+
+---
+
+## Passo 1: Setup
+
+### 1.1 Carregar Contexto
+```
+Read .claude/specs/current.md (spec e o contrato)
+Read .claude/plans/current.md (plano aprovado)
+```
+
+### 1.2 Usar TodoWrite
+Registrar todas as tarefas do plano aprovado.
+Marcar como `in_progress` conforme executa.
+
+### 1.3 Relembrar Spec
+A spec e o contrato. Implementacao DEVE seguir a spec.
+
+---
+
+## Passo 2: Implementação
+
+Para cada tarefa do plano:
+
+1. **Marcar in_progress** (TodoWrite)
+2. **Implementar** seguindo spec e patterns do projeto
+3. **Criar teste** para cada função nova
+4. **Marcar completed** (TodoWrite)
+
+### Regras de Código
+- Funções < 50 linhas
+- Max 2 níveis de nesting
+- Tipos explícitos em exports
+- Reutilizar código existente (mapeado na spec)
+
+### Regras de Testes
+- Toda função exportada = teste
+- Happy path + edge cases + erros
+- Seguir pattern de testes existentes no projeto
+
+---
+
+## Passo 3: Verificação Rápida
+
+Após implementar cada módulo:
+```bash
+npm test -- --testPathPattern="[arquivo]"
+npx tsc --noEmit
+```
+
+Se falhar: corrigir e continuar (não parar).
+
+---
+
+## Output
+
+Implementação completa.
+
+---
+## PRÓXIMA FASE
+AÇÃO OBRIGATÓRIA: Read ~/.claude/commands/feature/05-quality.md
+
+---
+
+## Regras Invioláveis
+
+1. **PROIBIDO** pedir confirmação ao user
+2. **PROIBIDO** abandonar por erro (corrigir e continuar)
+3. **PROIBIDO** modificar escopo (seguir spec aprovada)
+4. **PROIBIDO** pular testes

package/config/commands/feature/05-quality.md

@@ -0,0 +1,122 @@
+# Fase 5: Quality
+
+## Contexto
+Implementação completa. Executar quality gates de forma AUTÔNOMA.
+
+---
+
+## Passo 1: Agents de Qualidade
+
+Executar em ordem (SE falhar, corrigir e continuar):
+
+### 1.0 Test Fixer (BASELINE)
+Garantir que codigo implementado passa nos testes ANTES de refatorar.
+```javascript
+Task({
+  subagent_type: "test-fixer",
+  prompt: "Rodar npm test. Se falhar, corrigir. NAO criar testes novos ainda - apenas garantir baseline funciona.",
+  description: "Baseline test check"
+})
+```
+SE FAIL: Corrigir antes de prosseguir.
+
+### 1.1 Code Simplifier
+```javascript
+Task({
+  subagent_type: "code-simplifier",
+  prompt: "Simplificar codigo implementado. Reduzir complexidade. Melhorar legibilidade.",
+  description: "Simplify new code"
+})
+```
+
+### 1.2 DRY Enforcer
+```javascript
+Task({
+  subagent_type: "dry-enforcer",
+  prompt: "Detectar duplicacoes no codigo novo. Sugerir abstracoes. Reutilizar codigo existente.",
+  description: "Remove duplications"
+})
+```
+
+### 1.3 Test Fixer (VERIFICACAO)
+Garantir que refatoracoes nao quebraram nada.
+```javascript
+Task({
+  subagent_type: "test-fixer",
+  prompt: "Rodar npm test apos refatoracoes. Corrigir testes que falharem. Criar testes faltantes para funcoes novas.",
+  description: "Post-refactor test fix"
+})
+```
+
+### 1.4 Code Reviewer
+```javascript
+Task({
+  subagent_type: "code-reviewer",
+  prompt: "Review final do codigo. Verificar qualidade, seguranca, patterns do projeto.",
+  description: "Final code review"
+})
+```
+
+### 1.5 Visual Validator (SE modificou UI)
+Apenas se modificou: `components/`, `pages/`, `app/`, `*.css`, `*.tsx`
+```javascript
+Task({
+  subagent_type: "visual-validator",
+  prompt: "Validar UI. Iniciar dev server. Verificar erros de console. Testar fluxos modificados.",
+  description: "Validate UI changes"
+})
+```
+
+### 1.6 Terraform Validator (SE modificou env/terraform)
+Apenas se modificou: `.env*`, `terraform/**/*.tf`, `terraform/**/*.tfvars*`, `variables.tf`
+```javascript
+Task({
+  subagent_type: "terraform-validator",
+  prompt: "Validar consistência Terraform. Verificar variáveis em .env.example, variables.tf, main.tf, tfvars.example. Corrigir inconsistências.",
+  description: "Validate Terraform config"
+})
+```
+
+---
+
+## Passo 2: Quality Gates Finais
+
+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 3: Memory Sync
+
+```javascript
+Task({
+  subagent_type: "memory-sync",
+  prompt: "Sincronizar knowledge graph. Atualizar entidades obsoletas. Criar novas para patterns/conhecimento adquirido.",
+  description: "Sync memory graph"
+})
+```
+
+---
+
+## Passo 4: Relatório Final
+
+Reportar ao user:
+- Feature implementada
+- Testes criados/passando
+- Build sucesso
+- Arquivos criados/modificados
+
+---
+
+## Regras Invioláveis
+
+1. **PROIBIDO** pular agents de qualidade
+2. **PROIBIDO** prosseguir com testes falhando
+3. **PROIBIDO** prosseguir com build falhando
+4. **PROIBIDO** perguntar ao user (só reportar no final)

package/config/commands/feature.md

@@ -0,0 +1,19 @@
+---
+model: opus
+---
+# Feature Workflow
+
+Desenvolver: $ARGUMENTS
+
+## INICIAR
+AÇÃO OBRIGATÓRIA: Read ~/.claude/commands/feature/01-interview.md
+Seguir instruções. Cada fase aponta para a próxima.
+
+## Fluxo
+Interview → Spec → Planner → [APROVAÇÃO] → Implement → Quality → Fim
+
+## Regras
+1. PROIBIDO parar entre fases (exceto EnterPlanMode)
+2. PROIBIDO AskUserQuestion para aprovar spec/planner
+3. PROIBIDO pedir confirmação após aprovação do plano
+4. Erros: corrigir e continuar, não abandonar

package/config/commands/gate.md

@@ -0,0 +1,313 @@
+# Quality Gate
+
+Validacao completa do codigo: **current changes** vs **origin/main**
+
+**Mode:** Orquestra agents especializados para validacao abrangente. Corrige problemas automaticamente.
+
+**Uso:** Rodar antes de push para main, ou periodicamente para garantir qualidade.
+
+---
+
+## Context Loading (OBRIGATORIO)
+
+Carregar contexto do projeto:
+- `mcp__memory__search_nodes({ query: "config" })` - escopo, comandos, quality gates
+- `mcp__memory__search_nodes({ query: "ambiente" })` - local/producao
+
+---
+
+## Phase 0: Test Coverage Gate (BLOQUEANTE)
+
+**Esta fase e BLOQUEANTE. Validacao NAO passa sem testes.**
+
+### Verificar Cobertura
+
+```bash
+# Identificar arquivos de codigo modificados (excluindo testes)
+git diff origin/main...HEAD --name-only | grep -E '\.(ts|tsx)$' | grep -v '\.test\.' | grep -v '\.d\.ts'
+```
+
+Para cada arquivo em `services/`, `utils/`, `api/`, `cron/`:
+1. Verificar se existe `[arquivo].test.ts` correspondente
+2. Se NAO existe: **FAIL** - invocar `test-fixer` para criar
+
+### Se Cobertura Insuficiente
+
+1. Invocar `Task` tool com `subagent_type: test-fixer`
+2. NAO prosseguir ate testes existirem
+3. Testes devem PASSAR antes de continuar para Phase 1
+
+**Somente prosseguir quando todos os arquivos de codigo tiverem testes correspondentes.**
+
+---
+
+## Phase 1: Initial Quality Gates
+
+Buscar comandos de quality gates na memory (ex: `quality_gates`).
+
+Rodar:
+```bash
+npm run test && npx tsc --noEmit && npm run build
+```
+
+Se algum falhar, delegue para `test-fixer` agent para corrigir antes de prosseguir.
+
+---
+
+## Phase 2: Diff Analysis
+
+```bash
+git fetch origin main
+git diff origin/main...HEAD --stat
+```
+
+Identificar:
+- Arquivos modificados
+- Linhas adicionadas/removidas
+- Se arquivos de ambiente/config mudaram
+
+---
+
+## Phase 3: Agent Delegation
+
+Based on changes detected, invoke appropriate agents **using Task tool with subagent_type**.
+
+**IMPORTANTE:** Todos os agents sao TOTALMENTE AUTONOMOS - eles irao identificar E CORRIGIR problemas automaticamente.
+
+**Ordem de execucao:**
+`test-fixer (baseline) -> code-simplifier -> dry-enforcer -> test-fixer (verificacao) -> code-reviewer -> visual-validator (se UI) -> terraform-validator (se env)`
+
+### 3.1 Test Fixer (BASELINE)
+
+Garantir que codigo implementado passa nos testes ANTES de refatorar.
+
+**Invoke:** `Task` tool with `subagent_type: test-fixer`
+
+**Prompt:** "Rodar npm test. Se falhar, corrigir. NAO criar testes novos ainda - apenas garantir baseline funciona."
+
+**Expected output:**
+- All tests passing
+- Baseline funcionando
+
+**If tests fail:** Fix before proceeding. NAO prosseguir ate baseline passar.
+
+### 3.2 Code Simplification
+
+**Invoke:** `Task` tool with `subagent_type: code-simplifier`
+
+**Expected output:**
+- Dead code removed
+- Naming improved
+- Structure simplified
+- Magic values extracted
+
+### 3.3 DRY Analysis
+
+**Invoke:** `Task` tool with `subagent_type: dry-enforcer`
+
+**Expected output:**
+- Unused existing code that should have been used
+- Duplications within new code
+- Abstraction opportunities
+
+**If issues found:** Fix before proceeding.
+
+### 3.4 Test Fixer (VERIFICACAO)
+
+Garantir que refatoracoes nao quebraram nada.
+
+**Invoke:** `Task` tool with `subagent_type: test-fixer`
+
+**Prompt:** "Rodar npm test apos refatoracoes. Corrigir testes que falharem. Criar testes faltantes para funcoes novas."
+
+**Expected output:**
+- All tests passing
+- New functions have tests
+- No skipped tests without justification
+
+**If tests fail:** Fix before proceeding.
+
+### 3.5 Code Review
+
+**Invoke:** `Task` tool with `subagent_type: code-reviewer`
+
+**Expected output:**
+- Security issues (CRITICAL)
+- Type safety violations (CRITICAL)
+- Code quality issues (HIGH/MEDIUM)
+- Environment compatibility issues
+
+**If CRITICAL issues found:** Fix before proceeding.
+
+### 3.6 Visual Validation (SE UI)
+
+**Detect UI changes:**
+```bash
+git diff origin/main...HEAD --name-only | grep -E '\.(tsx|css|scss)$' | grep -v '\.test\.' | grep -v '\.spec\.'
+```
+
+**If UI files found:**
+
+**Invoke:** `Task` tool with `subagent_type: visual-validator`
+
+**Expected output:**
+- All pages load without console errors
+- Modified components render correctly
+- Interactions work (modals open, etc.)
+
+**Behavior:**
+- Agent is FULLY AUTONOMOUS
+- Starts dev server, opens headless browser
+- Navigates to modified screens
+- Auto-fixes errors (max 3 attempts)
+- Only returns when working OR exhausted attempts
+
+**If FAIL after 3 attempts:** BLOCK gate, report errors to user.
+
+### 3.7 Environment Validation (SE env)
+
+**Detect env changes:**
+```bash
+git diff origin/main...HEAD --name-only | grep -E '\.env|terraform/|\.tfvars'
+```
+
+**If env/terraform files found:**
+
+**Invoke:** `Task` tool with `subagent_type: terraform-validator`
+
+**Expected output:**
+- All env vars consistent across files (.env.example, variables.tf, main.tf, tfvars.example)
+- No hardcoded paths in code
+- Path pattern: `process.env.VAR || './default'`
+- Auth works in both environments
+
+**Behavior:**
+- Agent is FULLY AUTONOMOUS
+- Extracts variables from all config files
+- Compares sets and identifies inconsistencies
+- Auto-fixes missing variables in each file
+- Searches and fixes hardcoded paths
+- Runs `npx tsc --noEmit` to verify no errors introduced
+
+**If FAIL:** BLOCK gate, report inconsistencies to user.
+
+---
+
+## Phase 4: Agent Results Aggregation
+
+Collect results from all agents (na ordem de execucao):
+
+| Agent | Status | Issues Found | Fixed |
+|-------|--------|--------------|-------|
+| test-fixer (baseline) | PASS/FAIL | X | X |
+| code-simplifier | PASS/FAIL | X | X |
+| dry-enforcer | PASS/FAIL | X | X |
+| test-fixer (verificacao) | PASS/FAIL | X | X |
+| code-reviewer | PASS/FAIL | X | X |
+| visual-validator | SKIP/PASS/FAIL | X | X |
+| terraform-validator | SKIP/PASS/FAIL | X | X |
+
+---
+
+## Phase 5: Final Verification
+
+Re-run all quality gates after agent fixes:
+
+```bash
+npm run test && npx tsc --noEmit && npm run build
+```
+
+All must pass before proceeding.
+
+---
+
+## Phase 6: Boundaries Check
+
+Buscar `codebase_scope` e `forbidden_paths` na memory.
+
+- [ ] Somente arquivos dentro do escopo modificados
+- [ ] Nenhuma mudanca em arquivos proibidos
+
+If boundary violated, revert those changes.
+
+---
+
+## Phase 7: Summary Report
+
+Gerar relatorio consolidado:
+
+```markdown
+## Quality Gate Report
+
+**Status:** PASSED / FAILED
+**Date:** [timestamp]
+**Branch:** [current branch]
+**Commits:** [count] commits ahead of origin/main
+
+### Agent Analysis Summary
+
+| Agent | Status | Issues Found | Fixed |
+|-------|--------|--------------|-------|
+| test-fixer (baseline) | [PASS/FAIL] | X | X |
+| code-simplifier | [PASS/FAIL] | X | X |
+| dry-enforcer | [PASS/FAIL] | X | X |
+| test-fixer (verificacao) | [PASS/FAIL] | X | X |
+| code-reviewer | [PASS/FAIL] | X | X |
+| visual-validator | [SKIP/PASS/FAIL] | X | X |
+| terraform-validator | [SKIP/PASS/FAIL] | X | X |
+
+### Quality Gates
+
+| Gate | Status |
+|------|--------|
+| Tests | PASS/FAIL |
+| TypeScript | PASS/FAIL |
+| Build | PASS/FAIL |
+| Boundaries | PASS/FAIL |
+
+### Key Findings
+
+- [List of significant issues found and fixed]
+
+### Recommendations
+
+- [Any manual actions needed]
+```
+
+---
+
+## Manual Fallback
+
+If agent delegation is not working, fall back to manual checklist:
+
+<details>
+<summary>Manual Security Scan</summary>
+
+| Vulnerability | Pattern | Action |
+|--------------|---------|--------|
+| Hardcoded Secrets | API keys, tokens in code | Move to env var |
+| `eval()` usage | `eval()`, `new Function()` | Remove or replace |
+| Command Injection | `child_process.exec()` with vars | Use `execFile()` |
+| Sensitive Logs | Passwords, tokens in `console.log` | Remove or redact |
+
+</details>
+
+<details>
+<summary>Manual Code Cleanup</summary>
+
+- [ ] Delete unused imports
+- [ ] Delete unused variables
+- [ ] Delete commented-out code
+- [ ] Rename generic variables
+- [ ] Functions < 50 lines
+- [ ] Nesting < 3 levels
+
+</details>
+
+<details>
+<summary>Manual DRY Check</summary>
+
+- [ ] Checked existing helpers before creating new?
+- [ ] No duplicated functionality?
+
+</details>

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "kakaroto-config",
+  "version": "1.0.0",
+  "description": "Claude Code configuration by Pedro Jahara - autonomous workflows for /feature, /debug, /gate",
+  "bin": {
+    "kakaroto-config": "./bin/install.js"
+  },
+  "files": [
+    "bin",
+    "config"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "ai",
+    "config",
+    "workflow"
+  ],
+  "author": "Pedro Jahara",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pedrojahara/kakaroto-config"
+  }
+}