AI Pre-Commit Review Workflow

A 60-second review pass with an AI agent before every commit. Catches the dumb stuff before it leaks.

The cost of a bad commit (revert, force-push, embarrassed Slack message) is way higher than a 60-second pre-commit check. Most people skip it. AI makes it actually fast.

Who this is for

Anyone who commits 5+ times a day. Solo devs especially — no second pair of eyes downstream.

When to reach for it

Before every commit on a branch that other people will see. Especially when tired, late at night, or rushing.

When this is NOT the right tool

Drive-by typo commits, work-in-progress branches no one else watches. Save the cost for branches that matter.

Step by step

  1. Set up the prompt as a slash command in Claude Code or a saved snippet in Cursor. Make it one keystroke.
  2. Run “git diff —staged” mentally or via the agent. The agent should see exactly what you are about to commit.
  3. Prompt: “Review this staged diff. Flag: leftover console.log / debugger / TODO, missing null checks, accidentally committed secrets, off-by-one risks, and any line you would NOT ship to production.”
  4. Read the flags. Most are noise; one or two are usually real.
  5. Fix real ones in-place. Restage. Re-run if anything new staged.
  6. Commit.

Friday evening commit before logging off: /review → flagged a debugger statement and a .env accidentally staged → fixed both → committed → went home without weekend disaster. If the commit is about to ship to Firebase Hosting, run an AI Firebase deploy checks pass right after to catch rewrite-order and region issues before they hit production.

Common mistakes

  • Letting the AI commit for you. Always do the commit yourself with intent.
  • Accepting every flag. Most are stylistic noise. Use judgment.
  • Running the review on unstaged changes. The agent gets confused about what is being committed.
  • Skipping when tired — that’s exactly when you most need it.

Advanced tips

  • Tailor the flag list to your stack. “leftover dbg!()” for Rust, “any” types for TypeScript.
  • Add a “what NOT to flag” line: “Do not flag style preferences or naming bikeshedding.”
  • Pair with a pre-commit hook (lefthook, husky) that auto-runs the prompt — true automation.

Copy-ready prompt

Review the following staged git diff. Flag ONLY:
- Forgotten debug code (console.log, debugger, dbg!, print statements not behind a flag)
- Hardcoded secrets, API keys, or credentials
- Obvious null / undefined / type errors
- Off-by-one or boundary mistakes
- Files that should not be committed (.env, .DS_Store, build artifacts)
Do NOT flag style, naming, or refactor ideas.

Diff:

{paste diff}

FAQ

  • Slows me down?: 60 seconds. The first time it catches a real issue, ROI proven for the year.
  • Replace code review?: No — it’s a pre-filter for your own commits. Real review still happens at PR time.

Tags: #AI coding #Tutorial #Workflow