Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

improve

A skill de auditoria somente leitura do shadcn: um modelo forte acha o que vale corrigir e escreve planos passo a passo que um modelo mais barato consegue executar.

Análise de ReviewRamble editors · Atualizado

Ver no GitHub Código aberto

Compartilhe esta página:XLinkedInFacebookRedditWhatsAppE-mail

Nossa nota

3.9/5

improve transforma um modelo caro em um revisor cuidadoso que escreve ordens de serviço em vez de código, que é a divisão certa, embora ninguém tenha publicado quanto essa divisão economiza.

O que é improve?

improve é uma skill de agente do shadcn, autor do shadcn/ui. Você roda `/improve` em um repositório e a skill mapeia o stack e seus comandos de build, teste e lint, audita o código em nove categorias (correção, segurança, desempenho, testes, dívida técnica, dependências, experiência do desenvolvedor, documentação e rumo do produto) e devolve uma tabela de achados. Cada achado cita arquivo e linha, com impacto, esforço e confiança. Você escolhe quais viram planos.

Os planos são o produto. Cada um é um arquivo Markdown em `plans/`, escrito para um modelo que nunca viu a auditoria: o código atual colado, passos exatos, um comando e o resultado esperado depois de cada passo, uma lista do que fica de fora e condições STOP para quando o código não bate. A skill nunca edita o código-fonte; `/improve execute` entrega um plano a um executor separado em um git worktree e revisa o diff. O repositório tem 12.083 estrelas, licença MIT, 23 commits e nenhuma release marcada; o último commit é de 12 de setembro de 2026.

improve vale a pena?

A ideia por trás do improve é econômica: gastar o modelo forte em julgamento e o barato em digitação. Na nossa leitura da skill, a disciplina que faz isso funcionar está no modelo de plano. Cada passo termina com um comando de verificação e a saída esperada, o plano registra o commit do git contra o qual foi escrito para que o executor confira se houve mudança, e as condições STOP dizem a um modelo pequeno para parar e relatar em vez de improvisar.

A auditoria foi feita para resistir à falha comum da revisão de código por IA, que é o absurdo dito com confiança. Os subagentes relatam demais, diz a skill, então o orientador reabre cada local citado antes de mostrar um achado, descarta falsos positivos, corrige atribuições erradas e registra as rejeições para que não voltem na próxima rodada. O exemplo do README no shadcn/ui mostra os dois lados: um laço O(n²) em uma linha específica fica, um suposto "SSRF" por variável de proxy sai como comportamento esperado.

A profundidade é um controle de custo. `quick` usa no máximo um subagente e traz cerca de 6 achados de alta confiança; o padrão permite até 4 subagentes simultâneos; `deep` permite até 8, um por categoria, em todos os pacotes. Quando `execute` roda, o executor usa Sonnet por padrão, a menos que você indique outro modelo, e um plano tem no máximo 2 rodadas de revisão antes de ser bloqueado.

O porém: não há contagem de tokens nem economia publicadas, então a tese de que a execução barata paga a auditoria cara não está comprovada no repositório. Uma rodada `deep` em uma base de código grande significa várias sessões longas de subagentes no seu modelo mais forte. A opção `--issues` publica os planos como issues do GitHub; a skill verifica a visibilidade e pergunta antes de publicar achados de segurança em um repositório público, mas uma confirmação é uma barreira fraca contra expor ao mundo onde está uma credencial. Não há releases, e nada foi commitado desde setembro.

Nossa opinião: improve rende mais como hábito do que como evento único, um `/improve quick` por mês e um `/improve branch` antes de cada pull request, com os planos lidos por uma pessoa antes que qualquer modelo aja.

Onde ele se destaca

  • Um tech lead que herda um serviço TypeScript de porte médio

    Encontrar, com evidências, as poucas correções que valem ser feitas primeiro

    Rode `/improve` e responda com os achados que quer planejar, por exemplo "plan 1, 3 and 5". Os planos chegam em `plans/` com índice e ordem; a árvore de código fica intocada.

  • Um mantenedor solo de uma biblioteca de código aberto

    Transformar uma auditoria em tarefas que colaboradores possam pegar

    Os planos são Markdown autocontido e podem ir do jeito que estão para um colaborador ou um agente. Publique como issues com `--issues` só depois de ler cada um, porque planos de segurança em repositório público ficam públicos.

  • Uma desenvolvedora com orçamento fixo de modelo

    Usar o modelo caro na revisão e um mais barato nas edições

    `/improve execute 001` dispara um executor Sonnet em um worktree isolado (ou `execute 001 haiku` para um menor), roda de novo as verificações do plano e relata se aprova, pede revisão ou bloqueia. O merge continua manual.

Antes de decidir

Configuração
`npx skills add shadcn/improve` e depois `/improve` (ou `/improve quick` para uma primeira rodada mais barata) dentro do repositório. O repositório também traz um manifesto de plugin para o Claude Code.
Integrações
Qualquer agente que suporte o formato Agent Skills; a distribuição entre subagentes e a execução em worktree foram escritas para o Claude Code. Usa `gh` para `--issues`. Lê ADRs, PRDs, CONTEXT.md e DESIGN.md quando existem, para não apontar decisões já tomadas.
Dados e privacidade
Somente leitura no seu código: as únicas gravações vão para `plans/`, e segredos achados na auditoria são citados por local e tipo, nunca copiados. Seu agente continua enviando código ao provedor do modelo. Licença MIT.
Custo em escala
Não há plano pago. O custo é o uso do modelo: até 4 subagentes simultâneos por padrão e até 8 no `deep`, mais as execuções. Não há números de tokens ou preço publicados.
Limites
Recusa-se a implementar qualquer coisa por conta própria. Worktrees novos não têm `node_modules`, então os executores precisam instalar dependências antes. Sem releases; 23 commits, o último em 12 de setembro de 2026.

O que é bom

  • Cada achado cita arquivo e linha e é conferido de novo antes de aparecer
  • Os planos trazem código colado, comandos de verificação e condições STOP
  • Nunca edita o código; executores trabalham em worktrees descartáveis
  • O custo se ajusta com os níveis quick, standard e deep

O que não é

  • Nenhum número publicado de tokens ou de economia
  • Rodadas deep disparam até 8 subagentes no seu modelo mais forte
  • --issues pode publicar achados em repositórios públicos
  • Sem releases marcadas; último commit em setembro de 2026

Ideal para

Equipes no Claude Code ou em outro agente compatível com skills que querem transformar a revisão de código de um modelo forte em tarefas pequenas e verificáveis, executadas por elas ou por um modelo mais barato.

Alternativas ao improve

improve: perguntas frequentes

improve vale a pena?
improve transforma um modelo caro em um revisor cuidadoso que escreve ordens de serviço em vez de código, que é a divisão certa, embora ninguém tenha publicado quanto essa divisão economiza. Damos nota 3.9 de 5.
Quanto custa improve?
Gratuito e de código aberto (MIT). O uso do modelo é cobrado pelo provedor do seu agente de código.
Quais são as desvantagens de improve?
Nenhum número publicado de tokens ou de economia; rodadas deep disparam até 8 subagentes no seu modelo mais forte; --issues pode publicar achados em repositórios públicos; sem releases marcadas; último commit em setembro de 2026.
Para quem improve é indicado?
Equipes no Claude Code ou em outro agente compatível com skills que querem transformar a revisão de código de um modelo forte em tarefas pequenas e verificáveis, executadas por elas ou por um modelo mais barato.
Quanto custa improve para uma equipe ou em produção?
Não há plano pago. O custo é o uso do modelo: até 4 subagentes simultâneos por padrão e até 8 no `deep`, mais as execuções. Não há números de tokens ou preço publicados.
improve é seguro para dados da empresa?
Somente leitura no seu código: as únicas gravações vão para `plans/`, e segredos achados na auditoria são citados por local e tipo, nunca copiados. Seu agente continua enviando código ao provedor do modelo. Licença MIT.
Quais são as melhores alternativas ao improve?
As alternativas mais próximas que analisamos são Superpowers, BMAD Method e Open Code Review.

Respostas verificadas em 20 de nov. de 2026.