About The Code Audits App
The Code Audits app works in two steps:
- First, it generates a single markdown or text file containing an LLM prompt that describes the repository’s code.
- Based on this file, the app generates audits using LLM services (currently Google Gemini, with plans to add ChatGPT, Claude, and others in the future).
You can view an example audit here.
To see how to use the app in practice, check the How To Use It section.
Credits
The original idea of parsing a codebase into an LLM prompt was inspired by Kamil Stanuch’s app, Codebase Digest. I encourage you to explore this repository for a rich database of prompts you can use on your parsed repository.
I also recommend checking out Kamil’s newsletter (in Polish).
About The Project
This project was built for personal use. When managing multiple engineering teams with dozens of software engineers, I needed a simple way to review their projects—especially those written in technologies I have little or no experience with.
The audits provide a general overview of the feature set, architecture, potential bugs, and ways to improve each project in the future.
You can share your feedback or feature request here.
Phase of Development
Currently, the project is in the prototyping phase, with its tech stack and functionalities being developed incrementally.
I am developing it alone as a side project, so the pace of progress and the roadmap are dictated by my availability, which I split between my full-time job, the Practical Engineering Management newsletter, and this app.
The Purpose of Sharing It With You
In recent years, I have focused on sharing content with engineering leaders through the Practical Engineering Management newsletter. By doing so, I aim to help engineering managers, directors, team leads, and others become more impactful and build high-performing engineering teams.
I want to share the Code Audits app not only as a prototype and later as a working product, but also to reveal the process behind the scenes:
- How to manage such a project
- How to build it using modern tools
- How to navigate phases like PoC, Prototyping, MVP, and future iterations
- How to distinguish between what’s critical, important, and nice-to-have
- How to embrace imperfection when time and other resources are extremely limited
I hope to inspire leaders to be builders and builders to be leaders.
Want to read more? Follow Practical Engineering Management.