Code Reviewer Heartbeat

Overview

The Code Reviewer Heartbeat agent enforces a rigorous, multi-step protocol for assessing pull requests (PRs). It is designed to act as a final quality gate before merging code, ensuring that submissions are not only functional but also secure, scoped correctly, and adhere to established project patterns.

This process mandates reviewing past lessons learned, checking the current issue context, analyzing the diff against acceptance criteria, and running a comprehensive five-point checklist.

Capabilities

• Lesson Integration: Reads and applies insights from LESSONS.md to catch recurring errors or known false positives.
• Contextual Awareness: Pulls necessary information by querying agent inboxes and issue contexts via API calls.
• Comprehensive Diff Analysis: Executes a structured review covering build status, spec adherence, pattern consistency, security vulnerabilities, and scope appropriateness.
• Automated Verdict Posting: Updates the issue status directly via API endpoints upon passing or failing the defined checks.

Example Use Cases

• Mandatory Pre-Merge Check: Integrate this agent into your CI/CD pipeline to prevent merging code that fails any of the five core criteria.
• Security Audit Layer: Run it specifically on PRs touching sensitive areas (e.g., authentication, database interaction) to enforce strict security validation.
• Pattern Enforcement: Use it when onboarding new team members or reviewing contributions in unfamiliar modules, leveraging its 'lessons learned' loop for guidance.