# Design Guidelines

> Project design system. Updated by the `ui-ux-designer` agent, consumed by `frontend-planner` and `frontend-developer`.
> Invoke `ui-ux-designer` to populate this document with your project's visual direction.

<!-- CONFIG: This file starts empty. Run the ui-ux-designer agent to fill it based on your brand and requirements. -->

## Visual Direction

[Style, mood, and visual references — to be defined by ui-ux-designer]

## Colors

[Primary, secondary, accent, semantic (success/error/warning/info), neutrals — exact values]

## Typography

[Font families, size scale, weights, line heights — heading and body styles]

## Spacing & Layout

[Spacing scale, grid system, max-width, breakpoints, mobile reflow strategy]

## Component Styles

[Border-radius, shadows, hover/focus/active states, transitions]

## Animations & Interactions

[Allowed types, duration ranges, easing functions, when to use vs when not to]

## States & Feedback

[Loading, error, empty, success, disabled, validation — visual patterns for each]

## Content Hierarchy

[Heading patterns, CTA tone and placement, helper text style, error message format]

## Accessibility

[Minimum contrast ratios, focus indicators, ARIA patterns, touch target sizes]

## Imagery & Icons

[Photography vs illustration vs icons, icon library, placeholder strategy]

## Constraints & Anti-Patterns

[What NOT to do — specific patterns to avoid in this project]