plan-design-review

Review PLAN documents for missing design decisions and alignment with DESIGN.md.

Updated Sep 10, 2024
One-click install
npx skills add https://github.com/TioSavich/UMEDCTA --skill plan-design-review-tiosavich
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-design-review
Source: https://github.com/TioSavich/UMEDCTA/tree/main/.claude/skills/gstack/plan-design-review
Command: npx skills add https://github.com/TioSavich/UMEDCTA --skill plan-design-review-tiosavich

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This review identifies missing design decisions in a PLAN and ensures the plan clearly articulates user flows, empty states, accessibility, and design-system alignment before implementation.

Core Features & Use Cases

  • Identify gaps in information architecture, interaction states, and edge cases within PLAN documents.
  • Propose concrete design decisions and rationales to improve clarity, consistency, and usability.
  • Align plan decisions with DESIGN.md and established design principles, enabling smoother handoffs.

Quick Start

Review the current PLAN with this skill to surface missing design decisions and elevate its rigor before implementation.

Frequently Asked Questions about plan-design-review

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

FAQPage Schema
How do I identify missing UI/UX decisions in a design plan before implementation?

A design review identifies missing UI/UX decisions in a design plan by rigorously checking for gaps in interaction flows, empty states, responsive behavior, and accessibility. It documents missing decisions and proposes concrete resolutions to ensure alignment with established design principles.

What is a principle-based design review for plan documents?

A principle-based design review is a process that evaluates plan documents against established design principles and DESIGN.md. It surfaces missing design system alignments and edge cases, ensuring user flows and accessibility criteria are clearly articulated before development begins.

How do I check if my interaction flows and empty states align with my design system?

You can check interaction flows and empty states by performing a design review that evaluates the plan against your design system. This process surfaces undocumented edge cases and proposes concrete design decisions to improve clarity, consistency, and usability.

Can a design review help document missing accessibility and responsive behavior decisions?

Yes, a design review specifically targets missing accessibility and responsive behavior decisions within a plan. It documents these gaps, provides rationales for proposed resolutions, and ensures the final plan satisfies all design requirements.

What is the best way to prepare a plan document for a smooth design handoff?

The best way to prepare a plan document for handoff is to conduct a rigorous design review. This ensures the plan clearly articulates user flows, empty states, and design-system alignment, resolving missing decisions before implementation begins.

When should I not use an automated design review for my plan?

You should avoid an automated design review if your plan document lacks initial UI/UX decisions, interaction flows, or a referenced DESIGN.md file, as the review depends on existing plan structures to identify gaps and propose concrete resolutions effectively.