agentic-review

Agentic Code Review

Deep, multi-agent code review for personal repos. Analyzes changes, prioritizes files, spawns specialized review agents in parallel, and synthesizes actionable findings.

When to Use

• After writing significant code, before committing
• Before pushing a branch
• Reviewing specific commits
• Comparing branches (e.g., feature vs main)

Usage

# Review all local changes (staged + unstaged)
skill agentic-review

# Review only staged changes
skill agentic-review --staged

# Review specific commit(s)
skill agentic-review abc123
skill agentic-review abc123..def456

# Review branch diff against main
skill agentic-review --branch feature-branch
skill agentic-review --branch HEAD  # current branch vs main

How It Works

Phase 1: Detect & Gather Changes

First, determine what to review based on arguments:

# Check if we're in a git repo
git rev-parse --is-inside-work-tree 2>/dev/null || echo "NOT_GIT_REPO"

# Get current branch
git branch --show-current

# Check for changes
git status --porcelain        # Any local changes?
git diff --stat               # Unstaged changes stats
git diff --cached --stat      # Staged changes stats

Determine review scope from $ARGUMENTS:

Argument	What to Review
(empty)	All local changes (staged + unstaged)
--staged	Only staged changes
abc123	Specific commit
abc123..def456	Commit range
--branch NAME	Branch diff vs main/master
--branch HEAD	Current branch vs main/master

Phase 2: Pre-Scan & Prioritize Files

Analyze changed files to recommend review order:

# Get changed files with stats
git diff --numstat HEAD~1 2>/dev/null || git diff --numstat

# For each file, assess:
# - Lines changed (more = higher priority)
# - File type (src > test > config > docs)
# - Risk areas (auth, security, data, API)

Prioritization Heuristics:

1. HIGH: Security-related files (auth, crypto, permissions, secrets)
2. HIGH: Core business logic (models, services, controllers)
3. MEDIUM: API endpoints, data access
4. MEDIUM: Configuration files that affect runtime
5. LOW: Tests, documentation, styling