Get the FREE Ultimate OpenClaw Setup Guide →

multi-reviewer-patterns

npx machina-cli add skill wshobson/agents/multi-reviewer-patterns --openclaw
Files (1)
SKILL.md
5.1 KB

Multi-Reviewer Patterns

Patterns for coordinating parallel code reviews across multiple quality dimensions, deduplicating findings, calibrating severity, and producing consolidated reports.

When to Use This Skill

  • Organizing a multi-dimensional code review
  • Deciding which review dimensions to assign
  • Deduplicating findings from multiple reviewers
  • Calibrating severity ratings consistently
  • Producing a consolidated review report

Review Dimension Allocation

Available Dimensions

DimensionFocusWhen to Include
SecurityVulnerabilities, auth, input validationAlways for code handling user input or auth
PerformanceQuery efficiency, memory, cachingWhen changing data access or hot paths
ArchitectureSOLID, coupling, patternsFor structural changes or new modules
TestingCoverage, quality, edge casesWhen adding new functionality
AccessibilityWCAG, ARIA, keyboard navFor UI/frontend changes

Recommended Combinations

ScenarioDimensions
API endpoint changesSecurity, Performance, Architecture
Frontend componentArchitecture, Testing, Accessibility
Database migrationPerformance, Architecture
Authentication changesSecurity, Testing
Full feature reviewSecurity, Performance, Architecture, Testing

Finding Deduplication

When multiple reviewers report issues at the same location:

Merge Rules

  1. Same file:line, same issue — Merge into one finding, credit all reviewers
  2. Same file:line, different issues — Keep as separate findings
  3. Same issue, different locations — Keep separate but cross-reference
  4. Conflicting severity — Use the higher severity rating
  5. Conflicting recommendations — Include both with reviewer attribution

Deduplication Process

For each finding in all reviewer reports:
  1. Check if another finding references the same file:line
  2. If yes, check if they describe the same issue
  3. If same issue: merge, keeping the more detailed description
  4. If different issue: keep both, tag as "co-located"
  5. Use highest severity among merged findings

Severity Calibration

Severity Criteria

SeverityImpactLikelihoodExamples
CriticalData loss, security breach, complete failureCertain or very likelySQL injection, auth bypass, data corruption
HighSignificant functionality impact, degradationLikelyMemory leak, missing validation, broken flow
MediumPartial impact, workaround existsPossibleN+1 query, missing edge case, unclear error
LowMinimal impact, cosmeticUnlikelyStyle issue, minor optimization, naming

Calibration Rules

  • Security vulnerabilities exploitable by external users: always Critical or High
  • Performance issues in hot paths: at least Medium
  • Missing tests for critical paths: at least Medium
  • Accessibility violations for core functionality: at least Medium
  • Code style issues with no functional impact: Low

Consolidated Report Template

## Code Review Report

**Target**: {files/PR/directory}
**Reviewers**: {dimension-1}, {dimension-2}, {dimension-3}
**Date**: {date}
**Files Reviewed**: {count}

### Critical Findings ({count})

#### [CR-001] {Title}

**Location**: `{file}:{line}`
**Dimension**: {Security/Performance/etc.}
**Description**: {what was found}
**Impact**: {what could happen}
**Fix**: {recommended remediation}

### High Findings ({count})

...

### Medium Findings ({count})

...

### Low Findings ({count})

...

### Summary

| Dimension    | Critical | High  | Medium | Low   | Total  |
| ------------ | -------- | ----- | ------ | ----- | ------ |
| Security     | 1        | 2     | 3      | 0     | 6      |
| Performance  | 0        | 1     | 4      | 2     | 7      |
| Architecture | 0        | 0     | 2      | 3     | 5      |
| **Total**    | **1**    | **3** | **9**  | **5** | **18** |

### Recommendation

{Overall assessment and prioritized action items}

Source

git clone https://github.com/wshobson/agents/blob/main/plugins/agent-teams/skills/multi-reviewer-patterns/SKILL.mdView on GitHub

Overview

Coordinates parallel code reviews across multiple quality dimensions, including Security, Performance, Architecture, Testing, and Accessibility. Deduplicates findings, calibrates severity consistently, and produces consolidated reports to streamline multi-review workflows.

How This Skill Works

Define the review dimensions needed for the change and assign findings from each reviewer to those dimensions. Apply deduplication rules to merge or retain findings, then calibrate severity using the provided criteria and consolidate all results into a single report with reviewer attribution.

When to Use It

  • Organizing a multi-dimensional code review
  • Deciding which review dimensions to assign
  • Deduplicating findings from multiple reviewers
  • Calibrating severity ratings consistently
  • Producing a consolidated review report

Quick Start

  1. Step 1: Identify the change and select the relevant review dimensions
  2. Step 2: Collect findings from all reviewers, run deduplication, and cross-reference co-located items
  3. Step 3: Calibrate severity, finalize scores, and generate the consolidated report with attribution

Best Practices

  • Define the exact set of review dimensions for the change and align on expectations
  • Use the recommended dimension combinations for common scenarios (e.g., API changes map to Security, Performance, Architecture)
  • Run deduplication with the merge rules to avoid duplicate findings
  • Apply severity calibration using the Severity Criteria and use the highest rating for merged findings
  • Attribute reviewers in the final report and cross-reference co-located findings

Example Use Cases

  • API endpoint changes reviewed for Security, Performance, and Architecture
  • Frontend component reviewed for Architecture, Testing, and Accessibility
  • Database migration reviewed for Performance and Architecture
  • Authentication changes reviewed for Security and Testing
  • Full feature review spanning Security, Performance, Architecture, and Testing

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers