@harness-engineering/cli 1.6.2 → 1.8.0

package/dist/agents/skills/shared/design-knowledge/industries/ecommerce.yaml

@@ -0,0 +1,80 @@
+name: "E-Commerce"
+description: "Conversion-focused design with bold CTAs, clear product hierarchy, and friction-minimized purchase flows"
+
+styles:
+  primary: "Conversion-optimized layouts with clear visual hierarchy driving users toward purchase decisions"
+  secondary: "Editorial product storytelling with immersive imagery and aspirational lifestyle positioning"
+  avoid: ["Overwhelming product grids without filtering or visual breathing room", "Hidden or ambiguous pricing that erodes buyer confidence", "Aggressive pop-ups that interrupt the shopping flow", "Cluttered product pages with competing calls-to-action"]
+
+palette:
+  primary:
+    - name: "Orange 600"
+      hex: "#ea580c"
+      usage: "Primary CTAs (Add to Cart, Buy Now), urgency indicators"
+    - name: "Orange 700"
+      hex: "#c2410c"
+      usage: "Hover states on primary actions, active button states"
+    - name: "Orange 50"
+      hex: "#fff7ed"
+      usage: "Sale banners, promotional section backgrounds"
+  accent:
+    - name: "Rose 500"
+      hex: "#f43f5e"
+      usage: "Sale badges, discount indicators, wishlist hearts"
+    - name: "Amber 400"
+      hex: "#fbbf24"
+      usage: "Star ratings, featured product highlights, best-seller badges"
+    - name: "Emerald 500"
+      hex: "#10b981"
+      usage: "In-stock indicators, free shipping badges, trust seals"
+  neutral:
+    - name: "Zinc 900"
+      hex: "#18181b"
+      usage: "Product titles, prices, primary text"
+    - name: "Zinc 500"
+      hex: "#71717a"
+      usage: "Product descriptions, secondary information, metadata"
+    - name: "Zinc 100"
+      hex: "#f4f4f5"
+      usage: "Category backgrounds, filter panels, page surfaces"
+    - name: "White"
+      hex: "#ffffff"
+      usage: "Product cards, checkout forms, content backgrounds"
+  semantic:
+    success: "#16a34a"
+    warning: "#eab308"
+    error: "#dc2626"
+    info: "#0284c7"
+
+typography:
+  display:
+    families: ["DM Sans", "Plus Jakarta Sans"]
+    weights: [600, 700, 800]
+    characteristics: "Bold geometric sans-serifs that command attention for hero sections, sale headers, and category titles. Strong at large sizes."
+  body:
+    families: ["Inter", "DM Sans", "system-ui"]
+    weights: [400, 500]
+    characteristics: "Highly legible at small sizes for product specs, reviews, and policy text. Clear distinction between regular and medium weights for scannability."
+  mono:
+    families: ["JetBrains Mono", "SF Mono"]
+    usage: "Order numbers, tracking codes, promo codes, SKU references"
+
+anti_patterns:
+  - pattern: "Hiding the total price until checkout"
+    reason: "Price surprises at checkout are the #1 cause of cart abandonment (48% of users cite unexpected costs)"
+    instead: "Show running total including estimated tax and shipping on the cart page; surface free-shipping thresholds early"
+  - pattern: "Requiring account creation before purchase"
+    reason: "Forced registration causes 24% of shoppers to abandon; it adds friction at the highest-intent moment"
+    instead: "Offer guest checkout as the default path; invite account creation after purchase with order-tracking incentive"
+  - pattern: "Product images that don't zoom or show only one angle"
+    reason: "Users cannot evaluate products they can't inspect; lack of imagery increases return rates"
+    instead: "Provide 4+ images per product with zoom, multiple angles, lifestyle context, and size reference"
+  - pattern: "Infinite scroll on product listing pages without pagination controls"
+    reason: "Users lose their place, cannot bookmark results, and experience scroll fatigue; footer content becomes unreachable"
+    instead: "Use paginated results with 'Load more' option; preserve scroll position on back navigation"
+  - pattern: "Using carousel sliders for critical product information"
+    reason: "Users interact with fewer than 1% of carousel slides past the first; important products get buried"
+    instead: "Use static grids or curated featured sections; if using carousels, show partial next-slide indicators"
+
+examples:
+  reference_sites: ["shopify.com/themes", "everlane.com", "apple.com/shop", "allbirds.com", "glossier.com"]

package/dist/agents/skills/shared/design-knowledge/industries/emerging-tech.yaml

@@ -0,0 +1,83 @@
+name: "Emerging Tech"
+description: "Innovative, forward-looking design with dark themes, accent neons, and geometric precision for cutting-edge technology products"
+
+styles:
+  primary: "Dark-first interfaces with precise geometric layouts, neon accents, and futuristic visual language"
+  secondary: "Data-rich dashboards with real-time visualization, 3D elements, and immersive product experiences"
+  avoid: ["Retro-futurism cliches (chrome text, star fields, 80s synthwave aesthetics)", "Inaccessible contrast ratios from neon-on-dark combinations", "Overuse of 3D elements that slow performance and add no information", "Gratuitous particle effects and WebGL demos that distract from product value"]
+
+palette:
+  primary:
+    - name: "Deep Space"
+      hex: "#0a0a0f"
+      usage: "Primary background, immersive dark surfaces"
+    - name: "Dark Surface"
+      hex: "#141420"
+      usage: "Card backgrounds, elevated surfaces, modal backgrounds"
+    - name: "Midnight Blue"
+      hex: "#1a1a2e"
+      usage: "Secondary surfaces, sidebar backgrounds, section dividers"
+  accent:
+    - name: "Electric Cyan"
+      hex: "#00d4ff"
+      usage: "Primary interactive elements, data visualization highlights, key metrics"
+    - name: "Neon Green"
+      hex: "#00ff88"
+      usage: "Success states, active indicators, real-time status"
+    - name: "Electric Purple"
+      hex: "#a855f7"
+      usage: "Premium features, AI/ML indicators, secondary accent"
+    - name: "Hot Pink"
+      hex: "#ec4899"
+      usage: "Alerts, critical notifications, tertiary accent"
+  neutral:
+    - name: "Light Gray"
+      hex: "#e2e8f0"
+      usage: "Primary text on dark backgrounds"
+    - name: "Cool Gray"
+      hex: "#94a3b8"
+      usage: "Secondary text, labels, descriptions"
+    - name: "Dark Gray"
+      hex: "#334155"
+      usage: "Borders, dividers, inactive states"
+    - name: "Near Black"
+      hex: "#0f172a"
+      usage: "Deepest surface level, page background in ultra-dark mode"
+  semantic:
+    success: "#00ff88"
+    warning: "#fbbf24"
+    error: "#ef4444"
+    info: "#00d4ff"
+
+typography:
+  display:
+    families: ["Space Grotesk", "Outfit"]
+    weights: [500, 700]
+    characteristics: "Geometric sans-serifs with distinctive character at large sizes. Slightly technical feel without being cold -- conveys precision and innovation."
+  body:
+    families: ["Inter", "Space Grotesk", "system-ui"]
+    weights: [400, 500]
+    characteristics: "Clean and highly legible on dark backgrounds. Slightly increased letter-spacing (0.01em) for improved readability on dark surfaces."
+  mono:
+    families: ["JetBrains Mono", "Fira Code", "Geist Mono"]
+    usage: "Terminal output, API responses, blockchain addresses, configuration code, real-time data streams"
+
+anti_patterns:
+  - pattern: "Neon text on dark background without sufficient contrast ratio"
+    reason: "Many neon colors (cyan, green, pink) on near-black fail WCAG AA (4.5:1); vibrant does not mean readable"
+    instead: "Test all neon accent text against backgrounds; use brighter tints for text (e.g., lighten cyan to #67e8f9 for readability) or increase font size"
+  - pattern: "Using 3D renders and WebGL for purely decorative purposes"
+    reason: "Heavy 3D adds seconds to load time, drains mobile batteries, and often communicates nothing about the product"
+    instead: "Use 3D only when it serves understanding (product visualization, spatial data); offer 2D fallbacks for performance"
+  - pattern: "Retro-futurism aesthetics (chrome text, grid floors, star fields)"
+    reason: "Dated sci-fi visuals signal that the team's vision of the future is stuck in the past; it undermines credibility for genuinely novel technology"
+    instead: "Reference current cutting-edge design (spatial computing UI, ambient interfaces, adaptive layouts) rather than pop-culture futurism"
+  - pattern: "Auto-playing demos that consume resources without user initiation"
+    reason: "Real-time visualizations and simulations consume CPU/GPU; auto-playing them causes fan noise, battery drain, and poor first impressions"
+    instead: "Show a compelling static frame with a clear 'Run demo' CTA; respect the user's device and battery"
+  - pattern: "Dark mode only with no light mode option"
+    reason: "Some users have visual conditions that make dark interfaces harder to read; accessibility requires options"
+    instead: "Offer both dark and light modes; dark can be default but light must be available and well-designed"
+
+examples:
+  reference_sites: ["openai.com", "vercel.com", "linear.app", "github.com/features/copilot", "replit.com"]

package/dist/agents/skills/shared/design-knowledge/industries/fintech.yaml

@@ -0,0 +1,80 @@
+name: "Fintech"
+description: "Trust-driven, precision-focused design conveying security, reliability, and financial expertise"
+
+styles:
+  primary: "Conservative elegance with precise data presentation and trust-building visual cues"
+  secondary: "Institutional authority balanced with modern approachability for consumer-facing products"
+  avoid: ["Playful or whimsical typography that undermines financial credibility", "Bright gradients or neon accents that feel unserious", "Overly complex data visualizations without progressive disclosure", "Gamification patterns that trivialize financial decisions"]
+
+palette:
+  primary:
+    - name: "Navy 800"
+      hex: "#1e3a5f"
+      usage: "Primary brand, navigation, headers conveying institutional trust"
+    - name: "Navy 900"
+      hex: "#0f2440"
+      usage: "Dark mode surfaces, footer backgrounds, high-emphasis text"
+    - name: "Navy 100"
+      hex: "#dbeafe"
+      usage: "Selected states, info banners, subtle highlights"
+  accent:
+    - name: "Emerald 600"
+      hex: "#059669"
+      usage: "Positive financial indicators, gains, completed transactions"
+    - name: "Teal 500"
+      hex: "#14b8a6"
+      usage: "Secondary actions, chart accents, interactive elements"
+    - name: "Gold 500"
+      hex: "#d4a853"
+      usage: "Premium tier indicators, high-value account badges"
+  neutral:
+    - name: "Gray 900"
+      hex: "#111827"
+      usage: "Primary text, financial figures, account balances"
+    - name: "Gray 600"
+      hex: "#4b5563"
+      usage: "Secondary text, transaction descriptions, timestamps"
+    - name: "Gray 100"
+      hex: "#f3f4f6"
+      usage: "Page backgrounds, table alternating rows"
+    - name: "White"
+      hex: "#ffffff"
+      usage: "Card surfaces, input fields, modal backgrounds"
+  semantic:
+    success: "#059669"
+    warning: "#d97706"
+    error: "#dc2626"
+    info: "#2563eb"
+
+typography:
+  display:
+    families: ["Inter", "SF Pro Display"]
+    weights: [500, 600, 700]
+    characteristics: "Clean sans-serifs with excellent tabular figures. Numeral clarity is paramount -- every digit must be unambiguous at any size."
+  body:
+    families: ["Inter", "SF Pro Text", "system-ui"]
+    weights: [400, 500]
+    characteristics: "High legibility at small sizes for transaction lists and account details. Tabular lining figures for aligned number columns."
+  mono:
+    families: ["SF Mono", "JetBrains Mono", "Fira Code"]
+    usage: "Account numbers, routing numbers, transaction IDs, API references, and any numerical data requiring exact alignment"
+
+anti_patterns:
+  - pattern: "Displaying financial amounts without proper locale formatting"
+    reason: "Misformatted currency (e.g., missing commas, wrong decimal separator) erodes trust and can cause costly user errors"
+    instead: "Use Intl.NumberFormat with the user's locale and currency; always show currency symbol and appropriate decimal places"
+  - pattern: "Using red and green as the only differentiator for gains and losses"
+    reason: "8% of men and 0.5% of women have red-green color blindness; financial data must be accessible to all users"
+    instead: "Pair color with icons (up/down arrows), text labels (+/-), or positional cues; never rely on color alone"
+  - pattern: "Auto-refreshing account balances without user consent"
+    reason: "Unexpected balance changes cause anxiety; users viewing their balance are in a sensitive emotional state"
+    instead: "Show a 'Balance updated' indicator with timestamp; let users pull-to-refresh or tap to update"
+  - pattern: "Placing transfer/send buttons where they can be accidentally tapped"
+    reason: "Accidental financial transactions create support burden and erode trust; money movement must be intentional"
+    instead: "Require confirmation for all financial actions; use adequate spacing and distinct visual treatment for destructive actions"
+  - pattern: "Hiding fees or exchange rates behind expandable sections"
+    reason: "Perceived fee hiding destroys trust and may violate financial transparency regulations"
+    instead: "Show total cost including all fees upfront; use clear breakdowns before any confirmation step"
+
+examples:
+  reference_sites: ["mercury.com", "wise.com", "stripe.com", "robinhood.com", "brex.com"]

package/dist/agents/skills/shared/design-knowledge/industries/healthcare.yaml

@@ -0,0 +1,80 @@
+name: "Healthcare"
+description: "Calm, accessible design prioritizing clarity, trust, and universal usability for health-related products"
+
+styles:
+  primary: "Calm and reassuring with high readability, generous spacing, and clear visual hierarchy"
+  secondary: "Clinical precision balanced with warmth and approachability for patient-facing applications"
+  avoid: ["Red as a decorative color (it signals emergency or danger in medical contexts)", "Small text below 16px for any patient-facing content", "Dense information layouts without progressive disclosure", "Harsh visual contrasts that create anxiety"]
+
+palette:
+  primary:
+    - name: "Blue 600"
+      hex: "#2563eb"
+      usage: "Primary actions, navigation, trust-building brand elements"
+    - name: "Blue 700"
+      hex: "#1d4ed8"
+      usage: "Hover states, active navigation, focused elements"
+    - name: "Blue 50"
+      hex: "#eff6ff"
+      usage: "Info banners, selected states, section backgrounds"
+  accent:
+    - name: "Teal 500"
+      hex: "#14b8a6"
+      usage: "Wellness indicators, positive health metrics, secondary CTAs"
+    - name: "Green 500"
+      hex: "#22c55e"
+      usage: "Healthy ranges, normal readings, completion states"
+    - name: "Lavender 400"
+      hex: "#a78bfa"
+      usage: "Mental health sections, calm interactive elements, tertiary accents"
+  neutral:
+    - name: "Slate 800"
+      hex: "#1e293b"
+      usage: "Primary text, headings, critical medical information"
+    - name: "Slate 500"
+      hex: "#64748b"
+      usage: "Secondary text, labels, non-critical descriptions"
+    - name: "Slate 50"
+      hex: "#f8fafc"
+      usage: "Page backgrounds, content area surfaces"
+    - name: "White"
+      hex: "#ffffff"
+      usage: "Card surfaces, form backgrounds, reading areas"
+  semantic:
+    success: "#16a34a"
+    warning: "#ca8a04"
+    error: "#dc2626"
+    info: "#2563eb"
+
+typography:
+  display:
+    families: ["Source Sans 3", "Nunito Sans"]
+    weights: [600, 700]
+    characteristics: "Humanist sans-serifs with open letterforms for maximum legibility. Friendly without being childish -- conveys competence and care."
+  body:
+    families: ["Source Sans 3", "Nunito Sans", "system-ui"]
+    weights: [400, 600]
+    characteristics: "Minimum 16px body text, 1.6+ line-height. Must remain legible for elderly users and those with visual impairments. Avoid light font weights."
+  mono:
+    families: ["Source Code Pro", "IBM Plex Mono"]
+    usage: "Medical record numbers, dosage values, lab result codes, appointment IDs"
+
+anti_patterns:
+  - pattern: "Using red as a decorative or branding color"
+    reason: "In medical contexts red universally signals emergency, danger, or critical status; decorative red causes false alarm and anxiety"
+    instead: "Reserve red exclusively for errors, critical alerts, and emergency states; use blue or teal for branding"
+  - pattern: "Body text smaller than 16px on patient-facing screens"
+    reason: "Healthcare users include elderly patients and those under medical stress; small text increases error risk in dosage or appointment information"
+    instead: "Use 16px minimum for body, 14px minimum for labels, and provide text scaling options; test with users aged 65+"
+  - pattern: "Auto-dismissing notifications for medical information"
+    reason: "Patients may need extra time to read and comprehend health information; auto-dismiss causes missed critical details"
+    instead: "Use persistent notifications that require manual dismissal for any health-related information"
+  - pattern: "Complex medical jargon without plain-language alternatives"
+    reason: "Health literacy varies enormously; jargon creates barriers to understanding and informed consent"
+    instead: "Provide plain-language summaries alongside medical terminology; use progressive disclosure for clinical detail"
+  - pattern: "Date/time ambiguity in appointment scheduling"
+    reason: "Missed appointments due to AM/PM confusion or timezone errors have real health consequences"
+    instead: "Always show full date with day-of-week, use 12-hour time with explicit AM/PM, and display timezone; confirm with relative time ('in 3 days')"
+
+examples:
+  reference_sites: ["zocdoc.com", "one.app", "headspace.com", "oscar.com", "calm.com"]

package/dist/agents/skills/shared/design-knowledge/industries/lifestyle.yaml

@@ -0,0 +1,80 @@
+name: "Lifestyle"
+description: "Warm, aspirational design that evokes feeling and connection through earthy tones, organic shapes, and inviting imagery"
+
+styles:
+  primary: "Warm and aspirational with organic layouts, generous imagery, and an inviting human-centered feel"
+  secondary: "Community-driven with user-generated content integration and relatable, authentic photography"
+  avoid: ["Corporate sterility that feels disconnected from real life", "Dense text-heavy layouts that suppress the visual storytelling", "Harsh geometric precision that feels cold and institutional", "Oversaturated filters that make imagery feel artificial"]
+
+palette:
+  primary:
+    - name: "Terracotta"
+      hex: "#c2714f"
+      usage: "Primary brand, warm CTAs, hero section accents"
+    - name: "Warm Brown"
+      hex: "#8b5e3c"
+      usage: "Grounding elements, navigation, footer"
+    - name: "Sand"
+      hex: "#f5ebe0"
+      usage: "Page backgrounds, warm surface tones"
+  accent:
+    - name: "Sage Green"
+      hex: "#7c9070"
+      usage: "Wellness and nature-related content, secondary CTAs"
+    - name: "Dusty Rose"
+      hex: "#d4a0a0"
+      usage: "Lifestyle imagery overlays, soft highlights, feminine accents"
+    - name: "Sunshine"
+      hex: "#f2c94c"
+      usage: "Joy and energy indicators, featured content, seasonal promotions"
+  neutral:
+    - name: "Warm Gray 800"
+      hex: "#3d3532"
+      usage: "Primary text, headings"
+    - name: "Warm Gray 500"
+      hex: "#8a817c"
+      usage: "Secondary text, captions, metadata"
+    - name: "Warm Gray 100"
+      hex: "#f0ebe5"
+      usage: "Alternating section backgrounds, card surfaces"
+    - name: "Cream"
+      hex: "#fdfbf7"
+      usage: "Primary page backgrounds, content areas"
+  semantic:
+    success: "#4ade80"
+    warning: "#fbbf24"
+    error: "#f87171"
+    info: "#60a5fa"
+
+typography:
+  display:
+    families: ["Lora", "DM Serif Display"]
+    weights: [400, 700]
+    characteristics: "Warm serif typefaces that feel inviting and editorial. Organic curves and moderate contrast convey approachability and authenticity."
+  body:
+    families: ["Nunito Sans", "DM Sans", "system-ui"]
+    weights: [400, 600]
+    characteristics: "Rounded sans-serifs that complement serif display type. Friendly letterforms with open counters for warm, approachable body text."
+  mono:
+    families: ["Source Code Pro", "JetBrains Mono"]
+    usage: "Recipe measurements, product dimensions, order tracking codes"
+
+anti_patterns:
+  - pattern: "Using corporate stock photography with posed models and white backgrounds"
+    reason: "Lifestyle brands depend on authenticity; staged corporate imagery breaks the emotional connection"
+    instead: "Use natural-light photography with real environments, candid moments, and diverse representation"
+  - pattern: "Dense text blocks for product descriptions or about-us content"
+    reason: "Lifestyle audiences engage through visuals and emotion first; text walls suppress the aspirational feeling"
+    instead: "Lead with imagery, use short evocative copy (2-3 sentences), and let whitespace breathe between content blocks"
+  - pattern: "Aggressive email capture pop-ups on first visit"
+    reason: "Interrupting the aspirational browsing experience before any emotional investment destroys engagement"
+    instead: "Introduce email capture after scroll depth (50%+) or second page visit; offer genuine value (styling guide, recipe book)"
+  - pattern: "Monochromatic color schemes with no warmth"
+    reason: "Pure grayscale or cool-toned palettes feel clinical and corporate for lifestyle brands"
+    instead: "Infuse warmth through earthy tones, textured backgrounds, and warm-filtered photography"
+  - pattern: "Tiny product thumbnails in grid layouts without lifestyle context"
+    reason: "Products shown in isolation lose the aspirational context that drives lifestyle purchases"
+    instead: "Show products in context (styled rooms, worn outfits, prepared meals) alongside detail views"
+
+examples:
+  reference_sites: ["airbnb.com", "goop.com", "aesop.com", "kinfolk.com", "patagonia.com"]

package/dist/agents/skills/shared/design-knowledge/industries/saas.yaml

@@ -0,0 +1,80 @@
+name: "SaaS"
+description: "Clean, data-forward design emphasizing clarity, efficiency, and scalable UI patterns for software products"
+
+styles:
+  primary: "Clean minimalism with data-forward layouts and generous whitespace"
+  secondary: "Dashboard-oriented design with card-based information architecture"
+  avoid: ["Cluttered dashboards with competing visual hierarchies", "Rainbow status colors without semantic meaning", "Decorative elements that distract from data comprehension", "Heavy skeuomorphic textures"]
+
+palette:
+  primary:
+    - name: "Indigo 600"
+      hex: "#4f46e5"
+      usage: "Primary actions, active states, navigation highlights"
+    - name: "Indigo 700"
+      hex: "#4338ca"
+      usage: "Hover states, emphasis on primary elements"
+    - name: "Indigo 50"
+      hex: "#eef2ff"
+      usage: "Selected row backgrounds, active section indicators"
+  accent:
+    - name: "Cyan 500"
+      hex: "#06b6d4"
+      usage: "Secondary actions, data visualization accent, links"
+    - name: "Violet 500"
+      hex: "#8b5cf6"
+      usage: "Premium features, upgrade prompts, chart series"
+    - name: "Amber 400"
+      hex: "#fbbf24"
+      usage: "Highlights, badges, attention indicators"
+  neutral:
+    - name: "Slate 900"
+      hex: "#0f172a"
+      usage: "Primary text, headings"
+    - name: "Slate 500"
+      hex: "#64748b"
+      usage: "Secondary text, labels, placeholders"
+    - name: "Slate 100"
+      hex: "#f1f5f9"
+      usage: "Page backgrounds, card surfaces, dividers"
+    - name: "White"
+      hex: "#ffffff"
+      usage: "Card backgrounds, input fields, content areas"
+  semantic:
+    success: "#16a34a"
+    warning: "#eab308"
+    error: "#dc2626"
+    info: "#2563eb"
+
+typography:
+  display:
+    families: ["Inter", "Geist"]
+    weights: [600, 700]
+    characteristics: "Geometric sans-serifs with tight tracking for dashboard headers and feature titles. Inter offers excellent tabular number support for data-heavy views."
+  body:
+    families: ["Inter", "Geist", "system-ui"]
+    weights: [400, 500]
+    characteristics: "Optimized for long-form reading in documentation and settings. 16px base with 1.6 line-height for comfortable scanning."
+  mono:
+    families: ["Geist Mono", "JetBrains Mono", "SF Mono"]
+    usage: "Code snippets, API keys, log output, terminal emulators, and tabular data where alignment matters"
+
+anti_patterns:
+  - pattern: "Using more than 5 colors in a single dashboard chart without a legend"
+    reason: "Users cannot distinguish more than 5-7 colors reliably; unlabeled series become meaningless"
+    instead: "Limit chart series to 5 colors with clear labels, or use interactive filtering to show subsets"
+  - pattern: "Placing critical actions behind ellipsis menus (three-dot overflow)"
+    reason: "Primary workflows become hidden, increasing time-to-task for frequent actions"
+    instead: "Surface the top 2-3 actions as visible buttons; use overflow only for rare or destructive actions"
+  - pattern: "Using modal dialogs for multi-step workflows"
+    reason: "Modals trap users and prevent reference to underlying data during complex operations"
+    instead: "Use slide-over panels or dedicated pages for multi-step flows; reserve modals for confirmations"
+  - pattern: "Inconsistent empty states across the product"
+    reason: "Blank screens confuse new users and miss onboarding opportunities"
+    instead: "Design empty states with illustration, explanation, and a clear CTA for every list and dashboard widget"
+  - pattern: "Real-time data without visible refresh indicators"
+    reason: "Users lose trust when numbers change without explanation; causes anxiety about data accuracy"
+    instead: "Show last-updated timestamps, subtle pulse animations on refresh, or explicit refresh buttons"
+
+examples:
+  reference_sites: ["linear.app", "notion.so", "stripe.com/dashboard", "vercel.com/dashboard", "arc.net"]

package/dist/agents/skills/shared/design-knowledge/industries/services.yaml

@@ -0,0 +1,80 @@
+name: "Professional Services"
+description: "Trust-building, professional design that conveys expertise, reliability, and clear value propositions"
+
+styles:
+  primary: "Professional and structured layouts that build credibility through clarity, consistency, and thoughtful restraint"
+  secondary: "Approachable authority with case-study-driven storytelling and clear service architecture"
+  avoid: ["Flashy animations that undermine professional credibility", "Unclear or hidden pricing that creates friction in the sales process", "Overly corporate stock photography with generic handshakes and skylines", "Dense text walls without scannable structure"]
+
+palette:
+  primary:
+    - name: "Blue 800"
+      hex: "#1e40af"
+      usage: "Primary brand, navigation, headers establishing professional authority"
+    - name: "Blue 700"
+      hex: "#1d4ed8"
+      usage: "CTAs, links, interactive elements"
+    - name: "Blue 50"
+      hex: "#eff6ff"
+      usage: "Section backgrounds, testimonial cards, feature highlights"
+  accent:
+    - name: "Slate 600"
+      hex: "#475569"
+      usage: "Secondary text, supporting information, subtle emphasis"
+    - name: "Emerald 600"
+      hex: "#059669"
+      usage: "Success metrics, growth indicators, value proof points"
+    - name: "Amber 500"
+      hex: "#f59e0b"
+      usage: "Attention markers, premium service tiers, important notices"
+  neutral:
+    - name: "Gray 900"
+      hex: "#111827"
+      usage: "Headings, primary text, service titles"
+    - name: "Gray 500"
+      hex: "#6b7280"
+      usage: "Body text, descriptions, secondary content"
+    - name: "Gray 100"
+      hex: "#f3f4f6"
+      usage: "Page backgrounds, alternating sections, sidebar surfaces"
+    - name: "White"
+      hex: "#ffffff"
+      usage: "Content cards, form backgrounds, primary reading surfaces"
+  semantic:
+    success: "#16a34a"
+    warning: "#d97706"
+    error: "#dc2626"
+    info: "#2563eb"
+
+typography:
+  display:
+    families: ["Inter", "Plus Jakarta Sans"]
+    weights: [600, 700]
+    characteristics: "Modern sans-serifs that convey competence without being cold. Strong enough for authority, approachable enough for client-facing communication."
+  body:
+    families: ["Inter", "Source Sans 3", "system-ui"]
+    weights: [400, 500]
+    characteristics: "Highly readable at all sizes for proposals, case studies, and service descriptions. Conservative line-height (1.6) for comfortable long-form reading."
+  mono:
+    families: ["IBM Plex Mono", "SF Mono"]
+    usage: "Contract references, project codes, technical specifications, pricing breakdowns"
+
+anti_patterns:
+  - pattern: "Vague service descriptions without concrete deliverables"
+    reason: "Prospects cannot evaluate services they don't understand; vague copy signals lack of expertise"
+    instead: "Define each service with specific deliverables, timelines, and outcomes; use case studies as proof"
+  - pattern: "Contact form as the only conversion path"
+    reason: "A single conversion funnel ignores varied buyer intent (some want pricing, others want case studies)"
+    instead: "Offer multiple CTAs: schedule a call, download a case study, view pricing, start a trial"
+  - pattern: "Testimonials without attribution or context"
+    reason: "Anonymous testimonials carry no credibility; they read as fabricated regardless of authenticity"
+    instead: "Include full name, title, company, and headshot; tie testimonials to specific services or outcomes"
+  - pattern: "Auto-playing animations on page load for every section"
+    reason: "Excessive animation on professional sites signals flash over substance; it delays content consumption"
+    instead: "Use subtle scroll-triggered reveals for key statistics; keep animations under 300ms and respect prefers-reduced-motion"
+  - pattern: "Burying pricing information or requiring a call for basic pricing"
+    reason: "67% of B2B buyers prefer self-serve research; hidden pricing wastes both buyer and seller time"
+    instead: "Show starting prices or pricing ranges openly; use 'Contact us' only for truly custom enterprise engagements"
+
+examples:
+  reference_sites: ["mckinsey.com", "bain.com", "thoughtbot.com", "metalab.com", "basecamp.com"]