Code Architect

Code Architect v2

🔍 External code review powered by OpenAI's GPT-5.2-Codex

A Claude Custom Skill that provides intelligent code reviews using OpenAI's most advanced coding model. Get a "second pair of eyes" on your code changes with detailed feedback on bugs, security vulnerabilities, performance issues, and best practices.

✨ Features

• Multi-Runtime Support - Automatically detects and uses Node.js (preferred) or Python
• Auto-Dependency Installation - Installs the OpenAI package if missing
• Multiple Review Types - Standard, security, architecture, and performance focused reviews
• Adjustable Reasoning Depth - From quick checks to deep analysis
• Structured Output - JSON schema-validated responses with severity-ranked findings
• CI/CD Ready - Exit codes for automation, JSON output option

📋 Prerequisites

1. **OpenAI API Key**

   export OPENAI_API_KEY="sk-..."

2. **Runtime** (one of):

   • Node.js 18+ (preferred)
   • Python 3.8+

🚀 Quick Start

As a Claude Custom Skill

1. Download or clone this repository
2. Zip the code-architect-v2 folder
3. Upload to Claude via Settings > Skills
4. Enable the skill

Then just ask Claude:

• "Review my code changes"
• "Get a second opinion on this PR"
• "Security review of my authentication code"

Standalone Usage

# Review staged git changes
bash scripts/code_review.sh --diff "$(git diff --staged)"

# Review specific files
bash scripts/code_review.sh --files src/auth.js src/api.js

# Security-focused review with high reasoning effort
bash scripts/code_review.sh --diff "$(git diff)" --review-type security --effort high

# Pipe diff directly
git diff HEAD~3 | bash scripts/code_review.sh

📖 Usage

Command Line Options

Usage: code_review.sh [options]

Input Options:
  -d, --diff          Code diff to review
  -f, --files        File paths to review
  -c, --context       Additional context about changes

Review Config