review-design

Cross-reference setup.yaml and design artifacts to surface alignment gaps.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/NagasakaH/dev-process --skill review-design-nagasakah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-design
Source: https://github.com/NagasakaH/dev-process/tree/main/.claude/skills/development/review-design
Command: npx skills add https://github.com/NagasakaH/dev-process --skill review-design-nagasakah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill performs a systematic review of design outputs by integrating setup.yaml, design-document, dev-design, and dev-investigation to verify alignment with requirements and prior investigation results, and to update documentation accordingly.

Core Features & Use Cases

  • Gather setup.yaml inputs (ticket, target repositories) and reference the SSOT for requirements.
  • Validate that design artifacts (design-document, dev-design) reflect investigation findings and meet functional and non-functional criteria.
  • Produce structured review outputs under docs/{target_repo}/review-design/ and update the design-document review sections to ensure traceability.

Quick Start

Load setup.yaml, verify design-document and dev-design exist, then run the review-design workflow.

Frequently Asked Questions about review-design

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

FAQPage Schema
How do I validate my design document against functional and non-functional requirements?

To validate a design document against requirements, cross-reference setup.yaml, dev-design, and dev-investigation to surface alignment gaps and verify all criteria are addressed. This systematic design review ensures artifacts reflect investigation findings.

What is the best way to trace design decisions back to source requirements?

Tracing design decisions back to source requirements requires anchoring validation on the SSOT described in setup.yaml. The review process outputs structured decision summaries and updates design-document review sections to ensure full traceability.

How do I perform a design review across multiple target repositories?

Performing a design review across multiple target repositories involves loading setup.yaml inputs and applying the validation workflow to each. The process produces structured review outputs under docs/{target_repo}/review-design/ for each repository.

Do I need a setup.yaml file to automate design validation?

Yes, you need a setup.yaml file to automate design validation because it serves as the SSOT for requirements and specifies the target repositories. The validation workflow loads setup.yaml to verify design artifacts meet functional criteria.

What should I do if my dev-design artifacts don't match prior investigation findings?

If dev-design artifacts don't match prior investigation findings, run a design review to cross-reference dev-investigation and surface alignment gaps. The workflow updates the design-document review sections to ensure artifacts meet non-functional criteria.

Can I use this approach to check if non-functional requirements are addressed in my architecture?

Yes, you can use this design review approach to check if non-functional requirements are addressed in your architecture. The validation workflow verifies both functional and non-functional criteria are met by cross-referencing setup.yaml and design artifacts.