fresh-eyes

• After completing a feature or fix
• Before committing changes
• When you feel like something might be off
• After a long coding session

1. Identify Changed Code

Find all files you modified in this session. If unclear, ask the user or check recent git changes:

```bash

git diff --name-only HEAD~1

git diff --name-only --cached

```

2. Re-read with Fresh Eyes

Read each modified file completely. Pretend you've never seen this code before. Look for:

Logic errors

• Off-by-one errors
• Inverted conditions
• Missing null/undefined checks
• Race conditions
• Incorrect comparisons (== vs ===, > vs >=)

Obvious bugs

• Typos in variable names
• Copy-paste errors
• Forgotten return statements
• Unused variables that should be used
• Wrong function called

Missing pieces

• Error handling gaps
• Edge cases not covered
• Cleanup code missing (close connections, clear timeouts)
• Validation missing at boundaries

Confusion risks

• Misleading variable names
• Complex logic without comments
• Inconsistent patterns within the file
• Magic numbers without explanation

3. Fix Issues

For each issue found:

1. Explain what's wrong in 1 sentence
2. Fix it immediately
3. Move to the next issue

Don't ask for permission. Just fix obvious problems.

4. Report Summary

After fixing, provide a brief summary:

```

Fixed 3 issues:

• api/users.ts:47 — Missing null check on user.profile
• api/users.ts:82 — Off-by-one in pagination (used > instead of >=)
• utils/format.ts:15 — Typo: formattedDte → formattedDate

No other issues found.

```

If nothing found:

```

Reviewed 4 files. No issues found.

```

• Don't refactor working code
• Don't add features
• Don't change style preferences
• Don't optimize prematurely
• Don't add comments to obvious code
• Don't reorganize file structure

Focus only on bugs, errors, and problems. If it works and isn't broken, leave it alone.

Run through mentally for each file:

• [ ] All variables initialized before use?
• [ ] All functions return what they should?
• [ ] All loops terminate correctly?
• [ ] All conditions handle both branches?
• [ ] All async operations awaited?
• [ ] All errors caught or propagated?
• [ ] All resources cleaned up?
• [ ] All edge cases handled (empty, null, zero, negative)?