code-review-assistant

name	code-review-assistant
description	Comprehensive PR review using multi-agent swarm with specialized reviewers for security, performance, style, tests, and documentation. Provides detailed feedback with auto-fix suggestions and merge readiness assessment. Use when this capability is needed.
metadata	{"author":"dnyoussef"}

Code Review Assistant

Purpose

Automated comprehensive code review using specialized multi-agent swarm for PRs.

Specialist Agent

I am a code review coordinator managing specialized review agents.

Methodology (Multi-Agent Swarm Review Pattern):

1. Initialize review swarm with specialized agents
2. Parallel comprehensive review (security, performance, style, tests, docs)
3. Run complete quality audit pipeline
4. Aggregate findings with severity ranking
5. Generate fix suggestions with Codex
6. Assess merge readiness with quality gates
7. Create detailed review comment

Review Agents (5 specialists):

• Security Reviewer: Vulnerabilities, unsafe patterns, secrets
• Performance Analyst: Bottlenecks, optimization opportunities
• Style Reviewer: Code style, best practices, maintainability
• Test Specialist: Test coverage, quality, edge cases
• Documentation Reviewer: Comments, API docs, README updates

Input Contract

input:
  pr_number: number (required) or
  changed_files: array[string] (file paths)
  focus_areas: array[enum] (default: all)
    - security
    - performance
    - style
    - tests
    - documentation
  suggest_fixes: boolean (default: true)
  auto_merge_if_passing: boolean (default: false)

Output Contract

output:
  review_summary:
    overall_score: number (0-100)
    merge_ready: boolean
    blocking_issues: number
    warnings: number
    suggestions: number
  detailed_reviews:
    security: object
    performance: object
    style: object
    tests: object
    documentation: object
  fix_suggestions: array[code_change]
  merge_decision: enum[approve, request_changes, needs_work]

Execution Flow

#!/bin/bash
set -e

PR_NUMBER="$1"
FOCUS_AREAS="${2:-security,performance,style,tests,documentation}"
SUGGEST_FIXES="${3:-true}"

REVIEW_DIR="pr-review-$PR_NUMBER"
mkdir -p "$REVIEW_DIR"

echo "================================================================"
echo "Code Review Assistant: PR #$PR_NUMBER"
echo "================================================================"

# PHASE 1: PR Information Gathering
echo "[1/8] Gathering PR information..."
gh pr view "$PR_NUMBER" --json title,body,files,additions,deletions > "$REVIEW_DIR/pr-info.json"

PR_TITLE=$(cat "$REVIEW_DIR/pr-info.json" | jq -r '.title')
CHANGED_FILES=$(cat "$REVIEW_DIR/pr-info.json" | jq -r '.files[].path' | tr '\n' ' ')

echo "PR: $PR_TITLE"
echo "Files changed: $(echo $CHANGED_FILES | wc -w)"

# Checkout PR branch
gh pr checkout "$PR_NUMBER"


 
npx claude-flow coordination swarm-init \
  --topology mesh \
  --max-agents 5 \
  --strategy specialized


npx claude-flow automation auto-agent \
  --task  \
  --strategy optimal \
  --max-agents 5


 


 [[  == ** ]]; 
   
  npx claude-flow security-scan . \
    --deep  \
    --check-secrets  \
    --output  &
  SEC_PID=$!



 [[  == ** ]]; 
   
  npx claude-flow analysis bottleneck-detect \
    --threshold 10 \
    --output  &
  PERF_PID=$!



 [[  == ** ]]; 
   
  npx claude-flow style-audit . \
    --fix  \
    --output  &
  STYLE_PID=$!



 [[  == ** ]]; 
   
  npx claude-flow test-coverage . \
    --detailed  \
    --output  &
  TEST_PID=$!



 [[  == ** ]]; 
   
  
  npx claude-flow docs-checker . \
    --output  &
  DOCS_PID=$!



      2>/dev/null || 


 
npx claude-flow audit-pipeline . \
  --phase all \
  --model codex-auto \
  --output 


 
 >  <<


SECURITY_SCORE=$(  2>/dev/null | jq )
PERF_SCORE=$(  2>/dev/null | jq )
STYLE_SCORE=$(  2>/dev/null | jq )
TEST_SCORE=$(  2>/dev/null | jq )
QUALITY_SCORE=$(  | jq )

OVERALL_SCORE=$(  | bc)


 [  =  ]; 
   

  
  ISSUES=$(  | jq )

   [  -gt 0 ]; 
    codex --reasoning-mode  \
      --context  \
      --output 
  



 

CRITICAL_SECURITY=$(  2>/dev/null | jq )
TESTS_PASSING=$(  | jq )

MERGE_READY=
MERGE_DECISION=

 [  -eq 0 ] && [  =  ] && [  -ge 80 ]; 
  MERGE_READY=
   [  -ge 90 ]; 
    MERGE_DECISION=
  
    MERGE_DECISION=
  



 

 >  <<


gh  comment  --body-file 


 [  =  ]; 
  gh  review  --approve --body 
 [  =  ]; 
  gh  review  --approve --body 

  gh  review  --request-changes --body 


 
 
 
 
 
 
 
 
 
 
 
 

Integration Points

Cascades

• Part of /github-automation-workflow cascade
• Used by /pr-quality-gate cascade
• Invoked by /review-pr command

Commands

• Uses: /swarm-init, /auto-agent, /security-scan
• Uses: /bottleneck-detect, /style-audit, /test-coverage
• Uses: /audit-pipeline, /codex-reasoning
• Uses GitHub CLI: gh pr view, gh pr checkout, gh pr comment, gh pr review

Other Skills

• Invokes: quick-quality-check, smart-bug-fix (if issues)
• Output to: merge-decision-maker, pr-enhancer

Usage Example

# Review PR with all checks
code-review-assistant 123

# Review focusing on security
code-review-assistant 123 security

# Review with auto-merge
code-review-assistant 123 "security,tests" true --auto-merge true

Failure Modes

• PR not found: Verify PR number and repository access
• Critical security issues: Block merge, escalate to security team
• Tests failing: Request changes, provide fix suggestions
• GitHub CLI not authenticated: Guide user to authenticate

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.