design-review

Review design documents against a 9-point checklist and issue severity-ranked findings.

89|7|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/nikhilsitaram/claude-caliper --skill design-review-nikhilsitaram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/nikhilsitaram/claude-caliper/tree/main/skills/design-review
Command: npx skills add https://github.com/nikhilsitaram/claude-caliper --skill design-review-nikhilsitaram

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill catches design gaps, inconsistencies, and missing test coverage before implementation begins, when fixes are cheapest and least disruptive.

Core Features & Use Cases

  • Pre-plan validation: Reviews a design document before draft planning is allowed to proceed.
  • Structured evaluation: Checks the doc against a 9-point checklist covering problem clarity, success criteria, architecture fit, alternatives, scope, justification, consistency, test strategy, and handoff quality.
  • Iterative review loop: Supports re-review cycles with issue triage, resolution tracking, severity-based gates, and model step-down on later iterations.
  • Use case: A feature design is written for a new API flow, and this Skill validates that the doc is complete enough for a planner to generate an accurate implementation plan.

Quick Start

Ask the AI to review the design doc at the specified path and decide whether it is ready for planning.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I validate a software design document before planning starts?

A pre-plan design review evaluates a design document against a 9-point checklist covering problem clarity, architecture fit, and test strategy to identify gaps and missing validation details before implementation begins.

What does a pre-plan design review checklist include?

A pre-plan design review checklist includes problem clarity, success criteria, architecture fit, alternatives, scope, justification, consistency, test strategy, and handoff quality to ensure complete spec validation before planning.

How do I check if my architecture design is ready for implementation planning?

Checking if an architecture design is ready for implementation planning requires a path verification process that issues a ready-for-planning verdict based on severity-ranked findings from a structured design review.

Can I run an iterative re-review loop to triage design document issues?

Yes, an iterative re-review loop supports issue triage and resolution tracking for design documents, applying severity-based gates and model step-down on later iterations to validate spec updates during feature work.

What is the best way to identify missing test strategy and coverage gaps in a feature design?

Identifying missing test strategy and coverage gaps in a feature design requires a structured design review that triages the document for inconsistencies and missing validation details before a planner generates the implementation plan.

Why do I need spec validation before generating an implementation plan?

Spec validation before generating an implementation plan catches design gaps, inconsistencies, and missing test coverage when fixes are cheapest and least disruptive, preventing inaccurate planning from proceeding on incomplete architecture.