# Improve

By **shadcn** · Habilidades

Uma habilidade de agente que audita qualquer codebase com seu modelo mais capaz e escreve planos de implementação autocontidos para modelos mais baratos (ou humanos) executarem.

- Source: https://github.com/shadcn/improve
- Repository: https://github.com/shadcn/improve
- Install: `npx skills add shadcn/improve`
- Tags: agent, open-source, cli, code-review, planning, multi-agent, mit-license, agentic
- Pricing: free
- Upvotes: 0

## Features

- Audita um codebase e escreve planos executáveis sem tocar no código-fonte
- Subagentes paralelos em nove categorias com evidência de arquivo:linha
- Passagem de autoverificação relê os locais citados para eliminar falsos positivos
- Tabela de achados ordenada por alavancagem para você escolher
- Planos autocontidos com verificações de validação e condições de STOP
- execute despacha um modelo mais barato em uma worktree isolada e o revisa
- Publicação opcional de planos como issues do GitHub

---

Improve é uma Agent Skill (instale com `npx skills add shadcn/improve`) que audita qualquer codebase e escreve planos de implementação para outros agentes executarem, nunca escrevendo código-fonte por conta própria. A ideia é usar seu modelo mais capaz onde a inteligência se multiplica: mapeando o repositório, julgando o que vale a pena fazer e escrevendo a especificação. O plano é o produto.

Uma execução mapeia o repositório e seus comandos exatos de build, teste e lint, depois distribui subagentes paralelos em nove categorias, correção, segurança, desempenho, cobertura de testes, débito técnico, dependências, DX, documentação e direção, cada achado carregando evidência de arquivo:linha, impacto, esforço e confiança. Em seguida, relê cada local citado para eliminar falsos positivos antes de exibir uma tabela ordenada por alavancagem. Os achados selecionados tornam-se planos markdown autocontidos escritos para o executor mais simples possível: contexto inline, verificações checáveis por máquina e condições de STOP explícitas. `improve execute` despacha um executor mais barato em uma worktree isolada e revisa o diff como um tech lead, enquanto `reconcile` mantém o backlog honesto ao longo do tempo. Funciona em qualquer agente que suporte o formato Agent Skills e pode publicar planos como issues do GitHub.

## FAQ

### Como o Improve é diferente de um agente de codificação?

Ele deliberadamente nunca implementa nada. Usa um modelo caro para entender o repositório e escrever planos rigorosos, depois passa a execução para modelos mais baratos ou humanos, mantendo a decisão de merge com você.

### O que compõe um plano?

Cada plano é autocontido: caminhos exatos de arquivos, trechos do código no estado atual, os próprios comandos de teste e lint do repositório como verificações de validação, uma lista do que está fora de escopo e condições de STOP para quando a realidade não corresponde ao plano.

### Quais agentes podem executá-lo?

Qualquer agente que suporte o formato Agent Skills. Instale com npx skills add shadcn/improve.

---
[View on Analog](https://analoghq.ai/pt-br/shadcn/skills/improve)