gh-wasabeef-claude-code-cookbook-plugins-en/commands/smart-review.md

Smart Review

A command that analyzes the current situation and automatically suggests the optimal role and approach.

Usage

/smart-review                    # Analyze current directory
/smart-review <file/directory>   # Analyze specific target

Automatic Analysis Logic

Analysis by File Extension

• package.json, *.tsx, *.jsx, *.css, *.scss → frontend
• Dockerfile, docker-compose.yml, *.yaml → architect
• *.test.js, *.spec.ts, test/, __tests__/ → qa
• *.rs, Cargo.toml, performance/ → performance

Security-related File Detection

• auth.js, security.yml, .env, config/auth/ → security
• login.tsx, signup.js, jwt.js → security + frontend
• api/auth/, middleware/auth/ → security + architect

Complex Analysis Patterns

• mobile/ + *.swift, *.kt, react-native/ → mobile
• webpack.config.js, vite.config.js, large-dataset/ → performance
• components/ + responsive.css → frontend + mobile
• api/ + auth/ → security + architect

Error/Problem Analysis

• Stack traces, error.log, crash.log → analyzer
• memory leak, high CPU, slow query → performance + analyzer
• SQL injection, XSS, CSRF → security + analyzer

Suggestion Patterns

Single Role Suggestion

$ /smart-review src/auth/login.js
→ "Authentication file detected"
→ "Analysis with security role recommended"
→ "Execute? [y]es / [n]o / [m]ore options"

Multiple Role Suggestion

$ /smart-review src/mobile/components/
→ "📱🎨 Mobile + Frontend elements detected"
→ "Recommended approaches:"
→ "[1] mobile role alone"
→ "[2] frontend role alone"
→ "[3] multi-role mobile,frontend"
→ "[4] role-debate mobile,frontend"

Suggestions for Problem Analysis

$ /smart-review error.log
→ "⚠️ Error log detected"
→ "Starting root cause analysis with analyzer role"
→ "[Auto-execute] /role analyzer"

$ /smart-review slow-api.log
→ "🐌 Performance issue detected"
→ "Recommended: [1]/role performance [2]/role-debate performance,analyzer"

Suggestions for Complex Design Decisions

$ /smart-review architecture-design.md
→ "🏗️🔒⚡ Architecture + Security + Performance elements detected"
→ "For complex design decisions, debate format recommended"
→ "[Recommended] /role-debate architect,security,performance"
→ "[Alternative] /multi-role architect,security,performance"

Suggestion Logic Details

Priority Assessment

1. Security - Authentication, authorization, and encryption are top priorities
2. Critical Errors - System outages and data loss are urgent
3. Architecture - Large-scale changes and technology selection require careful consideration
4. Performance - Directly impacts user experience
5. Frontend/Mobile - UI/UX improvements
6. QA - Quality assurance and testing

Conditions for Recommending Debate

• When 3 or more roles are involved
• When there's a trade-off between security and performance
• When significant architectural changes are involved
• When both mobile and web are affected

Basic Examples

# Analyze current directory
/smart-review
"Suggest the optimal role and approach"

# Analyze specific file
/smart-review src/auth/login.js
"Suggest the best review method for this file"

# Analyze error log
/smart-review error.log
"Suggest the best approach to resolve this error"

Practical Examples

Project-wide Analysis

$ /smart-review
→ "📊 Analyzing project..."
→ "React + TypeScript project detected"
→ "Authentication functionality + API + mobile support confirmed"
→ ""
→ "💡 Recommended workflow:"
→ "1. Check authentication with security"
→ "2. Evaluate UI/UX with frontend"
→ "3. Confirm mobile optimization with mobile"
→ "4. Review overall design with architect"
→ ""
→ "Auto-execute? [y]es / [s]elect role / [c]ustom"

Specific Problem Analysis

$ /smart-review "How to set JWT expiration time"
→ "🤔 Technical design decision detected"
→ "This issue requires multiple expert perspectives"
→ ""
→ "Recommended approach:"
→ "/role-debate security,performance,frontend"
→ "Reason: Balance between security, performance, and UX is important"

Collaboration with Claude

# Analysis combined with file content
cat src/auth/middleware.js
/smart-review
"Analyze this file from a security perspective"

# Analysis combined with errors
npm run build 2>&1 | tee build-error.log
/smart-review build-error.log
"Suggest ways to resolve build errors"

# Design consultation
/smart-review
"Discuss whether to choose React Native or Progressive Web App"

Notes

• Suggestions are for reference only. The final decision is up to the user
• Debate format (role-debate) is recommended for complex issues
• Single role is often sufficient for simple problems
• Security-related matters should always be confirmed with a specialized role