@maestro-ai/mcp-server 1.0.0

package/dist/content/content/design-system/data/ux-guidelines.csv

@@ -0,0 +1,100 @@
+No,Category,Issue,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Navigation,Smooth Scroll,Web,Anchor links should scroll smoothly to target section,Use scroll-behavior: smooth on html element,Jump directly without transition,html { scroll-behavior: smooth; },<a href='#section'> without CSS,High
+2,Navigation,Sticky Navigation,Web,Fixed nav should not obscure content,Add padding-top to body equal to nav height,Let nav overlap first section content,pt-20 (if nav is h-20),No padding compensation,Medium
+3,Navigation,Active State,All,Current page/section should be visually indicated,Highlight active nav item with color/underline,No visual feedback on current location,text-primary border-b-2,All links same style,Medium
+4,Navigation,Back Button,Mobile,Users expect back to work predictably,Preserve navigation history properly,Break browser/app back button behavior,history.pushState(),location.replace(),High
+5,Navigation,Deep Linking,All,URLs should reflect current state for sharing,Update URL on state/view changes,Static URLs for dynamic content,Use query params or hash,Single URL for all states,Medium
+6,Navigation,Breadcrumbs,Web,Show user location in site hierarchy,Use for sites with 3+ levels of depth,Use for flat single-level sites,Home > Category > Product,Only on deep nested pages,Low
+7,Animation,Excessive Motion,All,Too many animations cause distraction and motion sickness,Animate 1-2 key elements per view maximum,Animate everything that moves,Single hero animation,animate-bounce on 5+ elements,High
+8,Animation,Duration Timing,All,Animations should feel responsive not sluggish,Use 150-300ms for micro-interactions,Use animations longer than 500ms for UI,transition-all duration-200,duration-1000,Medium
+9,Animation,Reduced Motion,All,Respect user's motion preferences,Check prefers-reduced-motion media query,Ignore accessibility motion settings,@media (prefers-reduced-motion: reduce),No motion query check,High
+10,Animation,Loading States,All,Show feedback during async operations,Use skeleton screens or spinners,Leave UI frozen with no feedback,animate-pulse skeleton,Blank screen while loading,High
+11,Animation,Hover vs Tap,All,Hover effects don't work on touch devices,Use click/tap for primary interactions,Rely only on hover for important actions,onClick handler,onMouseEnter only,High
+12,Animation,Continuous Animation,All,Infinite animations are distracting,Use for loading indicators only,Use for decorative elements,animate-spin on loader,animate-bounce on icons,Medium
+13,Animation,Transform Performance,Web,Some CSS properties trigger expensive repaints,Use transform and opacity for animations,Animate width/height/top/left properties,transform: translateY(),top: 10px animation,Medium
+14,Animation,Easing Functions,All,Linear motion feels robotic,Use ease-out for entering ease-in for exiting,Use linear for UI transitions,ease-out,linear,Low
+15,Layout,Z-Index Management,Web,Stacking context conflicts cause hidden elements,Define z-index scale system (10 20 30 50),Use arbitrary large z-index values,z-10 z-20 z-50,z-[9999],High
+16,Layout,Overflow Hidden,Web,Hidden overflow can clip important content,Test all content fits within containers,Blindly apply overflow-hidden,overflow-auto with scroll,overflow-hidden truncating content,Medium
+17,Layout,Fixed Positioning,Web,Fixed elements can overlap or be inaccessible,Account for safe areas and other fixed elements,Stack multiple fixed elements carelessly,Fixed nav + fixed bottom with gap,Multiple overlapping fixed elements,Medium
+18,Layout,Stacking Context,Web,New stacking contexts reset z-index,Understand what creates new stacking context,Expect z-index to work across contexts,Parent with z-index isolates children,z-index: 9999 not working,Medium
+19,Layout,Content Jumping,Web,Layout shift when content loads is jarring,Reserve space for async content,Let images/content push layout around,aspect-ratio or fixed height,No dimensions on images,High
+20,Layout,Viewport Units,Web,100vh can be problematic on mobile browsers,Use dvh or account for mobile browser chrome,Use 100vh for full-screen mobile layouts,min-h-dvh or min-h-screen,h-screen on mobile,Medium
+21,Layout,Container Width,Web,Content too wide is hard to read,Limit max-width for text content (65-75ch),Let text span full viewport width,max-w-prose or max-w-3xl,Full width paragraphs,Medium
+22,Touch,Touch Target Size,Mobile,Small buttons are hard to tap accurately,Minimum 44x44px touch targets,Tiny clickable areas,min-h-[44px] min-w-[44px],w-6 h-6 buttons,High
+23,Touch,Touch Spacing,Mobile,Adjacent touch targets need adequate spacing,Minimum 8px gap between touch targets,Tightly packed clickable elements,gap-2 between buttons,gap-0 or gap-1,Medium
+24,Touch,Gesture Conflicts,Mobile,Custom gestures can conflict with system,Avoid horizontal swipe on main content,Override system gestures,Vertical scroll primary,Horizontal swipe carousel only,Medium
+25,Touch,Tap Delay,Mobile,300ms tap delay feels laggy,Use touch-action CSS or fastclick,Default mobile tap handling,touch-action: manipulation,No touch optimization,Medium
+26,Touch,Pull to Refresh,Mobile,Accidental refresh is frustrating,Disable where not needed,Enable by default everywhere,overscroll-behavior: contain,Default overscroll,Low
+27,Touch,Haptic Feedback,Mobile,Tactile feedback improves interaction feel,Use for confirmations and important actions,Overuse vibration feedback,navigator.vibrate(10),Vibrate on every tap,Low
+28,Interaction,Focus States,All,Keyboard users need visible focus indicators,Use visible focus rings on interactive elements,Remove focus outline without replacement,focus:ring-2 focus:ring-blue-500,outline-none without alternative,High
+29,Interaction,Hover States,Web,Visual feedback on interactive elements,Change cursor and add subtle visual change,No hover feedback on clickable elements,hover:bg-gray-100 cursor-pointer,No hover style,Medium
+30,Interaction,Active States,All,Show immediate feedback on press/click,Add pressed/active state visual change,No feedback during interaction,active:scale-95,No active state,Medium
+31,Interaction,Disabled States,All,Clearly indicate non-interactive elements,Reduce opacity and change cursor,Confuse disabled with normal state,opacity-50 cursor-not-allowed,Same style as enabled,Medium
+32,Interaction,Loading Buttons,All,Prevent double submission during async actions,Disable button and show loading state,Allow multiple clicks during processing,disabled={loading} spinner,Button clickable while loading,High
+33,Interaction,Error Feedback,All,Users need to know when something fails,Show clear error messages near problem,Silent failures with no feedback,Red border + error message,No indication of error,High
+34,Interaction,Success Feedback,All,Confirm successful actions to users,Show success message or visual change,No confirmation of completed action,Toast notification or checkmark,Action completes silently,Medium
+35,Interaction,Confirmation Dialogs,All,Prevent accidental destructive actions,Confirm before delete/irreversible actions,Delete without confirmation,Are you sure modal,Direct delete on click,High
+36,Accessibility,Color Contrast,All,Text must be readable against background,Minimum 4.5:1 ratio for normal text,Low contrast text,#333 on white (7:1),#999 on white (2.8:1),High
+37,Accessibility,Color Only,All,Don't convey information by color alone,Use icons/text in addition to color,Red/green only for error/success,Red text + error icon,Red border only for error,High
+38,Accessibility,Alt Text,All,Images need text alternatives,Descriptive alt text for meaningful images,Empty or missing alt attributes,alt='Dog playing in park',alt='' for content images,High
+39,Accessibility,Heading Hierarchy,Web,Screen readers use headings for navigation,Use sequential heading levels h1-h6,Skip heading levels or misuse for styling,h1 then h2 then h3,h1 then h4,Medium
+40,Accessibility,ARIA Labels,All,Interactive elements need accessible names,Add aria-label for icon-only buttons,Icon buttons without labels,aria-label='Close menu',<button><Icon/></button>,High
+41,Accessibility,Keyboard Navigation,Web,All functionality accessible via keyboard,Tab order matches visual order,Keyboard traps or illogical tab order,tabIndex for custom order,Unreachable elements,High
+42,Accessibility,Screen Reader,All,Content should make sense when read aloud,Use semantic HTML and ARIA properly,Div soup with no semantics,<nav> <main> <article>,<div> for everything,Medium
+43,Accessibility,Form Labels,All,Inputs must have associated labels,Use label with for attribute or wrap input,Placeholder-only inputs,<label for='email'>,placeholder='Email' only,High
+44,Accessibility,Error Messages,All,Error messages must be announced,Use aria-live or role=alert for errors,Visual-only error indication,role='alert',Red border only,High
+45,Accessibility,Skip Links,Web,Allow keyboard users to skip navigation,Provide skip to main content link,No skip link on nav-heavy pages,Skip to main content link,100 tabs to reach content,Medium
+46,Performance,Image Optimization,All,Large images slow page load,Use appropriate size and format (WebP),Unoptimized full-size images,srcset with multiple sizes,4000px image for 400px display,High
+47,Performance,Lazy Loading,All,Load content as needed,Lazy load below-fold images and content,Load everything upfront,loading='lazy',All images eager load,Medium
+48,Performance,Code Splitting,Web,Large bundles slow initial load,Split code by route/feature,Single large bundle,dynamic import(),All code in main bundle,Medium
+49,Performance,Caching,Web,Repeat visits should be fast,Set appropriate cache headers,No caching strategy,Cache-Control headers,Every request hits server,Medium
+50,Performance,Font Loading,Web,Web fonts can block rendering,Use font-display swap or optional,Invisible text during font load,font-display: swap,FOIT (Flash of Invisible Text),Medium
+51,Performance,Third Party Scripts,Web,External scripts can block rendering,Load non-critical scripts async/defer,Synchronous third-party scripts,async or defer attribute,<script src='...'> in head,Medium
+52,Performance,Bundle Size,Web,Large JavaScript slows interaction,Monitor and minimize bundle size,Ignore bundle size growth,Bundle analyzer,No size monitoring,Medium
+53,Performance,Render Blocking,Web,CSS/JS can block first paint,Inline critical CSS defer non-critical,Large blocking CSS files,Critical CSS inline,All CSS in head,Medium
+54,Forms,Input Labels,All,Every input needs a visible label,Always show label above or beside input,Placeholder as only label,<label>Email</label><input>,placeholder='Email' only,High
+55,Forms,Error Placement,All,Errors should appear near the problem,Show error below related input,Single error message at top of form,Error under each field,All errors at form top,Medium
+56,Forms,Inline Validation,All,Validate as user types or on blur,Validate on blur for most fields,Validate only on submit,onBlur validation,Submit-only validation,Medium
+57,Forms,Input Types,All,Use appropriate input types,Use email tel number url etc,Text input for everything,type='email',type='text' for email,Medium
+58,Forms,Autofill Support,Web,Help browsers autofill correctly,Use autocomplete attribute properly,Block or ignore autofill,autocomplete='email',autocomplete='off' everywhere,Medium
+59,Forms,Required Indicators,All,Mark required fields clearly,Use asterisk or (required) text,No indication of required fields,* required indicator,Guess which are required,Medium
+60,Forms,Password Visibility,All,Let users see password while typing,Toggle to show/hide password,No visibility toggle,Show/hide password button,Password always hidden,Medium
+61,Forms,Submit Feedback,All,Confirm form submission status,Show loading then success/error state,No feedback after submit,Loading -> Success message,Button click with no response,High
+62,Forms,Input Affordance,All,Inputs should look interactive,Use distinct input styling,Inputs that look like plain text,Border/background on inputs,Borderless inputs,Medium
+63,Forms,Mobile Keyboards,Mobile,Show appropriate keyboard for input type,Use inputmode attribute,Default keyboard for all inputs,inputmode='numeric',Text keyboard for numbers,Medium
+64,Responsive,Mobile First,Web,Design for mobile then enhance for larger,Start with mobile styles then add breakpoints,Desktop-first causing mobile issues,Default mobile + md: lg: xl:,Desktop default + max-width queries,Medium
+65,Responsive,Breakpoint Testing,Web,Test at all common screen sizes,Test at 320 375 414 768 1024 1440,Only test on your device,Multiple device testing,Single device development,Medium
+66,Responsive,Touch Friendly,Web,Mobile layouts need touch-sized targets,Increase touch targets on mobile,Same tiny buttons on mobile,Larger buttons on mobile,Desktop-sized targets on mobile,High
+67,Responsive,Readable Font Size,All,Text must be readable on all devices,Minimum 16px body text on mobile,Tiny text on mobile,text-base or larger,text-xs for body text,High
+68,Responsive,Viewport Meta,Web,Set viewport for mobile devices,Use width=device-width initial-scale=1,Missing or incorrect viewport,<meta name='viewport'...>,No viewport meta tag,High
+69,Responsive,Horizontal Scroll,Web,Avoid horizontal scrolling,Ensure content fits viewport width,Content wider than viewport,max-w-full overflow-x-hidden,Horizontal scrollbar on mobile,High
+70,Responsive,Image Scaling,Web,Images should scale with container,Use max-width: 100% on images,Fixed width images overflow,max-w-full h-auto,width='800' fixed,Medium
+71,Responsive,Table Handling,Web,Tables can overflow on mobile,Use horizontal scroll or card layout,Wide tables breaking layout,overflow-x-auto wrapper,Table overflows viewport,Medium
+72,Typography,Line Height,All,Adequate line height improves readability,Use 1.5-1.75 for body text,Cramped or excessive line height,leading-relaxed (1.625),leading-none (1),Medium
+73,Typography,Line Length,Web,Long lines are hard to read,Limit to 65-75 characters per line,Full-width text on large screens,max-w-prose,Full viewport width text,Medium
+74,Typography,Font Size Scale,All,Consistent type hierarchy aids scanning,Use consistent modular scale,Random font sizes,Type scale (12 14 16 18 24 32),Arbitrary sizes,Medium
+75,Typography,Font Loading,Web,Fonts should load without layout shift,Reserve space with fallback font,Layout shift when fonts load,font-display: swap + similar fallback,No fallback font,Medium
+76,Typography,Contrast Readability,All,Body text needs good contrast,Use darker text on light backgrounds,Gray text on gray background,text-gray-900 on white,text-gray-400 on gray-100,High
+77,Typography,Heading Clarity,All,Headings should stand out from body,Clear size/weight difference,Headings similar to body text,Bold + larger size,Same size as body,Medium
+78,Feedback,Loading Indicators,All,Show system status during waits,Show spinner/skeleton for operations > 300ms,No feedback during loading,Skeleton or spinner,Frozen UI,High
+79,Feedback,Empty States,All,Guide users when no content exists,Show helpful message and action,Blank empty screens,No items yet. Create one!,Empty white space,Medium
+80,Feedback,Error Recovery,All,Help users recover from errors,Provide clear next steps,Error without recovery path,Try again button + help link,Error message only,Medium
+81,Feedback,Progress Indicators,All,Show progress for multi-step processes,Step indicators or progress bar,No indication of progress,Step 2 of 4 indicator,No step information,Medium
+82,Feedback,Toast Notifications,All,Transient messages for non-critical info,Auto-dismiss after 3-5 seconds,Toasts that never disappear,Auto-dismiss toast,Persistent toast,Medium
+83,Feedback,Confirmation Messages,All,Confirm successful actions,Brief success message,Silent success,Saved successfully toast,No confirmation,Medium
+84,Content,Truncation,All,Handle long content gracefully,Truncate with ellipsis and expand option,Overflow or broken layout,line-clamp-2 with expand,Overflow or cut off,Medium
+85,Content,Date Formatting,All,Use locale-appropriate date formats,Use relative or locale-aware dates,Ambiguous date formats,2 hours ago or locale format,01/02/03,Low
+86,Content,Number Formatting,All,Format large numbers for readability,Use thousand separators or abbreviations,Long unformatted numbers,"1.2K or 1,234",1234567,Low
+87,Content,Placeholder Content,All,Show realistic placeholders during dev,Use realistic sample data,Lorem ipsum everywhere,Real sample content,Lorem ipsum,Low
+88,Onboarding,User Freedom,All,Users should be able to skip tutorials,Provide Skip and Back buttons,Force linear unskippable tour,Skip Tutorial button,Locked overlay until finished,Medium
+89,Search,Autocomplete,Web,Help users find results faster,Show predictions as user types,Require full type and enter,Debounced fetch + dropdown,No suggestions,Medium
+90,Search,No Results,Web,Dead ends frustrate users,Show 'No results' with suggestions,Blank screen or '0 results',Try searching for X instead,No results found.,Medium
+91,Data Entry,Bulk Actions,Web,Editing one by one is tedious,Allow multi-select and bulk edit,Single row actions only,Checkbox column + Action bar,Repeated actions per row,Low
+92,AI Interaction,Disclaimer,All,Users need to know they talk to AI,Clearly label AI generated content,Present AI as human,AI Assistant label,Fake human name without label,High
+93,AI Interaction,Streaming,All,Waiting for full text is slow,Stream text response token by token,Show loading spinner for 10s+,Typewriter effect,Spinner until 100% complete,Medium
+94,Spatial UI,Gaze Hover,VisionOS,Elements should respond to eye tracking before pinch,Scale/highlight element on look,Static element until pinch,hoverEffect(),onTap only,High
+95,Spatial UI,Depth Layering,VisionOS,UI needs Z-depth to separate content from environment,Use glass material and z-offset,Flat opaque panels blocking view,.glassBackgroundEffect(),bg-white,Medium
+96,Sustainability,Auto-Play Video,Web,Video consumes massive data and energy,Click-to-play or pause when off-screen,Auto-play high-res video loops,playsInline muted preload='none',autoplay loop,Medium
+97,Sustainability,Asset Weight,Web,Heavy 3D/Image assets increase carbon footprint,Compress and lazy load 3D models,Load 50MB textures,Draco compression,Raw .obj files,Medium
+98,AI Interaction,Feedback Loop,All,AI needs user feedback to improve,Thumps up/down or 'Regenerate',Static output only,Feedback component,Read-only text,Low
+99,Accessibility,Motion Sensitivity,All,Parallax/Scroll-jacking causes nausea,Respect prefers-reduced-motion,Force scroll effects,@media (prefers-reduced-motion),ScrollTrigger.create(),High

package/dist/content/content/design-system/data/web-interface.csv

@@ -0,0 +1,31 @@
+No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Accessibility,Icon Button Labels,icon button aria-label,Web,Icon-only buttons must have accessible names,Add aria-label to icon buttons,Icon button without label,"<button aria-label='Close'><XIcon /></button>","<button><XIcon /></button>",Critical
+2,Accessibility,Form Control Labels,form input label aria,Web,All form controls need labels or aria-label,Use label element or aria-label,Input without accessible name,"<label for='email'>Email</label><input id='email' />","<input placeholder='Email' />",Critical
+3,Accessibility,Keyboard Handlers,keyboard onclick onkeydown,Web,Interactive elements must support keyboard interaction,Add onKeyDown alongside onClick,Click-only interaction,"<div onClick={fn} onKeyDown={fn} tabIndex={0}>","<div onClick={fn}>",High
+4,Accessibility,Semantic HTML,semantic button a label,Web,Use semantic HTML before ARIA attributes,Use button/a/label elements,Div with role attribute,"<button onClick={fn}>Submit</button>","<div role='button' onClick={fn}>Submit</div>",High
+5,Accessibility,Aria Live,aria-live polite async,Web,Async updates need aria-live for screen readers,Add aria-live='polite' for dynamic content,Silent async updates,"<div aria-live='polite'>{status}</div>","<div>{status}</div> // no announcement",Medium
+6,Accessibility,Decorative Icons,aria-hidden decorative icon,Web,Decorative icons should be hidden from screen readers,Add aria-hidden='true' to decorative icons,Decorative icon announced,"<Icon aria-hidden='true' />","<Icon /> // announced as 'image'",Medium
+7,Focus,Visible Focus States,focus-visible outline ring,Web,All interactive elements need visible focus states,Use :focus-visible with ring/outline,No focus indication,"focus-visible:ring-2 focus-visible:ring-blue-500","outline-none // no replacement",Critical
+8,Focus,Never Remove Outline,outline-none focus replacement,Web,Never remove outline without providing replacement,Replace outline with visible alternative,Remove outline completely,"focus:outline-none focus:ring-2","focus:outline-none // nothing else",Critical
+9,Focus,Checkbox Radio Hit Target,checkbox radio label target,Web,Checkbox/radio must share hit target with label,Wrap input and label together,Separate tiny checkbox,"<label class='flex gap-2'><input type='checkbox' /><span>Option</span></label>","<input type='checkbox' id='x' /><label for='x'>Option</label>",Medium
+10,Forms,Autocomplete Attribute,autocomplete input form,Web,Inputs need autocomplete attribute for autofill,Add appropriate autocomplete value,Missing autocomplete,"<input autocomplete='email' type='email' />","<input type='email' />",High
+11,Forms,Semantic Input Types,input type email tel url,Web,Use semantic input type attributes,Use email/tel/url/number types,text type for everything,"<input type='email' />","<input type='text' /> // for email",Medium
+12,Forms,Never Block Paste,paste onpaste password,Web,Never prevent paste functionality,Allow paste on all inputs,Block paste on password/code,"<input type='password' />","<input onPaste={e => e.preventDefault()} />",High
+13,Forms,Spellcheck Disable,spellcheck email code,Web,Disable spellcheck on emails and codes,Set spellcheck='false' on codes,Spellcheck on technical input,"<input spellCheck='false' type='email' />","<input type='email' /> // red squiggles",Low
+14,Forms,Submit Button Enabled,submit button disabled loading,Web,Keep submit enabled and show spinner during requests,Show loading spinner keep enabled,Disable button during submit,"<button>{loading ? <Spinner /> : 'Submit'}</button>","<button disabled={loading}>Submit</button>",Medium
+15,Forms,Inline Errors,error message inline focus,Web,Show error messages inline near the problem field,Inline error with focus on first error,Single error at top,"<input /><span class='text-red-500'>{error}</span>","<div class='error'>{allErrors}</div> // at top",High
+16,Performance,Virtualize Lists,virtualize list 50 items,Web,Virtualize lists exceeding 50 items,Use virtual list for large datasets,Render all items,"<VirtualList items={items} />","items.map(item => <Item />)",High
+17,Performance,Avoid Layout Reads,layout read render getboundingclientrect,Web,Avoid layout reads during render phase,Read layout in effects or callbacks,getBoundingClientRect in render,"useEffect(() => { el.getBoundingClientRect() })","const rect = el.getBoundingClientRect() // in render",Medium
+18,Performance,Batch DOM Operations,batch dom write read,Web,Group DOM operations to minimize reflows,Batch writes then reads,Interleave reads and writes,"writes.forEach(w => w()); reads.forEach(r => r())","write(); read(); write(); read(); // thrashing",Medium
+19,Performance,Preconnect CDN,preconnect link cdn,Web,Add preconnect links for CDN domains,Preconnect to known domains,"<link rel='preconnect' href='https://cdn.example.com' />","// no preconnect hint",Low
+20,Performance,Lazy Load Images,lazy loading image below-fold,Web,Lazy-load images below the fold,Use loading='lazy' for below-fold images,Load all images eagerly,"<img loading='lazy' src='...' />","<img src='...' /> // above fold only",Medium
+21,State,URL Reflects State,url state query params,Web,URL should reflect current UI state,Sync filters/tabs/pagination to URL,State only in memory,"?tab=settings&page=2","useState only // lost on refresh",High
+22,State,Deep Linking,deep link stateful component,Web,Stateful components should support deep-linking,Enable sharing current view via URL,No shareable state,"router.push({ query: { ...filters } })","setFilters(f) // not in URL",Medium
+23,State,Confirm Destructive Actions,confirm destructive delete modal,Web,Destructive actions require confirmation,Show confirmation dialog before delete,Delete without confirmation,"if (confirm('Delete?')) delete()","onClick={delete} // no confirmation",High
+24,Typography,Proper Unicode,unicode ellipsis quotes,Web,Use proper Unicode characters,Use ... curly quotes proper dashes,ASCII approximations,"'Hello...' with proper ellipsis","'Hello...' with three dots",Low
+25,Typography,Text Overflow,truncate line-clamp overflow,Web,Handle text overflow properly,Use truncate/line-clamp/break-words,Text overflows container,"<p class='truncate'>Long text...</p>","<p>Long text...</p> // overflows",Medium
+26,Typography,Non-Breaking Spaces,nbsp unit brand,Web,Use non-breaking spaces for units and brand names,Use &nbsp; between number and unit,"10&nbsp;kg or Next.js&nbsp;14","10 kg // may wrap",Low
+27,Anti-Pattern,No Zoom Disable,viewport zoom disable,Web,Never disable zoom in viewport meta,Allow user zoom,"<meta name='viewport' content='width=device-width'>","<meta name='viewport' content='maximum-scale=1'>",Critical
+28,Anti-Pattern,No Transition All,transition all specific,Web,Avoid transition: all - specify properties,Transition specific properties,transition: all,"transition-colors duration-200","transition-all duration-200",Medium
+29,Anti-Pattern,Outline Replacement,outline-none ring focus,Web,Never use outline-none without replacement,Provide visible focus replacement,Remove outline with nothing,"focus:outline-none focus:ring-2 focus:ring-blue-500","focus:outline-none // alone",Critical
+30,Anti-Pattern,No Hardcoded Dates,date format intl locale,Web,Use Intl for date/number formatting,Use Intl.DateTimeFormat,Hardcoded date format,"new Intl.DateTimeFormat('en').format(date)","date.toLocaleDateString() // or manual format",Medium

package/dist/content/content/design-system/indexes/README.md

@@ -0,0 +1,211 @@
+# Design System Database
+
+Database extenso de design para uso pelos Especialistas MCP.
+
+## 📊 Recursos Disponíveis
+
+| Database | Registros | Arquivo | Descrição |
+|----------|-----------|---------|-----------|
+| **Colors** | 96 paletas | `data/colors.csv` | Paletas por tipo de produto (SaaS, E-commerce, Fintech, Healthcare, etc) |
+| **Typography** | 57 pares | `data/typography.csv` | Combinações de fontes Google Fonts |
+| **Styles** | 58 estilos | `data/styles.csv` | Estilos UI completos (Minimalism, Glassmorphism, Brutalism, etc) |
+| **Products** | - | `data/products.csv` | Recomendações de design por tipo de produto |
+| **Landing** | - | `data/landing.csv` | Padrões de landing page |
+| **UX Guidelines** | 99+ | `data/ux-guidelines.csv` | Best practices UX |
+| **UI Reasoning** | - | `data/ui-reasoning.csv` | Regras de design reasoning |
+| **Charts** | 25 tipos | `data/charts.csv` | Tipos de gráficos e visualizações |
+| **Icons** | - | `data/icons.csv` | Diretrizes de ícones |
+| **Web Interface** | - | `data/web-interface.csv` | Guidelines para interfaces web |
+| **React Performance** | - | `data/react-performance.csv` | Performance React/Next.js |
+| **Prompts** | - | `data/prompts.csv` | Prompts prontos para Google Stitch |
+
+## 🗂️ Estrutura
+
+```
+design-system/
+├── README.md (este arquivo)
+├── data/           # CSVs originais (source of truth)
+└── indexes/        # Índices Markdown navegáveis
+```
+
+## 🔍 Como Usar (Para Especialistas MCP)
+
+### Método 1: Consultar Índice
+
+Índices organizados por categoria para navegação rápida:
+
+- **[Cores por Tipo de Produto](indexes/colors-index.md)** - SaaS, E-commerce, Fintech, Healthcare, etc
+- **[Tipografia por Mood](indexes/typography-index.md)** - Elegant, Modern, Playful, Professional
+- **[Estilos UI](indexes/styles-index.md)** - Minimalism, Glassmorphism, Dark Mode, etc
+- **[Busca Rápida](indexes/quick-search.md)** - Guia de busca por keywords
+
+### Método 2: Ler CSV Diretamente
+
+Para busca mais específica, ler CSV diretamente:
+
+```markdown
+# Abrir arquivo
+content/design-system/data/colors.csv
+
+# Buscar por keywords na coluna "Keywords"
+# Exemplo: "fintech" → Encontra linha 16
+# Exemplo: "healthcare" → Encontra linhas 9, 24, 61, 62
+
+# Extrair informações das colunas
+```
+
+## 📖 Campos dos CSVs
+
+### colors.csv
+- **No** - Número da paleta
+- **Product Type** - Tipo de produto
+- **Keywords** - Palavras-chave para busca
+- **Primary (Hex)** - Cor primária
+- **Secondary (Hex)** - Cor secundária
+- **CTA (Hex)** - Cor de Call-to-Action
+- **Background (Hex)** - Cor de fundo
+- **Text (Hex)** - Cor de texto
+- **Border (Hex)** - Cor de bordas
+- **Notes** - Notas e contexto
+
+### typography.csv
+- **STT** - Número do par
+- **Font Pairing Name** - Nome da combinação
+- **Category** - Categoria (Serif+Sans, Sans+Sans, etc)
+- **Heading Font** - Fonte para títulos
+- **Body Font** - Fonte para corpo de texto
+- **Mood/Style Keywords** - Keywords de mood
+- **Best For** - Quando usar
+- **Google Fonts URL** - Link para Google Fonts
+- **CSS Import** - CSS de importação
+- **Tailwind Config** - Configuração Tailwind
+- **Notes** - Notas adicionais
+
+### styles.csv
+- **STT** - Número do estilo
+- **Style Category** - Nome do estilo
+- **Type** - Tipo (General, Landing Page, BI/Analytics)
+- **Keywords** - Palavras-chave
+- **Primary Colors** - Cores primárias
+- **Secondary Colors** - Cores secundárias
+- **Effects & Animation** - Efeitos e animações
+- **Best For** - Quando usar
+- **Do Not Use For** - Quando NÃO usar
+- **Light Mode ✓** - Suporte light mode
+- **Dark Mode ✓** - Suporte dark mode
+- **Performance** - Performance
+- **Accessibility** - Acessibilidade
+- **Mobile-Friendly** - Mobile-friendly
+- **Conversion-Focused** - Foco em conversão
+- **Framework Compatibility** - Compatibilidade frameworks
+- **Era/Origin** - Origem/era do estilo
+- **Complexity** - Complexidade (Low, Medium, High)
+
+## 🎯 Exemplos de Uso
+
+### Exemplo 1: Buscar Paleta para SaaS Moderno
+
+```markdown
+1. Abrir: indexes/colors-index.md
+2. Procurar: Seção "💼 SaaS"
+3. Resultado: 
+   - SaaS General (#2563EB primary)
+   - Micro SaaS (#2563EB primary)
+   - Productivity Tool (#3B82F6 primary)
+4. Escolher e usar no Design Doc
+```
+
+**OU busca direta:**
+```csv
+1. Abrir: data/colors.csv
+2. Buscar: "saas, general"
+3. Linha 2: #2563EB, #3B82F6, #F97316
+```
+
+### Exemplo 2: Buscar Fonte Elegante para Beauty/Spa
+
+```markdown
+1. Abrir: indexes/typography-index.md
+2. Procurar: Seção "💅 Elegant/Luxury"
+3. Resultado:
+   - Classic Elegant (Playfair Display + Inter)
+   - Luxury Serif (Cormorant + Montserrat)
+4. Ver detalhes no CSV para CSS import
+```
+
+### Exemplo 3: Buscar Estilo Dark Mode
+
+```markdown
+1. Abrir: indexes/styles-index.md
+2. Procurar: "Dark Mode"
+3. Resultado: Linha 8 - Dark Mode (OLED)
+   - Colors: Deep Black #000000, Dark Grey #121212
+   - Effects: Minimal glow, dark-to-light transitions
+   - Best For: Night-mode apps, OLED devices
+```
+
+## ⚠️ Regras e Validações
+
+### Purple Ban (Importante!)
+
+**Regra MCP:** Evitar roxo/violeta como cor principal
+
+Após buscar no database, **sempre verificar**:
+```markdown
+Se paleta contém roxo (#[A-F0-9]*[4-9A-F][A-F0-9]{3}):
+  → Alertar usuário
+  → Sugerir alternativa
+  → Só usar SE usuário solicitar explicitamente
+```
+
+### Validação com Usuário
+
+Database é **sugestão inicial**, não imposição:
+1. Apresentar 2-3 opções do database
+2. Perguntar: "Essa paleta/fonte faz sentido para o projeto?"
+3. Aguardar confirmação explícita
+4. Permitir ajustes manuais
+
+### Consistência
+
+- CSVs são **source of truth**
+- Índices podem estar desatualizados em caso de modificações
+- Sempre preferir CSV em caso de dúvida
+
+## 📚 Índices Disponíveis
+
+- **[00-overview.md](indexes/00-overview.md)** - Visão geral do database
+- **[colors-index.md](indexes/colors-index.md)** - Paletas organizadas por tipo
+- **[typography-index.md](indexes/typography-index.md)** - Fontes organizadas por mood
+- **[styles-index.md](indexes/styles-index.md)** - Estilos UI categorizados
+- **[quick-search.md](indexes/quick-search.md)** - Guia rápido de busca
+
+## 🔗 Uso pelos Especialistas
+
+### Especialista em UX Design
+
+Durante perguntas de estilo:
+1. Coletar: tipo de produto, indústria, estilo desejado
+2. Buscar no database por keywords
+3. Apresentar opções ao usuário
+4. Incorporar escolha no Design Doc
+
+### Especialista em Prototipagem Stitch
+
+Ao gerar prompts:
+1. Ler Design Doc (`docs/03-ux/design-doc.md`)
+2. Extrair cores e fontes definidas
+3. Se incompleto, buscar no database
+4. Gerar prompts enriquecidos para Stitch
+
+## 📌 Notas
+
+- **Localização anterior:** `.agent/.shared/ui-ux-pro-max/data/`
+- **Data da migração:** 2026-01-23
+- **Formato:** CSVs preservados + índices MD criados
+- **Manutenção:** Atualizar CSV → re-gerar índices
+
+---
+
+**Versão:** 1.0.0  
+**Última atualização:** 2026-01-23

package/dist/content/content/design-system/indexes/colors-index.md

@@ -0,0 +1,156 @@
+# Índice de Paletas de Cores
+
+Navegue por categoria ou busque no CSV completo: [`../data/colors.csv`](../data/colors.csv)
+
+---
+
+## 🔍 Busca Rápida
+
+**CSV Completo:** 96 paletas disponíveis
+
+**Como buscar:**
+1. Identifique o tipo de produto (SaaS, E-commerce, Fintech, etc)
+2. Procure a categoria abaixo
+3. Veja as paletas sugeridas com cores primárias
+4. Consulte linha no CSV para detalhes completos
+
+---
+
+## Por Tipo de Produto
+
+### 💼 SaaS & Produtividade
+
+| # | Nome | Primary | Secondary | CTA | Keywords |
+|---|------|---------|-----------|-----|----------|
+| 1 | SaaS (General) | #2563EB | #3B82F6 | #F97316 | saas, general |
+| 2 | Micro SaaS | #2563EB | #3B82F6 | #F97316 | micro, saas |
+| 17 | Productivity Tool | #3B82F6 | #60A5FA | #F97316 | productivity, tool |
+| 18 | Design System/Component Library | #3B82F6 | #60A5FA | #F97316 | design, system, component |
+| 23 | Remote Work/Collaboration Tool | #3B82F6 | #60A5FA | #F97316 | remote, work, collaboration |
+
+### 🛒 E-commerce & Marketplace
+
+| # | Nome | Primary | Secondary | CTA | Keywords |
+|---|------|---------|-----------|-----|----------|
+| 3 | E-commerce | #3B82F6 | #60A5FA | #F97316 | commerce |
+| 4 | E-commerce Luxury | #1C1917 | #44403C | #CA8A04 | commerce, luxury |
+| 28 | Subscription Box Service | #3B82F6 | #60A5FA | #F97316 | subscription, box |
+| 50 | Marketplace (P2P) | #3B82F6 | #60A5FA | #F97316 | marketplace, p2p |
+
+### 💰 Fintech & Finance
+
+| # | Nome | Primary | Secondary | CTA | Keywords |
+|---|------|---------|-----------|-----|----------|
+| 7 | Financial Dashboard | #3B82F6 | #60A5FA | #F97316 | financial, dashboard |
+| 15 | Fintech/Crypto | #F59E0B | #FBBF24 | #8B5CF6 | fintech, crypto |
+| 20 | NFT/Web3 Platform | #3B82F6 | #60A5FA | #F97316 | nft, web3, platform |
+| 44 | Banking/Traditional Finance | #0F766E | #14B8A6 | #0369A1 | banking, traditional |
+| 43 | Insurance Platform | #3B82F6 | #60A5FA | #F97316 | insurance, platform |
+
+### 🏥 Healthcare & Wellness
+
+| # | Nome | Primary | Secondary | CTA | Keywords |
+|---|------|---------|-----------|-----|----------|
+| 9 | Healthcare App | #0891B2 | #22D3EE | #059669 | healthcare, app |
+| 24 | Mental Health App | #3B82F6 | #60A5FA | #F97316 | mental, health |
+| 34 | Beauty/Spa/Wellness Service | #10B981 | #34D399 | #8B5CF6 | beauty, spa, wellness |
+| 37 | Fitness/Gym App | #DC2626 | #F87171 | #16A34A | fitness, gym |
+| 60 | Senior Care/Elderly | #3B82F6 | #60A5FA | #F97316 | senior, care, elderly |
+
+### 🎓 Education & Learning
+
+| # | Nome | Primary | Secondary | CTA | Keywords |
+|---|------|---------|-----------|-----|----------|
+| 10 | Educational App | #4F46E5 | #818CF8 | #F97316 | educational, app |
+| 45 | Online Course/E-learning | #0D9488 | #2DD4BF | #EA580C | online, course, learning |
+| 84 | Language Learning App | #0D9488 | #2DD4BF | #EA580C | language, learning |
+| 85 | Coding Bootcamp | #3B82F6 | #60A5FA | #F97316 | coding, bootcamp |
+
+### 🎨 Creative & Entertainment
+
+| # | Nome | Primary | Secondary | CTA | Keywords |
+|---|------|---------|-----------|-----|----------|
+| 11 | Creative Agency | #EC4899 | #F472B6 | #06B6D4 | creative, agency |
+| 12 | Portfolio/Personal | #18181B | #3F3F46 | #2563EB | portfolio, personal |
+| 13 | Gaming | #7C3AED | #A78BFA | #F43F5E | gaming |
+| 29 | Podcast Platform | #3B82F6 | #60A5FA | #F97316 | podcast, platform |
+| 47 | Music Streaming | #3B82F6 | #60A5FA | #F97316 | music, streaming |
+
+### 🏪 Services & Local Business
+
+| # | Nome | Primary | Secondary | CTA | Keywords |
+|---|------|---------|-----------|-----|----------|
+| 5 | Service Landing Page | #3B82F6 | #60A5FA | #F97316 | service, landing |
+| 6 | B2B Service | #0F172A | #334155 | #0369A1 | b2b, service |
+| 36 | Restaurant/Food Service | #DC2626 | #F87171 | #CA8A04 | restaurant, food |
+| 38 | Real Estate/Property | #0F766E | #14B8A6 | #0369A1 | real, estate |
+| 40 | Hotel/Hospitality | #1E3A8A | #3B82F6 | #CA8A04 | hotel, hospitality |
+
+### 🔐 Tech & Security
+
+| # | Nome | Primary | Secondary | CTA | Keywords |
+|---|------|---------|-----------|-----|----------|
+| 19 | AI/Chatbot Platform | #7C3AED | #A78BFA | #06B6D4 | chatbot, platform |
+| 86 | Cybersecurity Platform | #00FF41 | #0D0D0D | #00FF41 | cybersecurity, hacker |
+| 87 | Developer Tool / IDE | #3B82F6 | #1E293B | #2563EB | developer, tool, ide, code |
+
+### 🚀 Innovation & Future
+
+| # | Nome | Primary | Secondary | CTA | Keywords |
+|---|------|---------|-----------|-----|----------|
+| 88 | Biotech / Life Sciences | #0EA5E9 | #0284C7 | #10B981 | biotech, science |
+| 89 | Space Tech / Aerospace | #FFFFFF | #94A3B8 | #3B82F6 | space, aerospace |
+| 91 | Quantum Computing | #00FFFF | #7B61FF | #FF00FF | quantum, qubit |
+| 95 | Spatial / Vision OS | #FFFFFF | #E5E5E5 | #007AFF | spatial, glass, vision |
+| 96 | Climate Tech | #2E8B57 | #87CEEB | #FFD700 | climate, green, energy |
+
+---
+
+## 📖 Como Usar
+
+### Para ler detalhes completos:
+
+1. **Via Índice:** Encontre número da paleta acima
+2. **Abra CSV:** `content/design-system/data/colors.csv`
+3. **Vá para linha:** Linha = Número + 1 (header na linha 1)
+4. **Extraia campos:** Primary, Secondary, CTA, Background, Text, Border, Notes
+
+### Exemplo:
+
+```
+Projeto: SaaS de gestão de projetos
+Buscar: "SaaS (General)" → # 1
+Abrir: colors.csv linha 2
+Resultado completo:
+- Primary: #2563EB
+- Secondary: #3B82F6
+- CTA: #F97316
+- Background: #F8FAFC
+- Text: #1E293B
+- Border: #E2E8F0
+- Notes: Trust blue + accent contrast
+```
+
+---
+
+## ⚠️ Validação Obrigatória
+
+**Purple Ban:** Verificar se paleta NÃO usa roxo como cor principal (regra MCP UX Design)
+
+Cores a evitar:
+- Roxo (#6B21A8, #7C3AED, #8B5CF6, #A78BFA)
+- Violeta
+- Magenta (#EC4899, #F472B6)
+
+**Exceções no database:**
+- Linha 19: AI/Chatbot Platform (#7C3AED) ⚠️
+- Linha 41: Wedding/Event Planning (#7C3AED) ⚠️
+- Linha 76: Event Management (#7C3AED) ⚠️
+- Linha 78: Membership/Community (#7C3AED) ⚠️
+
+→ Se encontrar roxo, sugerir alternativa ao usuário
+
+---
+
+**Total de paletas:** 96  
+**Última atualização:** 2026-01-23

package/dist/content/content/design-system/indexes/quick-search.md

@@ -0,0 +1,111 @@
+# Guia Rápido de Busca no Design System
+
+Referência rápida para buscar paletas, fontes e estilos.
+
+---
+
+## 🎯 Busca por Keywords
+
+### Buscar Paleta de Cores
+
+**Por tipo de produto:**
+```
+SaaS → Linhas 1-2, 17-18, 23
+E-commerce → Linhas 3-4, 28, 50
+Fintech → Linhas 7, 15, 20, 43-44
+Healthcare → Linhas 9, 24, 34, 37, 60-64
+Education → Linhas 10, 45, 84-85
+```
+
+**Por mood/estilo:**
+```
+Professional/Corporate → Linhas 6, 14, 42-43, 72-73
+Creative/Artistic → Linhas  11-12, 39, 75
+Dark/Tech → Linhas 15, 86-87, 89, 91
+Elegant/Luxury → Linhas 4, 35, 38, 40-41
+Playful/Fun → Linhas 13, 27, 30, 59
+```
+
+### Buscar Par de Fontes
+
+**Por mood:**
+```
+Elegant → STT 1, 12, 30, 50
+Modern → STT 2, 3, 11, 13
+Professional → STT 2, 16, 31
+Playful → STT 6, 19, 45
+Minimal → STT 5, 47, 48
+```
+
+**Por uso:**
+```
+Luxury brands → STT 1, 12, 32, 50
+SaaS/Tech → STT 2, 3, 13, 31
+Editorial/Blog → STT 4, 14, 35
+Developer tools → STT 9, 42
+```
+
+### Buscar Estilo UI
+
+**Por categoria:**
+```
+Minimalism → STT 1, 5, 47, 50
+Modern → STT 2, 11, 20, 43
+3D/Immersive → STT 6, 15
+Dark Mode → STT 8, 41-42
+Landing Page → STT 21-28
+Dashboard/BI → STT 29-38
+```
+
+---
+
+## 📊 Workflow Rápido
+
+### Cenário 1: Projeto SaaS Moderno
+
+```markdown
+1. Cores: colors-index.md → "SaaS General" (#2563EB)
+2. Fontes: typography-index.md → "Modern Professional" (Poppins + Open Sans)
+3. Estilo: styles-index.md → "Minimalism & Swiss Style"
+4. Resultado: Design system completo em < 5min
+```
+
+### Cenário 2: E-commerce Luxury
+
+```markdown
+1. Cores: colors-index.md → "E-commerce Luxury" (#1C1917 black + gold)
+2. Fontes: typography-index.md → "Luxury Serif" (Cormorant + Montserrat)
+3. Estilo: styles-index.md → "Luxury Minimalist"
+4. Guidelines: UX → Evitar distrações, foco em produto
+```
+
+### Cenário 3: Healthcare App
+
+```markdown
+1. Cores: colors-index.md → "Healthcare App" (#0891B2 calm blue)
+2. Fontes: typography-index.md → "Medical Clean" (Figtree + Noto Sans)
+3. Estilo: styles-index.md → "Accessible & Ethical" (WCAG AAA)
+4. Validação: Acessibilidade obrigatória
+```
+
+---
+
+## 🔗 Links Rápidos
+
+- **[README Principal](../README.md)** - Visão geral
+- **[Cores Completo](colors-index.md)** - 96 paletas
+- **[Tipografia](typography-index.md)** - 57 pares
+- **[Estilos](styles-index.md)** - 58 estilos
+
+---
+
+## ⚡ Dicas de Eficiência
+
+1. **Comece pelo tipo de produto** (SaaS, E-commerce, etc)
+2. **Refine por mood** (Elegant, Modern, Playful)
+3. **Valide Purple Ban** (sem roxo)
+4. **Confirme com usuário** (database é sugestão)
+
+---
+
+**Atualizado:** 2026-01-23