← ClaudeAtlas

review-rubriclisted

Standard code review checklist for all reviewers. Load this when performing a peer review at Stage 5. Covers spec compliance, correctness, security, test coverage, readability, and performance. Defines what constitutes APPROVED vs CHANGES_REQUESTED and how to write review findings.
telus-labs/stagecraft · ★ 0 · AI & Automation · score 70
Install: claude install-skill telus-labs/stagecraft
# Review Rubric Use this skill when performing a code review. It defines the standard review checklist every reviewer must work through. ## Mandatory Checks (every review) ### 1. Spec Compliance - Does the code match `pipeline/design-spec.md`? - Are all API contracts implemented as specified? - Are there undocumented deviations? (BLOCKER if unexplained) ### 2. Correctness - Are all edge cases from the spec handled? - Are error paths handled and tested? - Are there off-by-one errors, null dereferences, or type mismatches? ### 3. Security - No secrets in code - Input validation present - Auth checks in place where spec requires them - No SQL string concatenation ### 4. Test Coverage - Does new behaviour have corresponding tests? - Do tests actually test the behaviour (not just call the function)? ### 5. Readability - Can a new team member understand this code in 5 minutes? - Are complex sections commented? ## Comment Classification Every review comment must be one of: **BLOCKER** — Must be fixed before this PR can merge. Use for: security issues, missing tests, spec violations, broken behaviour. **SUGGESTION** — Would improve the code. Author's call. Use for: style preferences, minor optimisations, naming improvements. **QUESTION** — Need clarification. Not blocking unless answered badly. Use for: unclear intent, possible oversight, design question. ## Verdict `REVIEW: APPROVED` — No blockers. May have suggestions. `REVIEW: CHANGES REQUESTED` — One or more b