Cross-Review Policy Skill

Cross-Review Policy Skill

Version: 1.0.0 Category: Workflows Triggers: Completing AI work, code review, presenting to user

Quick Reference

Core Rule

ALL work performed by Claude Code or Google Gemini MUST be reviewed by OpenAI Codex.

Review Flow

Claude/​Gemini performs task
         ↓
    Commit changes
         ↓
    Codex reviews
         ↓
    Feedback needed?
    ├── No → Present to user (APPROVED)
    └── Yes → Implement fixes
                   ↓
              Iteration < 3?
              ├── Yes → Re-commit → Codex reviews
              └── No → Present to user (LIMIT_REACHED)

Maximum Iterations: 3

Commands

# Trigger cross-review loop
./​scripts/​ai-review/​cross-review-loop.sh --max-iterations 3

# Check review status
./​scripts/​ai-review/​review-manager.sh list

# Check iteration status
./​scripts/​ai-review/​review-manager.sh iteration-status <review_id>

# Force complete (skip remaining iterations)
./​scripts/​ai-review/​review-manager.sh force-complete <review_id>

Commit Message Formats

Original Work Commit

<type>: <description>

<body>

Co-Authored-By: Claude <[email protected]>

Review Fix Commit

fix(review): <description>

Addresses Codex review feedback (iteration N/​3)
Review-ID: <review_id>
Original-Commit: <original_sha>

Co-Authored-By: Claude <[email protected]>

Review Types Covered

Provider Mapping

Exit Conditions

Review loop exits when ANY condition is met:

1. APPROVED: Codex approves the changes
2. MAX_ITERATIONS: 3 iterations completed
3. FORCE_COMPLETE: User forces completion
4. NO_CHANGES: No actionable feedback

Exceptions (NOT Required)

• Documentation-only changes (pure markdown/​text)
• Configuration files (non-code config)
• Emergency hotfixes (with explicit user override)
• User-initiated commits (non-AI commits)

Full Reference

See: @docs/​modules/​ai/​CROSS_REVIEW_POLICY.md

---

Use this when completing AI work, understanding review requirements, or managing review iterations.