Clean code that your team and your AI agents can follow
AI coding tools write more code, and messy code makes them worse. I clean up the structure, set conventions that your developers and your agents both follow, and add the rules and checks that keep the codebase tidy while you ship faster.
Signs your codebase needs this
- Pull requests written with AI are hard to review
- Agents repeat the same mistakes or invent code that does not exist
- Nobody agrees where things should live
- Developers are afraid to change old code
What I do
Map and simplify the structure
A clear folder layout and boundaries, so a person or an agent can find where a change belongs.
Written conventions
An AGENTS.md and project rules that tell your team and your agents how code is written here.
Guardrails
Linting, types, and tests that catch mistakes before review, whether a person or an agent wrote the code.
A review checklist for AI code
A short checklist reviewers use on AI-generated pull requests.
Read the checklistRefactor the worst spots
Tidy the few files that cause most of the trouble and leave the rest as they are.
Train the team
Sessions where your developers learn the new rules on your own repo.
See Cursor mentoringPublic work you can read
I publish Cursor rules and a spec-driven toolkit for Cursor in the open: spec-kit-command-cursor. For a focused repair of AI-written code, see fixing AI-generated code.
How it goes
Review
I read the codebase and list what slows people and agents down.
Agree
You pick which fixes are worth doing, and we write the conventions.
Apply
I tidy the worst spots and add the rules and checks.
Hand over
Your team keeps the rules, and I show them how they work.
Questions about clean code and AI
How much does a codebase cleanup cost?+
It depends on the size of the codebase and how much is in bad shape. Projects start from $5,000. After a short scoping call you get a written plan and a quote before any code is changed.
How is this different from Cursor mentoring?+
Cursor mentoring trains your developers on how to work with the tool. This service changes the codebase itself: its structure, its written rules, and its checks.
Do you rewrite our code?+
No. I tidy the parts that cause the most trouble, add rules and checks, and leave the rest alone. You decide how far to go.
We have a specific mess from AI-written code. Can you fix just that?+
Yes. Ask about the focused repair service for AI-generated code, listed under the related links below.
Send me your repo
Tell me what the codebase is and where it hurts. I reply within 24 hours with questions or a plain answer on what I would clean up first.
Related: Cursor mentoring, Fix AI-generated code, React app improvement.
Dalam Bahasa Indonesia: lihat halaman Bahasa Indonesia.