Skip to main content

Overview

Blocks can automatically review pull requests, providing detailed feedback on code quality, potential bugs, security issues, and adherence to best practices. This helps maintain code quality and reduces the manual review burden on your team.

How It Works

When you mention @blocks in a GitHub pull request comment or review, Blocks will:
  1. Analyze the Changes: Review all modified files, additions, and deletions
  2. Check for Issues: Identify potential bugs, security vulnerabilities, and code smells
  3. Verify Best Practices: Ensure code follows your team’s conventions and industry standards
  4. Provide Feedback: Comment directly on specific lines with actionable suggestions
  5. Summarize Findings: Provide an overall assessment of the PR

Using PR Review

Basic Review

Request a general review of your pull request:
@blocks review this PR

Focused Review

Ask Blocks to focus on specific aspects:
@blocks review this PR for security vulnerabilities
@blocks check this PR for performance issues
@blocks review the test coverage in this PR

Address Review Comments

Have Blocks automatically address review feedback:
@blocks address the review comments and update the PR

What Blocks Checks

  • Code Quality: Readability, maintainability, and adherence to conventions
  • Security: Common vulnerabilities and security anti-patterns
  • Performance: Potential bottlenecks and inefficient code
  • Testing: Test coverage and quality of tests
  • Documentation: Missing or outdated documentation
  • Dependencies: New or updated dependencies and potential conflicts

Best Practices

  • Early Reviews: Request reviews early in development to catch issues sooner
  • Specific Requests: Ask for focused reviews when you’re concerned about particular areas
  • Follow Up: Use Blocks to address review comments and create updated PRs
  • Combine with Human Review: Use Blocks as a first pass, followed by human review for complex logic

Integration Setup

PR Review works seamlessly with the GitHub integration. Make sure Blocks is installed in your repository and has access to pull requests.

Learn More