Turning Handoffs into Handshakes: Integrating Design Systems for AI Prototyping at Scale
Nov 26, 2025Lewis-Ethan Healey, Kylor Hall

Summary
This post details how Atlassian is teaching AI to utilize its design system for AI prototyping. It discusses challenges in configuring AI tools with Atlassian's design system (npm packages, styling with Compiled, import handling), the need for custom instructions and templates, and strategies to reduce AI 'hallucinations' by providing structured context and configuration files. The post highlights the use of templates for speed and accuracy, the importance of configuration files over open-ended prompting for brand consistency, and the proliferation of templates across the organization. It also covers building confidence at scale through collective learning and maintaining evolving agentic content.