Add Claude Design best practices and guidelines to UX handbook

Marcel van Remmerdenrequested to merge
ux-claude-design-guidelines into main

Summary

This MR adds a new handbook page documenting best practices and guidelines for using Claude Design in UX work at GitLab.

The page is located at content/handbook/product/ux/how-we-work/claude-design.md, alongside the existing AI usage in UX page, which it complements with Claude-specific design guidance.

What's included

  • When to use Claude Design — ideation, UI text, design review, prototyping, and handoff documentation
  • When not to use it — replacing user research, final designs without review, sensitive data, skipping Pajamas
  • Prompt writing best practices — how to craft effective, context-rich prompts for design tasks
  • Claude mode selection — which mode to use for different design scenarios
  • Design quality guidelines — how to review, validate, and own AI-generated outputs
  • Accessibility considerations — how Claude can help and where human review is essential
  • Transparency and collaboration — how to disclose AI use and share learnings with the team
  • Resources — links to Pajamas, accessibility guidelines, shared prompt libraries, and approved tools

Related

Merge request reports