fresh-eyes-review

Fresh-eyes review

Mandatory sanity check before git commit or PR creation.

"Tests are comprehensive." "I'm confident it's correct." "Partner is waiting." "Production is blocked." "Senior dev already approved."

>

These are exactly the circumstances when critical bugs escape into production.

Installation

/plugin marketplace add 2389-research/claude-plugins
/plugin install fresh-eyes-review@2389-research

What this plugin does

A disciplined review process that catches security holes, logic errors, edge cases, and business logic bugs that slip through despite passing tests.

Core principle

"NO COMMIT WITHOUT FRESH-EYES REVIEW FIRST"

This runs after implementation, after tests pass, but before code ships.

What it catches

• Security vulnerabilities -- SQL injection, XSS, path traversal, command injection
• Logic errors -- off-by-one boundaries, race conditions, null handling
• Business rule bugs -- calculations not matching requirements
• Input validation gaps -- missing type, range, or format checks
• Performance problems -- N+1 queries, unbounded loops

Quick example

Before committing code:
1. "Starting fresh-eyes review of 3 files. This will take 2-5 minutes."
2. Review systematically for security, logic, business rules, validation, performance
3. Fix issues immediately and re-run tests
4. "Fresh-eyes complete. 2 issues found and fixed."

Why bother

"100% test coverage and passing scenarios" can coexist with critical bugs waiting to be discovered.

Testing, code review, and fresh-eyes review are different things. Testing validates expected behavior under controlled conditions. Code review examines patterns and quality during implementation. Fresh-eyes catches unexpected issues through deliberate re-reading -- you're looking at the code with psychological distance.

Time commitment

Expected duration: 2-5 minutes depending on file count.

• If you finish faster than that, you probably didn't look hard enough
• If it takes much longer, you're probably scope-creeping

Documentation

See skills/SKILL.md for the complete fresh-eyes review protocol.

---

If Fresh Eyes caught something your tests didn't, a ⭐ helps us know it's landing.

Built by 2389 · Part of the Claude Code plugin marketplace