oliver-kriska/claude-elixir-phoenix / plugins/elixir-phoenix/skills/review
review
VerifiedReview Elixir/Phoenix changes before committing — bugs, security, Ecto, LiveView, and Oban anti-patterns, via parallel specialist agents. Use when asked to review changes, a component, a diff, or a PR.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.8 KB |
| references/agent-spawning.md | markdown | 3.9 KB |
| references/blocker-handling.md | markdown | 2.6 KB |
| references/conventions.md | markdown | 1.9 KB |
| references/example-review.md | markdown | 2.5 KB |
| references/requirements-detection.md | markdown | 3.9 KB |
| references/review-template.md | markdown | 3.4 KB |
references/review-template.md
View on GitHub# Review Template Format
## Full Review Template
Write to `.claude/plans/{slug}/reviews/{feature}-review.md`:
```markdown
# Review: {Feature or Scope}
**Date**: {date}
**Files Reviewed**: {count}
**Reviewers**: elixir-reviewer, testing-reviewer, security-analyzer
## Summary
| Severity | Count |
|----------|-------|
| Blockers | {n} |
| Warnings | {n} |
| Suggestions | {n} |
**Verdict**: PASS | PASS WITH WARNINGS | REQUIRES CHANGES | BLOCKED
## Requirements Coverage (from {REQUIREMENTS_SOURCE})
| # | Requirement | Status | Evidence |
|---|-------------|--------|----------|
| 1 | {requirement text, ~80 chars} | MET | `lib/foo.ex:42` |
| 2 | {...} | PARTIAL | handler at `foo_live.ex:110`; no test for error branch |
| 3 | {...} | UNMET | not found in diff |
| 4 | {...} | UNCLEAR | UX requirement — manual verification needed |
**Summary**: {n_met} MET · {n_partial} PARTIAL · {n_unmet} UNMET · {n_unclear} UNCLEAR
*Omit this entire section if `--no-requirements` was passed. If detection
failed, replace the table with a single line: `**NOT AVAILABLE** —
{reason}`. Placement is intentional: this block precedes the per-severity
findings because "did we deliver what we promised" is the user's first
question.*
## Blockers ({n})
### 1. {Issue Title}
**File**: {path}:{line}
**Reviewer**: {agent}
**Issue**: {description}
**Why this matters**: {impact explanation}
**Current code**:
```elixir
bad_code()
```
**Recommended approach**:
```elixir
good_code()
```
---
### 2. {Issue Title}
...
## Warnings ({n})
### 1. {Issue Title}
**File**: {path}:{line}
**Reviewer**: {agent}
**Issue**: {description}
**Recommendation**: {what to do}
---
## Suggestions ({n})
### 1. {Suggestion Title}
**File**: {path}
**Suggestion**: {improvement idea}
---
## Next Steps
How would you like to proceed?
- `/phx:plan` — Replan the fixes (for complex/architectural issues)
- `/phx:work` — Fix directly (for simple, clear fixes)
- I'll handle it myself
```
## Verdict Decision Rules
| Verdict | Conditions |
|---------|-----------|
| **PASS** | No blockers, no warnings, suggestions only, all requirements MET |
| **PASS WITH WARNINGS** | No blockers, warnings present but not test-coverage gaps, OR some requirements PARTIAL |
| **REQUIRES CHANGES** | No Iron Law blockers but test coverage gaps detected (see below), OR any requirement UNMET |
| **BLOCKED** | Iron Law violations or critical security/data issues |
### REQUIRES CHANGES Triggers
This verdict catches code that works but lacks adequate test coverage:
- New public functions with zero tests
- Removed tests without replacement coverage
- New `handle_event` callbacks without corresponding tests
- New Oban workers without `perform/1` tests
- New LiveView routes without basic mount/render tests
These are not blockers (code works) but should not merge without tests.
## Mandatory Summary Table
Every review MUST end with this at-a-glance table (even if only 1 finding):
| # | Finding | Severity | Reviewer | File | New? |
|---|---------|----------|----------|------|------|
| 1 | {title} | BLOCKER/WARNING/SUGGESTION | {agent} | {path}:{line} | Yes/Pre-existing |
**New?** column: "Yes" = finding on changed lines (this diff). "Pre-existing" = on unchanged code. Pre-existing issues appear in the report but do NOT affect the verdict.
The review template has no task lists (`- [ ]`), fix phases, or plan
modifications. Review is findings-only; task creation belongs in `/phx:plan`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |