Big Review

---
name: big-review
description:
  Run ~/code/dotfiles/bin/review.sh to perform a multi-model review, evaluate findings, fix valid
  issues (with tests when possible), add clarifying comments for invalid findings, then run required
  checks. Use before PR creation or when the user asks for a deep review.
---

# Big Review

## Overview

Run the local `review.sh` script to get multi-model review findings, then triage and address valid
issues before final validation and PR creation.

## Workflow

### 1) Preflight

- Confirm the script exists and is executable: `~/code/dotfiles/bin/review.sh`.
- Ensure `gh`, `gemini`, `claude`, `codex`, `jq`, and `script` are available (the script checks
  this).
- Do not use `--post` unless explicitly asked.
- Expect a long runtime (15+ minutes); set any command timeout to >= 30 minutes.

### 2) Run the review

- Run: `~/code/dotfiles/bin/review.sh`.
- Capture the consolidated output (P0-P3 items or "No issues found.").

### 3) Triage findings

For each item:

- **Valid + worth fixing**
  - If tests exist for the area, add or extend coverage for the issue.
  - Run the test and confirm it fails.
  - Apply the fix and re-run the test to confirm it passes.
- **Invalid or not worth fixing**
  - Add a brief code comment explaining why it is safe or intentional.

### 4) Re-run review if needed

- Re-run `review.sh` only if you made substantive changes that affect earlier findings.

### 5) Final validation

- Run repo-required checks (for this repo: `corepack yarn check`).
- Note any warnings but avoid unrelated changes unless required.

## Notes

- The review script already forbids modifications while running; only edit after it finishes.
- If `review.sh` fails (missing tools or empty output), fall back to manual review and proceed.