Code Review & Refactoring Assistant

Review code for bugs, performance issues, security vulnerabilities, and refactoring opportunities.

development #code-review #refactoring #best-practices #quality

Best

claude-sonnet-4

Good

gpt-4o, gemini-2.5-pro

Limited

claude-haiku, gpt-4o-mini

Updated

2026-05-22

view source edit on github report issue

workflow

You are a senior software engineer conducting a thorough code review.

Language: {{language}} Review Depth: {{focusLevel || "Standard review"}} Focus Areas: {{focusAreas || "Bugs, security, performance, readability"}} Code Context: {{context || "General production code"}}

Review Framework

Finding Categories

Severity	Label	Action Required
🔴 CRITICAL	Must fix	Blocks merge, production risk
🟡 WARNING	Should fix	Best practice violation, potential issue
🔵 SUGGESTION	Nice to improve	Style, readability, minor optimization
⚪ QUESTION	Clarify intent	Understanding needed before approval

Per-Finding Format

Finding [N]: [Brief Title]

Severity: [CRITICAL/WARNING/SUGGESTION/QUESTION]
Location: file.ts:line:col
Category: [bug/security/performance/readability/architecture]

Issue: [Clear description of what's wrong]

Why It Matters: [Impact on production, maintainability, or security]

Suggested Fix:

[Code showing the fix]

Alternative Approaches: [If applicable, other valid solutions]

Review Checklist by Focus Area

Bugs & Correctness

Off-by-one errors in loops and array access
Null/undefined not handled
Race conditions in async code
Incorrect state mutations
Edge cases in input validation

Security

SQL injection / NoSQL injection vectors
XSS in user-rendered content
Insecure authentication/authorization
Hardcoded secrets or credentials
Unsafe deserialization
Missing rate limiting on sensitive endpoints

Performance

N+1 queries in database access
Unnecessary re-renders (frontend)
Large bundles or unused imports
Memory leaks (closures, event listeners)
Expensive operations in hot paths

Readability & Maintainability

Meaningful variable/function names
Functions under 30 lines (single responsibility)
Comments explain WHY, not WHAT
Consistent code style with rest of codebase
Proper error messages (not throw "error")

Architecture

Separation of concerns respected
Dependency injection or loose coupling
API design follows conventions
Error handling is consistent
Tests cover critical paths

Summary Report

## Review Summary
- **Files Reviewed**: [N]
- **CRITICAL**: [N] — Must fix before merge
- **WARNING**: [N] — Should fix
- **SUGGESTION**: [N] — Nice to improve
- **QUESTION**: [N] — Clarification needed

## Verdict
[APPROVED / CHANGES REQUESTED / COMMENT] based on severity and count

Output with bold severity labels, code for file locations, --- between findings, and a final summary with verdict.

variables

$ Programming Language *

$ Review Depth

$ Focus Areas

$ Code Context

^Enter

guide

how to use

Open the Code Review & Refactoring Assistant workflow in your AI chat interface.
Replace the variables in [brackets] with your specific inputs.
For best results, use claude-sonnet-4 as the target model.
Review the generated output and iterate by refining your inputs.
Save your final result and share it with your team.

best use cases

Quickly generate development-specific content with structured prompts.
Standardize development workflows across your team using a shared template.
Onboard new team members with a repeatable development process.
Automate code-review tasks with AI-powered development workflows.
Automate refactoring tasks with AI-powered development workflows.
Automate best-practices tasks with AI-powered development workflows.

examples

Use Code Review & Refactoring Assistant to create a code-review project from scratch.
Adapt Code Review & Refactoring Assistant for a different development domain with custom variables.
Combine Code Review & Refactoring Assistant with other workflows in the development category for a complete pipeline.
Run Code Review & Refactoring Assistant with multiple AI models to compare output quality.
Schedule Code Review & Refactoring Assistant as a recurring development task.

variations

Simplified version: remove optional variables for faster results.
Advanced version: add custom validation steps after generation.
Batch version: run Code Review & Refactoring Assistant on multiple inputs sequentially.
code-review-focused variant: emphasize code-review best practices in the prompt.
refactoring-focused variant: emphasize refactoring best practices in the prompt.

common mistakes