Sobre o projeto

wicked-garden é um conjunto de ferramentas especializado projetado para aumentar agentes de codificação como Claude Code, Codex e Cursor. Ao contrário de plugins que tentam substituir o planejamento nativo ou as capacidades de swarm de um agente, o wicked-garden se concentra em preencher lacunas críticas que esses agentes não podem abordar sozinhos. Sua filosofia central é 'feito é re-derivado, não afirmado', garantindo que a conclusão da tarefa seja verificada por meio de evidências independentes em vez de simples autorrelato. Principais capacidades incluem: 1. **Verificação com Gate de Evidências**: Ele re-executa provas e rejeita falsas afirmações de 'testes passaram'. Se um backend estiver ausente, ele falha fechado, garantindo que não haja marcas de verificação verdes vazias. 2. **Análise de Gráfico de Código**: Ele identifica 'arestas injetadas' (como links de evento para consumidor ou comando para agente) que as buscas padrão de grep perdem. Isso permite uma análise precisa do raio de impacto e rastreamento de linhagem. 3. **Memória entre Sessões**: Através da camada `wicked-estate`, ele lembra decisões de sessões anteriores, ajudando os agentes a manter o contexto em projetos de longo prazo. 4. **Painéis de Revisão Multi-Modelo**: Ele pode convocar um 'conselho' de diferentes modelos de IA (por exemplo, Antigravity, Codex) para fornecer segundas opiniões e perspectivas diversas sobre decisões arquiteturais. 5. **Playbooks Específicos de Repositório**: Em vez de re-derivar como trabalhar em um repositório para cada tarefa, ele carrega playbooks gerados (por exemplo, `fix-bug`, `add-feature`) com base no HEAD atual. 6. **Refatoração Determinística**: Ele realiza renomeações como operações de gráfico em vez de simples busca e substituição, reduzindo erros em bases de código complexas. O wicked-garden opera em um modelo de 'forma de trabalho' em vez de um pipeline rígido. Um hook analisa a forma do trabalho (por exemplo, correção de erro de digitação vs. corte de migração) e aplica o nível apropriado de rigor. Isso garante que tarefas simples não sejam sobrecarregadas por verificação pesada, enquanto mudanças críticas passam por gates estritos e independentemente atestados. O conjunto de ferramentas é extensível, permitindo que os usuários enviem seus próprios pacotes de domínio. Ele requer Python 3.9+ e Node.js, com `wicked-vault` como um peer obrigatório para o gate de evidências. Ele se integra com vários CLIs e pode compilar seus gates de verificação em qualquer repositório, tornando o mecanismo de imposição portátil e independente da instalação do wicked-garden.