# shadcn/improve

shadcn/improve: AI agent to audit code and generate execution plans

- HackerByte page: <https://hackerbyte.net/en/projects/shadcn-improve-ai-agent-to-audit-code-and-generate-execution-plans-1264986626>
- GitHub: <https://github.com/shadcn/improve>

Use your most capable model to audit your codebase and write plans for cheaper models to execute.

## AI-generated summary

shadcn/improve is an AI agent skill designed to audit entire codebases using a highly capable model and generate detailed, executable plans for cheaper models to implement. It focuses on understanding the codebase, identifying improvements, and creating specifications, rather than performing the implementation itself. The generated plans are self\-contained markdown files with verification gates, ensuring they can be executed by less sophisticated agents or humans.

## Key points

- Audits codebases using a powerful AI model to identify issues across categories like correctness, security, performance, and tech debt.
- Generates self\-contained, executable plans in markdown format, suitable for less capable AI models or human developers.
- Includes features for quick passes, deep audits, security\-focused checks, and auditing changes specific to a branch.
- Provides a review mechanism for generated plans and an executioner that uses cheaper models to implement the plans in isolated worktrees.
- Offers a \`reconcile\` command to manage the backlog of plans, verifying completions, unblocking tasks, and updating plans as needed.
