# Two Stage Review

> Two-Stage Code Review

- Skill: `pyinx/two-stage-review` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pyinx/two-stage-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pyinx/two-stage-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: pyinx (https://skillmd.com/u/pyinx)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/pyinx/two-stage-review

---


# Two-Stage Code Review

## Purpose

Ensure code quality through a rigorous two-stage review process that catches both specification violations and maintainability issues.

## Process

### Stage 1: Specification Compliance Review

**Goal**: Prevent over-building and under-building

**Checklist**:
- ✅ All required features implemented (no missing functionality)
- ❌ No unauthorized features added (no scope creep)
- 📋 API design matches architecture document
- 📋 Data model matches specifications
- 📋 User stories fully satisfied

**Outcome**: ✅ Compliant or ❌ Non-compliant with specific issues

### Stage 2: Code Quality Review

**Goal**: Ensure maintainability and clarity

**Checklist**:
- 📐 Clear variable naming
- 📐 Single responsibility functions
- 🔧 No code duplication
- 🔧 Modular design
- 🧪 Adequate test coverage
- ⚡ No obvious performance issues
- 🛡️ Input validation
- 🛡️ Error handling

**Outcome**: ✅ Approved or ❌ Needs improvement with specific issues

## Review Loop

```
Implementation → Stage 1 Review → ❌ Fix spec issues → Repeat Stage 1
                                → ✅ Pass → Stage 2 Review → ❌ Fix quality issues → Repeat Stage 2
                                                              → ✅ Pass → Complete
```

## Usage

This skill is automatically invoked by the CEO workflow during Phase 4 (Development) after each subtask completion.