design-review

Evaluate software design documents against PRDs for gaps and risks.

Updated Sep 13, 2025
One-click install
npx skills add https://github.com/nobelk/claude-tools --skill design-review-nobelk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/nobelk/claude-tools/tree/main/skills/design-doc-review
Command: npx skills add https://github.com/nobelk/claude-tools --skill design-review-nobelk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Conducting rigorous, principal-engineer-level reviews of software design documents to ensure PRD alignment, architectural soundness, and production-readiness.

Core Features & Use Cases

  • Systematic PRD alignment verification across architecture, data, API, security, reliability, and operations.
  • Structured, citation-backed evaluations with actionable recommendations and risk labeling.
  • Use cases include design doc critique, technology trade-off analysis, and production-readiness assessment.

Quick Start

Instruct the assistant to perform a comprehensive design review against the PRD and return a prioritized, evidence-backed report.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I conduct a principal-grade software design review against a PRD?▼

Automate principal-grade evaluation of software design documents against PRDs to surface gaps, risks, and actionable improvements. Apply this to architecture reviews, system design proposals, and production-readiness assessments across complex diagrams and ADRs.

What is included in a comprehensive architecture and system design evaluation?▼

A comprehensive architecture and system design evaluation includes systematic PRD alignment verification across architecture, data design, API interfaces, security, reliability, and operations, outputting a prioritized, evidence-backed assessment report.

How do I assess production-readiness for complex software systems?▼

Assess production-readiness by performing structured, citation-backed evaluations of ADRs and system design proposals against the PRD to identify architectural gaps, label operational risks, and output a prioritized assessment.

Can I use a structured checklist to critique technology trade-offs in design documents?▼

Yes, you can use a structured checklist to critique technology trade-offs in design documents. The evaluation provides citation-backed recommendations and risk labeling for architecture, API, and reliability decisions.

Do I need to provide references and a PRD to perform a design doc critique?▼

Yes, performing a design doc critique requires providing references for context and a PRD for alignment verification. The evaluation uses these inputs to output a prioritized, evidence-backed assessment of your design.

What is the best way to verify PRD alignment across security and reliability dimensions?▼

The best way to verify PRD alignment across security and reliability dimensions is to automate a principal-grade evaluation using a structured checklist, which systematically checks these areas and outputs a prioritized risk assessment.