Pedir para a IA construir um app e receber trezentas linhas de código que você não sabe explicar é uma sensação conhecida. Em 19/10/2026, a pergunta "como lidar com código escrito por IA que eu não entendo?" chegou a 622 pontos e 764 comentários no Hacker News.
O VibeWise é um plugin aberto, com licença MIT, para o Claude Code e para o Codex que inverte a ordem. Antes de escrever, a IA pergunta como você resolveria, ajuda a examinar as opções e explica o que for novo. Você decide o desenho; a IA escreve o código e depois explica o que mudou e por quê.
Este guia traz o que o vídeo cortou: o comando de instalação, o passo a passo do primeiro projeto, o que são os pontos de checagem e como responder a cada um, e como usar no Codex. Os dados vêm do README do projeto (github.com/nykooi1/vibe-wise), conferido em 30/10/2026.
Comando de instalação pelo diretório oficial de plugins
Você precisa de um Claude Code atualizado e de Python 3 instalado (o plugin usa Python para restaurar o contexto de aprendizado e para zerar as anotações; não precisa de pacotes extras). O Claude Code em si exige plano pago; o plugin é gratuito.
Dentro do Claude Code, rode:
/plugin install vibe-wise@anthropic-plugin-directory
Escolha o escopo da instalação e confirme. Não precisa configurar marketplace nenhum. Se a sua versão do Claude Code não tiver o diretório oficial, o caminho alternativo é pelo GitHub, um comando de cada vez:
/plugin marketplace add nykooi1/vibe-wise
/plugin install vibe-wise@vibe-wise
Passo a passo do primeiro projeto
- Reinicie o Claude Code na pasta do projeto em que quer trabalhar. Sem Git, comece sempre pela pasta de topo do projeto.
- Rode
/vibe-wise:learn. - Responda a configuração, que faz uma pergunta por vez. Use as setas e Enter. A opção "Use defaults" pula as preferências.
- Peça para construir algo, por exemplo um app de notas. Num projeto novo ou num repositório que você não conhece, os dois funcionam; num repositório existente, a IA primeiro lê o código e desenha um pequeno mapa do sistema.
- Responda às perguntas e confirme cada etapa nos pontos de checagem.
Para mudar o ritmo, é só dizer em português: "use menos pontos de checagem", "foque no backend", "use perguntas de múltipla escolha", "só implemente este" ou "pausar o aprendizado". Para retomar, /vibe-wise:learn.
Os pontos de checagem e como responder a cada um
São três tipos, e não são três paradas obrigatórias:
| Checagem | O que acontece | O que você responde |
|---|---|---|
| Construção (Build) | Você raciocina com a IA sobre como resolver o problema | Responde em português simples; pode pedir ajuda ou dizer "pular" |
| Desenho (Design) | A IA propõe o desenho. Confirmar registra e continua planejando, sem código | "Confirm and continue" ou "Discuss" |
| Implementação (Implementation) | A IA mostra as mudanças exatas no código | "Implement this step" autoriza escrever, ou "Discuss" |
O exemplo do README é um app de notas em que uma nota pode estar em várias pastas. O ponto de checagem pergunta: "se você apagar a pasta Viagem, o que acontece com a nota que também está em Verão?" Você responde (mantém em Verão; sem pasta, a nota fica solta), e só depois a IA propõe a tabela que liga notas a pastas. Ela só escreve o código quando você confirma.
Quando a IA propõe detalhes extras, ela os separa das suas decisões numa lista curta, com o motivo de cada um. Você pode questionar qualquer item.
Depois de implementar, ela explica o que mudou, como o código principal funciona, por que combina com a sua decisão, quais testes escreveu e o resultado dos testes. Peça para aprofundar onde não entendeu.
O nível (iniciante, intermediário ou avançado) muda o apoio que você recebe, não quem decide.
Como usar no Codex e zerar as anotações
No terminal, um comando de cada vez:
codex plugin marketplace add nykooi1/vibe-wise
codex plugin add vibe-wise@vibe-wise
Inicie o Codex no projeto e rode $vibe-wise:learn. No Codex os comandos usam $ no lugar de /. Rode de novo no começo de cada sessão, ou quando o Codex parecer ter perdido o modo de aprendizado: ele retoma das anotações salvas, sem repetir a configuração.
As preferências, as anotações e o mapa do projeto ficam na pasta .vibe-wise/, na raiz do projeto, e o Claude Code e o Codex compartilham a mesma. Para manter as anotações fora do Git, acrescente .vibe-wise/ ao .gitignore; o plugin não faz isso sozinho.
Para recomeçar do zero, rode /vibe-wise:reset (no Codex, $vibe-wise:reset). Ele mostra o projeto e pergunta "Cancel / Reset learning". Depois de confirmado, guarda uma cópia do perfil, do progresso e do mapa na pasta backups/ e reinicia o processo. O código e os outros projetos não são tocados.
Limites
- Não ensina programação do zero sem esforço: você responde e decide em cada passo.
- Precisa de Python 3 instalado.
- O plugin é gratuito; o Claude Code e o Codex pedem plano pago.
- As anotações salvas entram no contexto da IA, então valem as suas configurações normais de dados do Claude Code ou do Codex.
- Não há conta extra, servidor próprio nem telemetria do plugin.
Fontes
- README do VibeWise: https://github.com/nykooi1/vibe-wise (acessado em 30/10/2026)
- Ask HN, "How to deal with shipping AI-written code you don't understand?": https://news.ycombinator.com/item?id=50151036