Claude-skill-registry cross-review-policy

Cross-Review Policy Skill

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/cross-review-policy" ~/.claude/skills/majiayu000-claude-skill-registry-cross-review-policy && rm -rf "$T"
manifest: skills/data/cross-review-policy/SKILL.md
source content

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

IterationStatusAction
1First reviewCodex reviews original commit
2Second reviewCodex reviews fix commit
3Final reviewLast chance for approval
3+Limit reachedPresent to user regardless

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 <noreply@anthropic.com>

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 <noreply@anthropic.com>

Review Types Covered

Review TypeTrigger
Code ReviewsEvery commit
SPARC Gate-PassPhase completion
QA ReviewsFeature completion
Security ReviewsSecurity-sensitive changes
Architecture ReviewsArchitectural changes

Provider Mapping

Primary AgentReviewer
Claude CodeOpenAI Codex
Google GeminiOpenAI Codex
OpenAI CodexN/A (is the reviewer)

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.