two-stage-review

Structured PR review separates spec compliance checks from code quality assessments to catch different types of issues. This two-stage process ensures thorough evaluations by first verifying correctness against specifications, then evaluating robustness and maintainability.

A two-stage code review verifies adherence to specifications before assessing code quality. It is needed for complex development workflows where both correctness and maintainability are critical, reducing bugs by evaluating spec compliance and code integrity separately.

To verify code matches specifications, provide the spec and diff to a subagent for a specification pass. Follow this with a quality review to assess the code's integrity and standards, ensuring the implementation is correct before checking robustness.

Separating spec verification from quality assessment improves bug prevention by isolating correctness checks from maintainability checks. This structured evaluation ensures specific issues are caught independently, preventing bugs and elevating overall code standards.

Workflow automation for multi-phase code reviews guides reviewers through a structured process, ensuring thorough evaluations. It facilitates the separation of spec compliance and quality assessment without manual tracking, streamlining the entire PR review.

Combining spec compliance and code quality checks risks overlooking specific issues because different types of bugs require distinct evaluation stages. Separating them ensures thorough evaluations, preventing bugs that a single-pass review might miss.