design-review

Analyze design outputs against specification contracts and quality criteria.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/sofer/.agents --skill design-review-sofer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/sofer/.agents/tree/main/skills/design-review
Command: npx skills add https://github.com/sofer/.agents --skill design-review-sofer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design reviews help ensure architecture, standards, and quality expectations are met before implementation, preventing costly rework and misaligned outcomes.

Core Features & Use Cases

  • Spec alignment verification: ensures every contract and requirement maps to a realizable design.
  • Standards compliance and architectural quality assessment: checks patterns, SRP, dependencies, and risk.
  • Verdict-driven progression: outputs a structured report and gating decisions to proceed to implementation stubs.
  • Actionable feedback: lists issues with severity, category, and suggested fixes.

Quick Start

Provide the design artifacts (design docs, specs, standards) and run the review to obtain a formal verdict and actionable feedback.

Frequently Asked Questions about design-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify architecture alignment before implementation?

To verify architecture alignment, analyze design outputs against specification contracts, patterns, and quality criteria. This design review process ensures every requirement maps to a realizable design, preventing costly rework by validating architecture before coding begins.

What is a design verdict and how does it gate implementation?

A design verdict is a structured YAML report that gates progression to implementation stubs. It outputs formal decisions based on spec alignment, standards compliance, and risk assessment, listing actionable issues with severity and suggested fixes.

How do I assess architectural risk and standards compliance in a design review?

Assess architectural risk and standards compliance by checking design patterns, Single Responsibility Principle adherence, and dependency structures. The review process captures risk considerations and quality criteria to provide a formal verdict on architecture viability.

What design artifacts do I need to provide for a specification alignment check?

For a specification alignment check, provide design documents, specifications, and applicable standards. These inputs are analyzed to ensure contracts and requirements map accurately to the proposed architecture before providing a formal review verdict.

Can I get actionable feedback on design issues found during an architecture review?

Yes, you can get actionable feedback on design issues during an architecture review. The process lists identified problems with specific severity levels, categories, and suggested fixes, outputting the results in a structured YAML format.