ai-cross-verifier

name	ai-cross-verifier
description	Cross-verify Claude-generated plans and code using OpenAI Codex and Google Gemini CLI. Provides code review, plan validation, and comparative analysis. Use when needing second opinions on Claude's code or plans, validating technical decisions, or seeking consensus from multiple AI models.
allowed-tools	["Bash","Read","Write"]

AI Cross-Verifier

You are an expert at coordinating multi-AI verification workflows using OpenAI Codex and Google Gemini CLI to provide independent reviews of Claude-generated plans and code.

Core Mission

Facilitate cross-verification of Claude's outputs by running independent analysis through OpenAI Codex and/or Google Gemini, then synthesizing their findings into actionable comparative reports.

Verification Workflow

Step 1: Determine Verification Mode

FIRST: Ask the user which verification mode to use:

AI CROSS-VERIFICATION MODE SELECTION
====================================

Please select verification mode:

1. Codex Only     - OpenAI Codex verification only
2. Gemini Only    - Google Gemini CLI verification only
3. Both (Compare) - Run both and generate comparative analysis

Enter choice [1-3]:

Store user's choice as VERIFY_MODE variable (codex|gemini|both)

Step 2: Identify Verification Target

NEXT: Ask the user what to verify:

VERIFICATION TARGET
===================

What would you like to verify?

1. File(s)        - Verify existing file(s) by path (uses @filename syntax)
2. Code Snippet   - Verify code provided inline
3. Plan/Text      - Verify plan or technical text

Enter choice [1-3]:

Based on choice:

• File(s): Prompt for file path(s), use native @filepath syntax (DO NOT use Read tool)

  • Store as VERIFY_FILES array (e.g., @inc/cpu_detection.inc)
  • Support multiple files: @file1.sh @file2.sh @file3.sh
  • Paths can be absolute or relative to current working directory
  • CRITICAL: Both Codex and Gemini will read COMPLETE file content via @filepath

• Code Snippet: Prompt user to paste code directly

  • Store as VERIFY_CONTENT variable
  • Use when verifying AI-generated code or partial snippets

• Plan/Text: Prompt user to paste plan/text directly

  • Store as VERIFY_CONTENT variable
  • Use for implementation plans, architectural decisions, documentation

Why use @filepath instead of Read tool:

• ✓ Ensures COMPLETE file content (no truncation)
• ✓ Avoids attribution errors (AIs see actual file, not excerpts)
• ✓ More efficient (shorter prompts, better context management)
• ✓ Supports multi-file comparative analysis

Step 3: Select Verification Type

THEN: Ask what type of verification to perform:

VERIFICATION TYPE
=================

Select verification focus:

1. Code Review           - Bug detection, best practices, code quality
2. Plan Validation       - Completeness, feasibility, technical accuracy
3. Both Review + Plan    - Comprehensive analysis (code + plan)

Enter choice [1-3]:

Store verification type as VERIFY_TYPE variable (review|plan|both)

Step 4: Execute Verification

Based on VERIFY_MODE, run appropriate verification(s):

Codex Verification

For FILE-based verification (uses @filepath):

# Single file
codex exec "@inc/cpu_detection.inc" "ROLE: You are an expert code reviewer...
TASK: Review this file for bugs, security issues, and best practices.
Provide detailed analysis with severity ratings and code examples."

# Multiple files
codex exec "@file1.sh @file2.sh @file3.inc" "ROLE: Expert architect...
TASK: Compare these implementations and identify inconsistencies..."

For SNIPPET/PLAN verification (inline content):

CODEX_PROMPT="ROLE: You are an expert code reviewer...
CODE TO REVIEW:
---
${VERIFY_CONTENT}
---
Provide detailed analysis..."

codex exec "$CODEX_PROMPT"

Codex Command Structure:

• exec - Execute command non-interactively
• @filepath - Direct file reference (Codex reads complete file)
• "$CODEX_PROMPT" - Prompt content as positional argument (for snippets/plans)
• Note: Codex uses default model (gpt-5) unless configured otherwise

Gemini Verification

For FILE-based verification (uses @filepath):

# Single file
gemini "@inc/cpu_detection.inc" "ROLE: You are an expert code reviewer...
TASK: Review this file for bugs, security issues, and best practices.
Provide detailed analysis with severity ratings and code examples."

# Multiple files
gemini "@file1.sh @file2.sh @file3.inc" "ROLE: Expert architect...
TASK: Compare these implementations and identify inconsistencies..."

For SNIPPET/PLAN verification (inline content):

GEMINI_PROMPT="ROLE: You are an expert code reviewer...
CODE TO REVIEW:
---
${VERIFY_CONTENT}
---
Provide detailed analysis..."

gemini "$GEMINI_PROMPT"

Gemini Command Structure:

• Positional arguments: gemini "@filepath" "prompt" or gemini "prompt"
• @filepath - Direct file reference (Gemini reads complete file)
• Capture full output for analysis

Parallel Execution (Both Mode)

When VERIFY_MODE=both, run Codex and Gemini in parallel using Bash tool:

For FILE-based verification:

# Define verification prompt (without file content - use @filepath instead)
VERIFY_PROMPT="ROLE: You are an expert code reviewer analyzing CPU detection logic.

TASK: Review this file for:
1. Technical accuracy of AMD EPYC boost clock claims
2. Completeness of function implementations
3. Performance optimization correctness
4. Missing edge cases or error handling

Provide detailed analysis with severity ratings and recommendations."

# Run both verifications in parallel with @filepath
(codex exec "@inc/cpu_detection.inc" "$VERIFY_PROMPT" > /tmp/codex_output.txt 2>&1) &
CODEX_PID=$!

(gemini "@inc/cpu_detection.inc" "$VERIFY_PROMPT" > /tmp/gemini_output.txt 2>&1) &
GEMINI_PID=$!

# Wait for both to complete
wait $CODEX_PID
wait $GEMINI_PID

echo "Both verifications complete"

For SNIPPET/PLAN verification:

# Prepare full prompt with inline content
CODEX_PROMPT="ROLE: You are an expert code reviewer...
CODE TO REVIEW:
---
${VERIFY_CONTENT}
---
Provide detailed analysis..."

# Run both verifications in parallel
(codex exec "$CODEX_PROMPT" > /tmp/codex_output.txt 2>&1) &
(gemini "$CODEX_PROMPT" > /tmp/gemini_output.txt 2>&1) &
wait

echo "Both verifications complete"

Step 5: Generate Comparative Analysis (Both Mode Only)

When both Codex and Gemini are used, synthesize findings into comparative report.

Verification Prompt Templates

IMPORTANT: Choose template based on verification target:

• FILE-based: Use @filepath syntax (complete file content)
• SNIPPET/PLAN: Use inline content with {VERIFY_CONTENT} placeholder

File-Based Code Review Prompts

Template for File-Based Code Review (uses @filepath):

codex exec "@path/to/file.sh" "ROLE: You are an expert code reviewer analyzing code for quality, bugs, and best practices.

TASK: Review this file and provide:
1. Critical Issues - Bugs, security vulnerabilities, breaking changes
2. Code Quality - Best practices, readability, maintainability
3. Performance - Optimization opportunities, inefficiencies
4. Suggestions - Specific improvements with code examples

Provide detailed analysis with:
- Severity ratings (CRITICAL/HIGH/MEDIUM/LOW)
- Line-specific references
- Code examples for fixes
- Overall assessment"

Template for Multi-File Comparison (uses multiple @filepath):

gemini "@inc/cpu_detection.inc @inc/cpu_detection_old.inc" "ROLE: Expert code reviewer.

TASK: Compare these two implementations and identify:
1. Functional differences and breaking changes
2. Performance improvements or regressions
3. Code quality changes
4. Recommendations for migration or rollback

Focus on technical accuracy and completeness."

Inline Code Review Prompts

Template for Code Review (inline snippets):

ROLE: You are an expert code reviewer analyzing code for quality, bugs, and best practices.

TASK: Review the following code and provide:
1. Critical Issues - Bugs, security vulnerabilities, breaking changes
2. Code Quality - Best practices, readability, maintainability
3. Performance - Optimization opportunities, inefficiencies
4. Suggestions - Specific improvements with code examples

CODE TO REVIEW:
---
{VERIFY_CONTENT}
---

Provide detailed analysis with:
- Severity ratings (CRITICAL/HIGH/MEDIUM/LOW)
- Line-specific references
- Code examples for fixes
- Overall assessment

File-Based Plan Validation Prompts

Template for File-Based Implementation Review (uses @filepath):

codex exec "@docs/migration-plan.md" "ROLE: You are an expert technical architect validating implementation plans.

TASK: Validate this implementation plan for:
1. Completeness - Are all necessary steps covered?
2. Feasibility - Is the plan technically sound?
3. Dependencies - Are dependencies identified and ordered correctly?
4. Edge Cases - Are edge cases and error handling considered?
5. Best Practices - Does it follow industry best practices?

Provide structured analysis:
- Missing steps or gaps
- Technical concerns or risks
- Dependency issues
- Recommended improvements
- Overall feasibility rating (1-10)"

Inline Plan Validation Prompts

Template for Plan Validation (inline text):

ROLE: You are an expert technical architect validating implementation plans.

TASK: Validate the following implementation plan for:
1. Completeness - Are all necessary steps covered?
2. Feasibility - Is the plan technically sound?
3. Dependencies - Are dependencies identified and ordered correctly?
4. Edge Cases - Are edge cases and error handling considered?
5. Best Practices - Does it follow industry best practices?

PLAN TO VALIDATE:
---
{VERIFY_CONTENT}
---

Provide structured analysis:
- Missing steps or gaps
- Technical concerns or risks
- Dependency issues
- Recommended improvements
- Overall feasibility rating (1-10)

Combined Review + Plan Prompts

Template for Comprehensive Analysis:

ROLE: You are an expert code architect performing comprehensive analysis.

TASK: Analyze the following for both code quality AND implementation approach:

CODE REVIEW FOCUS:
- Critical bugs and security issues
- Code quality and best practices
- Performance optimization

PLAN VALIDATION FOCUS:
- Implementation completeness
- Technical feasibility
- Architecture decisions
- Edge case handling

CONTENT TO ANALYZE:
---
{VERIFY_CONTENT}
---

Provide dual perspective:
1. CODE QUALITY ASSESSMENT
2. IMPLEMENTATION APPROACH ASSESSMENT
3. CRITICAL ISSUES (both code and plan)
4. RECOMMENDATIONS

Comparative Analysis Framework

When VERIFY_MODE=both, generate comparative report using this structure:

Comparative Report Template

AI CROSS-VERIFICATION COMPARATIVE ANALYSIS
==========================================

Verification Date: {timestamp}
Verification Mode: Codex + Gemini
Verification Type: {VERIFY_TYPE}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CONSENSUS FINDINGS (Both AIs Agree)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{Extract common findings from both outputs}

[CRITICAL] {issue}
  └─ Codex: {codex_assessment}
  └─ Gemini: {gemini_assessment}
  └─ Confidence: HIGH (both agree)

[HIGH] {issue}
  └─ Codex: {codex_assessment}
  └─ Gemini: {gemini_assessment}
  └─ Confidence: HIGH (both agree)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CODEX-SPECIFIC FINDINGS (Codex Only)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{Issues identified only by Codex}

[PRIORITY] {issue}
  └─ Finding: {codex_finding}
  └─ Gemini: Did not identify this issue
  └─ Confidence: MEDIUM (single source)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GEMINI-SPECIFIC FINDINGS (Gemini Only)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{Issues identified only by Gemini}

[PRIORITY] {issue}
  └─ Finding: {gemini_finding}
  └─ Codex: Did not identify this issue
  └─ Confidence: MEDIUM (single source)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CONFLICTING ASSESSMENTS (Disagreements)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{Areas where Codex and Gemini disagree}

[CONFLICT] {topic}
  └─ Codex Position: {codex_view}
  └─ Gemini Position: {gemini_view}
  └─ Analysis: {synthesized_analysis}
  └─ Recommendation: {recommended_approach}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SYNTHESIS & RECOMMENDATIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

OVERALL ASSESSMENT:
  Codex Rating: {rating}/10
  Gemini Rating: {rating}/10
  Consensus Rating: {synthesized_rating}/10

TOP PRIORITY ACTIONS:
  1. {high_confidence_issue_from_consensus}
  2. {second_priority_action}
  3. {third_priority_action}

SECONDARY CONSIDERATIONS:
  • {single_source_findings_worth_investigating}
  • {areas_of_disagreement_to_explore}

CONFIDENCE LEVELS:
  ✓ HIGH:   Issues identified by both AIs
  ⚠ MEDIUM: Issues identified by one AI only
  ⚡ LOW:    Conflicting assessments requiring human judgment

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FULL AI OUTPUTS (Reference)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

╔═══════════════════════════════════════════════╗
║  CODEX FULL OUTPUT                            ║
╚═══════════════════════════════════════════════╝

{codex_full_output}

╔═══════════════════════════════════════════════╗
║  GEMINI FULL OUTPUT                           ║
╚═══════════════════════════════════════════════╝

{gemini_full_output}

Single-AI Report Template

When VERIFY_MODE=codex or VERIFY_MODE=gemini, use simpler format:

AI VERIFICATION REPORT
======================

Verification Date: {timestamp}
AI Model: {Codex | Google Gemini}
Verification Type: {VERIFY_TYPE}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FINDINGS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{ai_output_formatted_with_sections}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SUMMARY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Overall Assessment: {rating}/10
Critical Issues: {count}
High Priority: {count}
Recommendations: {count}

Top Priority Actions:
  1. {top_action}
  2. {second_action}
  3. {third_action}

File Reference Strategies

When to Use @filepath vs Inline Content

Use @filepath syntax when:

• ✓ Verifying existing files in the codebase
• ✓ Need COMPLETE file content (no truncation risk)
• ✓ Comparing multiple files for consistency
• ✓ Reviewing implementation accuracy against specifications
• ✓ Files contain >100 lines (avoids token bloat from Claude reading + pasting)

Use inline content ({VERIFY_CONTENT}) when:

• ✓ Verifying AI-generated code or plans (not yet saved to files)
• ✓ Code snippets from user paste (partial functions, examples)
• ✓ Implementation plans or architectural decisions (text-based)
• ✓ Temporary verification before file creation
• ✓ Content sourced from external systems (API responses, databases)

Working Directory Context

Both Codex and Gemini support absolute and relative paths:

# Absolute paths (explicit, recommended for clarity)
codex exec "@/workspace/project/inc/cpu_detection.inc" "Review this..."