Skip to content

About

A Claude Code skill for reviewing a whole codebase one file at a time, with resumable checklist tracking.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

codebase-review

A Claude Code skill for reviewing a whole codebase, one file at a time.

It goes through every production source file once and checks it for quality, stability, architecture, and security. Progress is kept in a checklist file, findings go into notes, and fixes get verified and committed in small batches. Because the checklist is committed, you can stop and pick it up later, or in a new session, without losing your place.

This isn't the same as a normal /code-review, which looks at a branch or PR diff. This one goes through the entire codebase, file by file.

How it works

You pick a mode first:

  • Review and fix (default): review, fix the safe stuff as you go, commit.
  • Review only: write up the findings and a report, don't touch the code.
  • Scoped: just one folder or package instead of everything.

Then it runs a loop:

  • Grab a few related files.
  • Read them and check the four dimensions (pulling in linter, type-checker, and scanner output too).
  • Write down what you find, with a severity on each.
  • Fix the safe issues in place (delete dead code, add guards, that kind of thing) and leave the risky ones as notes.
  • Run the analyzer and the tests. Don't commit if either is red.
  • Tick the boxes, commit, move on.

It's done when every box is checked, the file list still matches what's on disk, and the summary report is written up.

The full thing is in SKILL.md.

Install

The repo is a skill folder, so you can clone it straight where it needs to go.

Just this project:

git clone <repo-url> .claude/skills/codebase-review

Every project on your machine:

git clone <repo-url> ~/.claude/skills/codebase-review

Or copy SKILL.md into .claude/skills/codebase-review/SKILL.md yourself.

Claude Code finds skills under .claude/skills/ on its own. If it doesn't show up, restart the session or run /skills.

Using it

Type /codebase-review, or just ask Claude to review the whole codebase.

To start fresh:

Use the codebase-review skill to review this project's source. Read CLAUDE.md/AGENTS.md first and use its rules as review criteria, confirm the mode and the analyze/test commands, make sure the git tree is clean, then build the checklist and start the first batch.

To pick up where you left off:

Use the codebase-review skill and keep going from the first unchecked box in .claude_review_checklist.md.

Tweaking it

  • It runs whatever your project's analyzer and test runner are; you point it at the exact commands during setup, along with any dependency or secret scanners.
  • Batch size is about 3 files. Change it if you want.
  • It runs one batch at a time. If your setup allows parallel agents, batches can run side by side; the checklist still keeps progress straight.
  • For a monorepo, keep one checklist grouped by package and use each package's own tools.

License

MIT

About

A Claude Code skill for reviewing a whole codebase one file at a time, with resumable checklist tracking.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors