kakaroto-config 1.0.5 → 1.0.6

package/config/commands/debug/techniques/hypothesis-generation.md

@@ -1,30 +0,0 @@
-# Tecnica: Geracao de Hipoteses
-
-Antes de investigar profundamente, listar MULTIPLAS causas possiveis.
-
----
-
-## Passo 1: Brainstorm (minimo 3 hipoteses)
-
-| # | Hipotese | Probabilidade | Evidencia Inicial |
-|---|----------|---------------|-------------------|
-| 1 | [causa A] | Alta/Media/Baixa | [o que sugere isso] |
-| 2 | [causa B] | Alta/Media/Baixa | [o que sugere isso] |
-| 3 | [causa C] | Alta/Media/Baixa | [o que sugere isso] |
-
----
-
-## Passo 2: Ranking
-
-Ordenar hipoteses por:
-1. **Evidencia existente** (logs, reproducao, erros)
-2. **Frequencia historica** (bugs similares ja resolvidos)
-3. **Simplicidade** (Navalha de Occam)
-
----
-
-## Passo 3: Estrategia de Exploracao
-
-- Comecar pela hipotese #1 no Sequential Thinking
-- SE refutada: usar `branchFromThought` para explorar #2
-- Registrar hipoteses descartadas e POR QUE (evita repetir)

package/config/commands/debug/techniques/sequential-thinking-config.md

@@ -1,79 +0,0 @@
-# Tecnica: Sequential Thinking para Causa Raiz
-
-**OBRIGATORIO**: Usar `mcp__sequential-thinking__sequentialthinking` para analise profunda.
-
----
-
-## Configuracao Inicial
-
-```javascript
-mcp__sequential-thinking__sequentialthinking({
-  thought: "[hipotese inicial baseada em evidencias]",
-  nextThoughtNeeded: true,
-  thoughtNumber: 1,
-  totalThoughts: 8  // MINIMO 8 thoughts
-})
-```
-
----
-
-## Regras para Cada Thought
-
-Cada thought DEVE conter:
-
-1. **Hipotese especifica**: "Acredito que o bug acontece porque..."
-2. **Busca de evidencia**: Usar Grep/Read para encontrar arquivo:linha
-3. **Avaliacao**: A evidencia suporta ou refuta a hipotese?
-4. **Proxima acao**:
-   - SE suporta: Ir mais fundo ("Por que isso acontece?")
-   - SE refuta: Marcar `isRevision: true` e tentar alternativa
-
----
-
-## Parametros Especiais
-
-| Parametro | Quando Usar |
-|-----------|-------------|
-| `isRevision: true` | Quando descartando hipotese anterior |
-| `revisesThought: N` | Indicar qual thought esta sendo revisado |
-| `branchFromThought: N` | Quando explorando caminho alternativo |
-| `branchId: "hipotese-2"` | Identificar o branch atual |
-| `needsMoreThoughts: true` | Se precisa ir mais fundo |
-
----
-
-## Criterios de Parada
-
-Somente definir `nextThoughtNeeded: false` quando:
-
-- [ ] Chegou em algo que PODE SER MUDADO no codigo
-- [ ] Tem EVIDENCIA concreta (arquivo:linha + codigo)
-- [ ] Nao ha mais "por que?" logico para perguntar
-- [ ] A causa identificada explica TODOS os sintomas
-
----
-
-## Exemplo de Fluxo
-
-```
-Thought 1: "Hipotese: erro em validateInput()"
-  → Grep encontra validacao em services/videoService.ts:45
-  → Evidencia: funcao nao valida campo X
-
-Thought 2: "Por que nao valida campo X?"
-  → Read services/videoService.ts
-  → Evidencia: schema Zod nao inclui X (linha 12)
-
-Thought 3: "Por que schema nao inclui X?"
-  → git log mostra: adicionado em commit abc123
-  → Evidencia: campo X e novo, schema desatualizado
-
-Thought 4 (isRevision=true): "Mas wait, X deveria ser opcional..."
-  → Re-analisando: o problema e que X e required no destino
-
-Thought 5: "Onde X e required?"
-  → Grep encontra em api/handlers/upload.ts:78
-  → Evidencia: handler espera X mas nao recebe
-
-... continua ate causa raiz confirmada ...
-```

package/config/commands/feature/01-interview.md

@@ -1,143 +0,0 @@
-# Fase 1: Interview
-
-## Passo 1: Entender o Request
-
-Analisar $ARGUMENTS para identificar:
-- Qual feature está sendo solicitada
-- Termos-chave para busca
-- Área provável do codebase (api/, components/, services/)
-
----
-
-## Passo 2: Buscar Contexto Específico
-
-Baseado no Passo 1, carregar APENAS o necessário:
-
-### 2.1 Memory (se relevante)
-```
-mcp__memory__search_nodes({ query: "<termos-específicos-da-feature>" })
-```
-
-### 2.2 Codebase (áreas identificadas)
-```
-Grep: termos em <área-específica>/
-Read: arquivos diretamente relacionados
-```
-
-**Evitar:** `Glob: **/*.ts` ou buscas genéricas em todo codebase.
-
----
-
-## Passo 3: Identificar Patterns (sob demanda)
-
-Após encontrar código relevante, identificar:
-- Como components/services similares funcionam
-- Como erros são tratados nessa área
-- Patterns específicos a seguir
-
----
-
-## Passo 4: Reflexão
-
-Usar `mcp__sequential-thinking__sequentialthinking`:
-
-1. **O que descobri** - Síntese do contexto carregado
-2. **O que ainda posso descobrir** - Gaps que consigo preencher explorando mais
-3. **O que APENAS o user pode responder** - Decisões de produto, preferências UX
-4. **Formular perguntas mínimas** - Só o essencial
-
-`totalThoughts`: 4
-
----
-
-## Passo 5: Perguntas ao User (APENAS decisões de produto)
-
-**Usar AskUserQuestion para todas as perguntas.**
-
-### Perguntas típicas (adaptar ao contexto):
-- **Problema**: Qual problema principal resolve? (Eficiência/Funcionalidade/UX)
-- **Escopo**: MVP mínimo ou feature completa?
-- **Design**: Tem referência ou seguir patterns existentes?
-- **Trade-offs**: Se encontrar 2 approaches, qual preferir?
-
-Exemplo de uso:
-```javascript
-AskUserQuestion({
-  questions: [{
-    question: "[pergunta específica]",
-    header: "[2-3 palavras]",
-    options: [
-      { label: "[opção]", description: "[trade-off]" },
-      { label: "[opção]", description: "[trade-off]" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
----
-
-## Passo 6: Apresentar Descobertas
-
-Mostrar ao user:
-- Services/patterns encontrados
-- Tabelas relevantes do schema
-- Libs que serão usadas
-- Pattern que será seguido
-
----
-
-## Passo 7: Persistir Interview
-
-### 7.1 Gerar slug
-Primeira palavra do problema + data. Exemplo: `filtro-2026-01-10.md`
-
-### 7.2 Salvar respostas
-```
-Write .claude/interviews/{slug}.md
-Write .claude/interviews/current.md (cópia do conteúdo)
-```
-
-### 7.3 Formato do arquivo
-```markdown
-# Interview: {feature-name}
-
-## Contexto Descoberto
-- Services encontrados: [lista]
-- Patterns identificados: [lista]
-- Código reutilizável: [arquivos:linhas]
-
-## Perguntas e Respostas
-| # | Pergunta | Resposta | Impacto na Implementação |
-|---|----------|----------|--------------------------|
-| 1 | [pergunta] | [resposta] | [como afeta] |
-
-## Decisões Implícitas
-- [decisões inferidas do contexto ou defaults do projeto]
-
-## Termos-chave para Busca
-- [termos que outras fases podem usar para grep/search]
-```
-
----
-
-## Passo 8: Checkpoint
-
-Usar TodoWrite para registrar items da fase Interview como "completed".
-Adicionar "Spec: gerar especificacao" como "pending".
-
-**Gate:** Todos items de Interview devem estar "completed" E interviews/current.md deve existir.
-
----
-
-## Output
-
-Resumo estruturado:
-- Problema identificado
-- Escopo definido
-- Decisões de UX
-- Patterns a seguir
-
----
-## PRÓXIMA FASE
-AÇÃO OBRIGATÓRIA: Read ~/.claude/commands/feature/02-spec.md

package/config/commands/feature/02-spec.md

@@ -1,98 +0,0 @@
-# Fase 2: Spec
-
-## Passo 0: Context
-
-Contexto de projeto ja carregado em 01-interview (mesma sessao).
-
-### 0.1 Carregar Respostas da Interview
-```
-Read .claude/interviews/current.md
-```
-Este arquivo contém: perguntas respondidas, decisões implícitas, termos-chave.
-**Usar como referência** para manter consistência com o que foi acordado.
-
-### 0.2 Buscar Patterns (se necessário)
-```
-mcp__memory__search_nodes({ query: "pattern" })
-```
-
-### 0.3 SE retomando sessão interrompida
-```
-Read .claude/interviews/current.md (contexto original)
-Read .claude/specs/current.md (spec parcial, se existir)
-```
-
----
-
-## Passo 1: Pensamento Estruturado
-
-Usar `mcp__sequential-thinking__sequentialthinking` para planejar:
-
-1. **Thought 1**: Quais componentes esta feature precisa?
-2. **Thought 2**: Onde código similar existe no codebase?
-3. **Thought 3**: Quais patterns do projeto devo seguir?
-4. **Thought 4**: Quais trade-offs arquiteturais existem?
-5. **Thought 5**: Qual a abordagem mais simples que resolve?
-
-`totalThoughts`: 5-8 (ajustar conforme complexidade)
-
----
-
-## Passo 2: Análise de Reutilização
-
-### 2.1 Buscar Código Existente
-```
-Grep: termos da feature em services/, utils/, lib/
-Glob: arquivos com nomes similares
-```
-
-### 2.2 Mapear Reutilização
-| Necessidade | Código Existente | Ação |
-|-------------|------------------|------|
-| [o que precisa] | [arquivo:linha] | Reutilizar/Estender/Criar |
-
-**Default = reutilizar. Código novo precisa justificativa.**
-
----
-
-## Passo 3: Gerar Spec
-
-Carregar template:
-```
-Read ~/.claude/templates/spec-template.md
-```
-
-Preencher template com informações coletadas na interview.
-
----
-
-## Output
-
-1. MOSTRAR spec completa ao user (visibilidade)
-2. Spec = contrato, implementacao deve seguir
-
----
-
-## Passo 4: Persistir Spec
-
-1. Gerar slug: primeira palavra do problema + data
-   Exemplo: `filtro-2026-01-10.md`
-
-2. Salvar spec:
-   ```
-   Write .claude/specs/{slug}.md
-   Write .claude/specs/current.md (copia do conteudo)
-   ```
-
-3. Confirmar: "Spec salva em .claude/specs/{slug}.md"
-
----
-
-## Passo 5: Checkpoint
-
-Usar TodoWrite para registrar items da fase Spec como "completed".
-Adicionar "Planner: criar plano de tarefas" como "pending".
-
----
-## PROXIMA FASE
-ACAO OBRIGATORIA: Read ~/.claude/commands/feature/03-planner.md

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

@@ -1,200 +0,0 @@
-# Fase 3: Planner
-
-## Passo 0: Context
-
-SE continuacao direta de 02-spec (mesma sessao):
-  Contexto ja disponivel, prosseguir
-
-### 0.1 Carregar Contexto da Interview (SE necessário)
-```
-Read .claude/interviews/current.md
-```
-Consultar SE surgir dúvida sobre decisões já tomadas na Interview.
-Evita re-perguntar o que já foi respondido.
-
-### 0.2 SE retomando sessão interrompida
-```
-Read .claude/interviews/current.md (decisões originais)
-Read .claude/specs/current.md (spec aprovada)
-Read .claude/plans/current.md (plano parcial, se existir)
-```
-
----
-
-## 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: Registro de Decisões
-
-### 7.1 Decisões Tomadas
-Documentar decisões feitas autonomamente durante o planejamento:
-
-| Decisão | Opções Consideradas | Escolha | Justificativa |
-|---------|---------------------|---------|---------------|
-| [ex: estrutura de dados] | Array / Map | Map | Lookup O(1) necessário |
-| [ex: local do código] | services/ / utils/ | services/ | Segue pattern existente |
-
-### 7.2 Decisões Pendentes
-Listar decisões que APENAS o user pode tomar:
-
-| Decisão | Opções | Impacto na Feature |
-|---------|--------|-------------------|
-| [ex: formato export] | CSV / JSON / Excel | Afeta UX de download |
-
-**Critérios para classificar como "Pendente":**
-1. Impacta comportamento/UX visível ao user final
-2. Não existe default claro no projeto
-3. Não foi respondida na Interview (verificar interviews/current.md)
-
----
-
-## Passo 8: Clarificações (CONDICIONAL)
-
-**SE "Decisões Pendentes" NÃO estiver vazio:**
-
-Usar AskUserQuestion para resolver cada decisão pendente.
-**Limite:** Máximo 5 perguntas por execução.
-
-```javascript
-AskUserQuestion({
-  questions: [{
-    question: "[Decisão pendente como pergunta]",
-    header: "[2-3 palavras]",
-    options: [
-      { label: "[Opção A]", description: "[trade-off/impacto]" },
-      { label: "[Opção B]", description: "[trade-off/impacto]" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-Após respostas:
-1. Mover decisões de "Pendentes" para "Tomadas"
-2. Adicionar resposta do user na coluna "Escolha"
-3. Atualizar plano se necessário
-
-**SE "Decisões Pendentes" estiver vazio:**
-Prosseguir direto para Passo 9.
-
----
-
-## Passo 9: 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)
-   ```
-
----
-
-## Passo 10: Checkpoint
-
-Usar TodoWrite para registrar items da fase Planner como "completed".
-Adicionar "Implement: executar plano aprovado" como "pending".
-
-**Gates:**
-- Plano deve estar salvo
-- "Decisões Pendentes" deve estar vazio (todas resolvidas)
-
----
-
-## Output
-
-1. Salvar plano (usar TodoWrite para tracking)
-2. Chamar `EnterPlanMode` (não AskUserQuestion para aprovação)
-3. **AGUARDAR aprovacao do user**
-
-**Nota:** EnterPlanMode é para aprovar o PLANO. Decisões pendentes devem ser resolvidas ANTES via AskUserQuestion (Passo 8).
-
----
-
-## 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

@@ -1,81 +0,0 @@
-# Fase 4: Implement
-
-## Contexto
-Plano foi aprovado. Executar de forma AUTÔNOMA até o fim.
-
-**Regras desta fase:**
-- Executar sem pedir confirmação ao user
-- Erros devem ser corrigidos, não abandonados
-- Seguir spec aprovada, não modificar escopo
-- Toda função nova precisa de teste
-
----
-
-## 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).
-
----
-
-## Passo 4: Checkpoint
-
-Usar TodoWrite para marcar todas tarefas de implementação como "completed".
-Adicionar "Quality: executar quality gates" como "pending".
-
-**Gate:** Todas tarefas do plano devem estar "completed".
-
----
-
-## Output
-
-Implementação completa.
-
----
-## PRÓXIMA FASE
-AÇÃO OBRIGATÓRIA: Read ~/.claude/commands/feature/05-quality.md
-