Skip to content

Instantly share code, notes, and snippets.

@bruceg
Last active January 6, 2026 12:43
Show Gist options
  • Select an option

  • Save bruceg/e67fe1756efeb8adff901c8f79f9384b to your computer and use it in GitHub Desktop.

Select an option

Save bruceg/e67fe1756efeb8adff901c8f79f9384b to your computer and use it in GitHub Desktop.
Branch review command for AI agents

Git Branch Code Review

Overview

Perform a thorough code review that verifies functionality, maintainability, and security. Focus on architecture, readability, performance implications, and provide actionable suggestions for improvement.

Steps

  1. Understand the change
    • Read the commit description of all commits on this git branch
    • Examine only the code changed by the commits on this git branch along with any uncommitted changes
    • Identify the scope of files and features impacted
    • Clarify any assumptions or questions by asking the author
  2. Validate functionality
    • Confirm the code delivers the intended behavior
    • Exercise edge cases or guard conditions mentally or by running locally
    • Check error handling paths and logging for clarity
  3. Assess quality
    • Ensure functions are focused, names are descriptive, and code is readable
    • Watch for duplication, dead code, or missing tests
    • Verify documentation and comments reflect the latest changes
  4. Review security and risk
    • Look for injection points, insecure defaults, or missing validation
    • Confirm secrets or credentials are not exposed
    • Evaluate performance or scalability impacts of the change

Review Checklist

Functionality

  • Intended behavior works and matches requirements
  • Edge cases handled gracefully
  • Error handling is appropriate and informative

Code Quality

  • Code structure is clear and maintainable
  • No unnecessary duplication or dead code
  • All additional or modified code is covered by tests
  • Documentation is updated to reflect changes

Security & Safety

  • No obvious security vulnerabilities introduced
  • Inputs validated and outputs sanitized
  • Sensitive data handled correctly

Additional Review Notes

  • Architecture and design decisions considered
  • Performance bottlenecks or regressions assessed
  • Coding standards and best practices followed
  • Resource management, error handling, and logging reviewed
  • Suggested alternatives, additional test cases, or documentation updates captured

Provide constructive feedback with concrete examples and actionable guidance for the author.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment