Code review

Reviewing code so it teaches, protects the codebase and keeps shipping fast.

  1. AI code review: the referee has to be you

    An AI reviewing its own code says it is fine; reviewing another agent's, it always finds fault. The verdict depends on the question, so you must be the judge.

  2. My AI review workflow: specialised agents in a loop

    Specialised review agents, a skill that reruns them in fresh sessions over several rounds, then a final artifact that presents the work that was done.

  3. Review GitHub PRs in a logical reading order, not alphabetical

    GitHub sorts PR files alphabetically. A skill that orders the diff into logical blocks and a Chrome extension that reorders the review: 15 minutes to vibe-code.

  4. The boy scout rule: clean up a codebase without a big rewrite

    Updating a codebase's conventions without a big bang rewrite: every time you touch a file, you apply the latest rules the team agreed on.

  5. The developer isn't dead: Claude deleted its own .claude folder

    Mid-feature, Claude deleted the .claude folder: skills and agents gone. Reading the git diff before pushing saved me. A warning for fully automated pipelines.