repo-aware-ui-design-flow

Generates repository-grounded UX, wireframe, visual, and layout design artifacts from PRD context.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/jason23452/my-skill --skill repo-aware-ui-design-flow-jason23452
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-aware-ui-design-flow
Source: https://github.com/jason23452/my-skill/tree/main/flow/repo-aware-ui-design-flow
Command: npx skills add https://github.com/jason23452/my-skill --skill repo-aware-ui-design-flow-jason23452

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents frontend design documents from ignoring the actual repository by forcing every UX, wireframe, visual, and layout decision to be grounded in real routes, components, tokens, and styling evidence instead of assumptions. ## Core Features & Use Cases - Evidence-First Design Flow: Reads design-context.md, PRDs, spec.md, and actual frontend repo files before writing any design artifact, recording evidence IDs and file paths. - Structured Artifact Pipeline: Produces ux-spec.md, wireframe-spec.md, DESIGN.md, visual-design-spec.md, layout.md, screen-preview.html, and QA/review reports in a session artifact directory without polluting the product repository. - Option Gates and Quality Review: Generates three visual and three layout directions on a shared neutral frame, enforces uniqueness gates, and runs rendered browser QA plus a scored visual quality critique. - Use Case: After a PRD is approved, run this flow to produce a repo-aware design system, layout contract, and high-fidelity HTML preview that frontend planning can implement directly. ## Quick Start Use the repo-aware UI design flow to turn the approved design-context.md into UX, wireframe, visual, and layout specs plus an HTML preview grounded in this repository.

Frequently Asked Questions about repo-aware-ui-design-flow

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

FAQPage Schema
How do I create UI design specs that match my existing frontend repo?▼

Run this flow after PRD-to-product-design creates design-context.md. It inspects your routes, components, tokens, and styling files, then writes ux-spec.md, wireframe-spec.md, DESIGN.md, and layout.md grounded in that evidence.

What design artifacts does a PRD-to-frontend design flow produce?▼

It produces design-context.md, DESIGN.md, layout.md, ux-spec.md, wireframe-spec.md, visual-design-spec.md, screen-preview.html, an implementation brief, and rendered QA plus visual quality review reports, all stored in a session artifact directory.

Does this flow require an existing UI kit like shadcn or Tailwind?▼

No. It classifies the repo as existing-kit, existing-styling, partial, or none, and never claims a kit without repo evidence. If none exists, it defines project-local primitives instead.

Where are the generated design documents stored?▼

All artifacts live in the PRD session artifact directory under frontend-design/. The flow explicitly forbids creating or committing design Markdown working copies inside the product frontend repository.

Why would a design preview be rejected by the quality gate?▼

Previews are blocked if they look like documentation pages, use placeholder content, lack responsive strategy, show unsupported components, expose internal evidence IDs, or differ only by palette instead of a complete visual system.