---
name: review-julia
description: Run the Julia code review protocol on Julia scripts. Checks code quality, type stability, parallel computing patterns, and scientific computing standards. Produces a report without editing files.
disable-model-invocation: true
argument-hint: "[filename or 'all']"
allowed-tools: ["Read", "Grep", "Glob", "Write", "Task"]
---

## Review Julia Code

Run a comprehensive Julia code review on the specified script(s). **Do NOT edit any source files** -- produce a report only.

### Steps

1. **Identify target**: Use `$ARGUMENTS` to find the Julia file(s). If `all`, scan all `.jl` files in the project.

2. **Read standards** from `.claude/rules/julia-code-conventions.md`.

3. **Check these categories**:
   - **Module Structure:** Proper module organization, exports, includes
   - **Parallel Computing:** `@everywhere` annotations, `pmap` usage, worker data distribution
   - **Optimization:** Convergence checks, multiple starting values, grid search patterns
   - **Type Stability:** Concrete types in hot loops, `@code_warntype` recommendations
   - **Path Conventions:** `joinpath()` usage, no hardcoded OS-specific separators
   - **Naming:** `snake_case` functions, `CamelCase` types, paper notation alignment
   - **Common Pitfalls:** Missing `@everywhere`, local minima, large closures in `pmap`

4. **Save report** to `quality_reports/[script_name]_julia_review.md`.

5. **Present summary**: Total issues, severity breakdown, top critical issues.

### Important
- **NEVER edit source files.** Report only.
- Prioritize correctness and performance over style.
- For Julia code generation patterns (MLE, GMM, simulation), see `/econometrics-julia`.