design-review

Reviews design documents for rigor, completeness, and adherence to principles.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/charly-vibes/wai --skill design-review-charly-vibes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/charly-vibes/wai/tree/main/.agents/skills/design-review
Command: npx skills add https://github.com/charly-vibes/wai --skill design-review-charly-vibes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the common issue of design artifacts lacking rigor, completeness, or adherence to best practices, which can lead to flawed solutions and wasted development effort.

Core Features & Use Cases

  • Artifact Analysis: Critically evaluates problem statements, decision matrices, and scope documents.
  • Best Practice Adherence: Ensures designs are solution-agnostic, root-cause focused, specific, evidence-based, and clearly scoped.
  • Use Case: Before starting development on a new feature, use this Skill to review the proposed problem statement and design document to ensure they are clear, well-justified, and aligned, preventing costly rework later.

Quick Start

Review the attached design document 'new-feature-design.md' for rigor and completeness.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I review a design document for rigor and completeness before implementation?

Review a design document for rigor by evaluating problem statements, decision matrices, and scope documents to ensure they are root-cause focused, evidence-based, and clearly scoped. This prevents flawed solutions and wasted development effort.

What is solution contamination in a problem statement and how do I check for it?

Solution contamination in a problem statement occurs when the proposed solution dictates the problem definition rather than remaining solution-agnostic. Check for it by analyzing artifacts to ensure the root cause is clear and independent of specific implementation choices.

How do I evaluate a decision matrix to ensure it adheres to established design principles?

Evaluate a decision matrix by analyzing it for specificity, evidence quality, and constraint realism. This ensures the matrix adheres to established design principles and provides structured feedback to identify critical findings before development starts.

Does this design review process work for analyzing scope documents and problem statements?

Yes, the design review process specifically analyzes scope documents and problem statements for completeness and adherence to best practices. It identifies critical findings and provides structured feedback to ensure design quality before implementation.

What is the best way to ensure my design artifacts are ready for development?

The best way to ensure design artifacts are ready is to critically evaluate them for root cause clarity, specificity, evidence quality, and constraint realism. This structured feedback prevents costly rework by aligning designs with best practices.

Why does my scope document lack rigor and how can I improve its quality?

A scope document lacks rigor when it fails to be specific, evidence-based, or clearly scoped. Improve its quality by using structured feedback from an artifact analysis that checks for constraint realism and adherence to established design principles.