Gilfoyle Tech Reviewer

"Your code is bad and you should feel bad... but I'll explain exactly why."

A comprehensive technical review agent inspired by Bertrand Gilfoyle from Silicon Valley. This Claude Code agent provides multi-perspective technical analysis with characteristic precision and wit.

🎯 What This Agent Does

The Gilfoyle Tech Reviewer agent provides thorough technical analysis across multiple domains:

• Code Quality Review: Structure, readability, maintainability, and adherence to best practices
• Security Analysis: Threat modeling, vulnerability assessment, and security best practices
• Architecture Review: System design, scalability, and technical debt assessment
• Code Simplification: Eliminating unnecessary complexity and over-engineering
• UX Analysis: User experience patterns, accessibility, and usability evaluation
• Tech Lead Perspective: Business alignment, team productivity, and technical standards

🚀 How to Use

Installation

1. Copy the gilfoyle-tech-reviewer.md file to your Claude Code agents directory:

   cp gilfoyle-tech-reviewer.md ~/.claude/agents/

2. The agent will be automatically available in Claude Code

Usage Examples

Code Review:

I just finished implementing JWT authentication with refresh tokens. Can you review this?

Complexity Analysis:

This endpoint feels overly complex. Can someone help simplify it?

Security Assessment:

Please review the security implications of this user input handling code.

Architecture Review:

I need feedback on the overall architecture of this microservice.

🔧 What You Get

Comprehensive Analysis

• Multiple technical perspectives on the same code
• Prioritized findings by severity and impact
• Specific, actionable recommendations with examples

Gilfoyle's Signature Style

• Direct, honest feedback with subtle sarcasm
• Methodical precision in technical analysis
• Professional standards with distinctive personality

Quality Assurance

• Rationale for all recommendations
• Testing strategies and validation approaches
• Both immediate fixes and long-term improvements

📋 Review Capabilities

Code Review

• Code structure and organization
• Performance bottlenecks and optimizations
• Error handling and edge cases
• SOLID principles and clean code practices
• Broader architectural implications

Security Review

• Threat modeling and vulnerability assessment
• Common security flaws (injection, auth bypass, data exposure)
• Input validation and sanitization
• Access controls and authorization
• Cryptographic implementations

UX Review

• User workflow analysis
• Friction points and usability issues
• Accessibility compliance
• Performance impact on user experience
• Error states and edge case handling

🎭 The Gilfoyle Experience

This agent embodies Bertrand Gilfoyle's approach to technical excellence:

• Brutally Honest: No sugar-coating, just facts
• Methodically Precise: Every detail matters
• Comprehensively Thorough: Multiple angles on every issue
• Elegantly Sardonic: Technical feedback with personality

🤝 Contributing

Found a bug in someone's code? The agent will too.

For issues with the agent itself:

1. Fork the repository
2. Make your improvements
3. Submit a pull request
4. Prepare for thorough review (obviously)

📜 License

MIT License - Because even Gilfoyle believes in open source.

⚠️ Disclaimer

This agent provides technical review and analysis. While inspired by a fictional character, all technical advice is based on industry best practices and real-world experience. The sarcasm is just for fun.

---

"I don't want to live in a world where someone else is making the world a better place better than we are." - Bertram Gilfoyle