wa:design-review

Validate architecture, design, FRD, and risk artifacts for design review gates.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-design-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wa:design-review
Source: https://github.com/jeremy-newhouse/eck-e2e-weather-app/tree/main/.claude/skills/design-review
Command: npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-design-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents implementation of incomplete or untraceable designs by validating that architecture, design artifacts, AC-ID coverage, and risk criteria are present and sufficiently detailed for the current rigor level.

Core Features & Use Cases

  • Design artifact validation: Scans for required documents like ARCHITECTURE.md and DESIGN.md and checks whether they contain substantive content rather than placeholders.
  • AC-ID addressability & checklist evaluation: Verifies that every AC-ID from FRD.md is traceable to an architectural or design decision and runs a rigor-based PASS/WARNING/FAIL gate checklist.
  • Risk gate and report generation: Confirms risk readiness (based on design-risk outputs and risk assessment docs when required) and writes an auditable report to docs/{feature}/DESIGN-REVIEW.md.

Quick Start

Run the design review for the feature by entering: /design-review your feature description (for example, "user authentication with OAuth2").

Frequently Asked Questions about wa:design-review

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

FAQPage Schema
How do I validate design completeness before feature implementation?

To validate design completeness, a rigor-based review gate scans required architecture, design, and FRD artifacts to ensure they contain substantive content rather than placeholders before implementation begins.

What is AC-ID traceability in a design review?

AC-ID traceability is the process of verifying that every acceptance criteria ID from the FRD document maps directly to an architectural or design decision, ensuring full requirement addressability.

How do I perform a lifecycle gating check for feature readiness?

Run a design review command with a feature description to assess design completeness, AC-ID addressability, and risk readiness, which outputs a PASS, WARNING, or FAIL gate verdict.

What design artifacts are required for an architecture validation review?

Architecture validation requires documents like ARCHITECTURE.md, DESIGN.md, and FRD.md, along with risk assessment documentation when mandated by the current rigor level.

Does the design review gate block implementation if artifacts are missing?

Yes, the design review gate fails blocking items when required architecture, design, or risk artifacts are missing or insufficient for the specified rigor level, preventing implementation.

How does risk assessment factor into software design review?

Risk assessment factors into design review by confirming risk readiness based on design-risk outputs and risk assessment docs, which must be present and sufficiently detailed to pass the gate.