review
Run the multi-persona review board on the current changes — frontend architecture, UX, security, performance, and QA lenses — and consolidate findings by severity. Use before any PR, when the user say
SKILL.md.claude/skills/review/SKILL.md
GitHubContext
- Diff stat: !
git diff --stat ${ARGUMENTS:-main}...HEAD 2>/dev/null | tail -20 || git diff --stat HEAD
Task
Convene the review board on the current branch's changes (base: $ARGUMENTS or main) using the reviewer lenses in docs/personas/. This runs locally before merge — there is no cloud CI review (ADR-0008).
- Select reviewers by blast radius (don't waste tokens on irrelevant lenses):
- Any code →
frontend-architect - User-visible UI/copy/animation →
ux-reviewer - Native config, deps, env, storage, network, CI →
security-engineer - Lists, animations, re-renders, heavy screens →
performance-engineer - Tests, features, CUJ-touching changes →
qa-engineer
- Any code →
- Dispatch the board. Prefer the
code-reviewersubagent (.claude/agents/code-reviewer.md), which adopts each persona indocs/personas/in turn — running it as a subagent keeps this conversation's context clean. For a focused pass you may adopt only the selected personas inline. Each persona reads its own file first and follows its required finding format. - Consolidate into one report, deduplicated, ordered P1 → P3, each finding with
file:lineand a concrete fix:
## Review board — <branch> vs <base>
Verdicts: arch ✗/✓ · ux ✓ · security ✓ · perf ✓ · qa ✓
### P1 (fix now) ### P2 (fix or ticket) ### P3 (follow-up)
[P1] path:line — issue — fix
- Drive resolution. Offer to fix P1/P2 findings now (or hand to
/implement-feature); apply approved fixes and re-runnpm run verify. List P3s for the PR's follow-ups section. A finding you disagree with → argue it explicitly in the report, don't silently drop it; the human reviewer arbitrates. - Encode repeats. Any finding a persona has now raised twice across PRs is harness debt → end with a
HARNESS:proposal and run/encode-lessonfor it.
This board runs before human review so humans spend attention on intent and taste, not on catchable defects.