implementation-review

Validate code behavior against story acceptance criteria by running a two-stage implementation review that checks spec compliance and code quality before opening a pull request. It identifies deviations and outputs structured remediation guidance.

A two-stage implementation review is a validation process that first verifies changes implement acceptance criteria exactly without unrequested behavior, then assesses code structure, readability, and maintainability to flag critical blocking issues.

Perform an implementation review at key checkpoints: after completing a batch of related tasks, before opening a pull request, or when issues arise during implementation. This timing ensures early detection of spec and quality gaps.

Check for unrequested behavior by applying the spec compliance stage of an implementation review, which verifies that code changes implement acceptance criteria exactly and identifies any deviations or unrequested behavior introduced.

The best way to structure remediation guidance is using provided review templates that assess code structure, readability, maintainability, and project conventions, flagging critical issues that block progress before merging.

Yes, the implementation review process works without external dependencies, relying on structured templates and a two-stage validation workflow to guide spec compliance and code quality remediation directly.