review-design

Review work-package design.md for implementation readiness and append a verdict.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews a work-package design.md for implementation readiness — checking that the design is implementable, APIs are fully specified, error handling covers all failure modes, and the test strategy is defined. Amends the document and appends a verdict. Use when the user mentions "review the design for {epic}", "is the WP design ready", or "check the design before the sprint". Do NOT use to review product strategy — use review-product. Do NOT use to review code — use review-code.

Core Features & Use Cases

  • Gate between Discovery and Delivery: validates that a WP design can be implemented with clear APIs, acceptance criteria, and test strategy.
  • Documentation amender: amends design.md with gaps and clarifications and appends a verdict.
  • Guidance for engineers: provides a concrete, non-siloed review path to avoid sprint-blockers.

Quick Start

Provide an end-to-end review by loading design.md, solution.md, and backlog.md, then produce an amended design.md with the verdict.

Frequently Asked Questions about review-design

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

FAQPage Schema
How do I review a work-package design for implementation readiness?

Evaluate your work-package design against implementation criteria to determine readiness for engineering. It validates that design.md contains complete specifications, fully defined APIs, error handling, and a defined test strategy before entering the delivery phase.

What is a design gatecheck between discovery and delivery?

A design gatecheck is a validation step between discovery and delivery that ensures a work-package design is implementable. It confirms the design has clear APIs, acceptance criteria, and a test strategy before engineers begin the sprint.

How do I check if my API specifications and test strategy are ready for a sprint?

Check API specifications and test strategy readiness by reviewing the design document against implementation criteria. This validates that APIs are fully specified, error handling covers all failure modes, and the test strategy is explicitly defined to avoid sprint blockers.

Can I use a design review to check product strategy and architecture solutions?

You cannot use this design review to check product strategy; use review-product instead. This review specifically evaluates work-package architecture designs for engineering implementation readiness, amending design.md with gaps and appending a formal review verdict.

When should I run a work-package design review?

Run a work-package design review during the gate between discovery and delivery, especially after writing the WP design output or when a design has been revised. It validates readiness and amends the document with a formal review summary before engineering begins.