Detailed Design Review Report

Skill Name: sa-detailed-design-review

Background & Applicable Scenarios

After the development team produces concrete detailed design documents based on the architecture design, someone needs to verify: does this detailed design follow the overall architecture constraints? Does it cover all user story requirements? This skill helps the SA perform architecture consistency review to prevent development from going off track.

Input & Output

What you need to provide: Architecture Design Specification + Scenario-level detailed design documents + Corresponding user stories.

What you will get: Detailed Design Review Report covering two review dimensions: Architecture Consistency (whether the detailed design complies with the overall architecture's layering, module, interface constraints) and Requirement Completeness (whether all acceptance criteria from user stories are covered). Three-state conclusion: PASS / NEEDS_REVISION / REJECT, with improvement suggestions.

Process Description

The Agent reviews the detailed design from two dimensions: Architecture Consistency (compliance with overall architecture layering, module, and interface constraints) and Requirement Completeness (coverage of all user story acceptance criteria). Three-state conclusion: PASS / NEEDS_REVISION / REJECT, with specific improvement suggestions.

flowchart TD s0["Review KB Retrieval: Load review experience, common anti-patterns, best practice cases from engineering KB"] s1["Review Scope Confirmation: Confirm review scenario scope, input documents, review dimensions"] s2["Review Scope Inquiry Round"] s3["Architecture Consistency Review: Dimension-by-dimension check of detailed design against architecture constraints"] s4["Requirement Completeness Review: Scenario-by-scenario check of detailed design coverage of requirements"] s5["Document Integration & Full Review"] s0 --> s1 s1 --> s2 s2 --> s3 s3 --> s4 s4 --> s5