---
title: "Teaching AI to speak our design language"
url: https://daily.dev/posts/teaching-ai-to-speak-our-design-language-qcj2tdmqh
source_url: https://www.atlassian.com/blog/ai-at-work/teaching-ai-to-speak-our-design-language
type: article
source: "Atlassian"
published: 2026-06-02T16:28:21.510Z
updated: 2026-06-02T16:39:08.813Z
tags: ["ai-agents", "mcp", "design-systems", "atlassian"]
reading_time: 5
upvotes: 0
comments: 0
language: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Teaching AI to speak our design language

**[Atlassian](https://daily.dev/sources/atlassian)** · 5 min read · 0 upvotes · 0 comments

## Summary

Atlassian's design system team tackled the problem of AI tools generating inaccurate UI by restructuring their Atlassian Design System (ADS) documentation into machine-readable schema files. These TypeScript-based schemas cover components, tokens, icons, lint rules, and accessibility requirements. The structured content powers an ADS MCP server, design system skills, and DESIGN.md files. Compared to agents working without an MCP, the approach yielded up to 52% accuracy improvement on specific queries, 34% faster task completion, 16% fewer tokens consumed, and 26% fewer tool calls. Self-healing tooling keeps documentation in sync with the codebase automatically, and the team plans to connect structured content to more agents and the Teamwork Graph.

## Full article

daily.dev links to this article rather than hosting it. Read it at the original source: <https://www.atlassian.com/blog/ai-at-work/teaching-ai-to-speak-our-design-language>

## Similar posts on daily.dev

- [Atlassian Design System: Building the context engine for the AI era](https://daily.dev/posts/atlassian-design-system-building-the-context-engine-for-the-ai-era-tbqmqatwp) · Atlassian · 1 upvotes · 0 comments
- [How We Use AI to Turn Figma Designs into Production Code](https://daily.dev/posts/how-we-use-ai-to-turn-figma-designs-into-production-code-2nkdxmjjb) · monday Engineering · 60 upvotes · 5 comments
- [Design Systems for AI Agents: How to Make Yours Agent-Ready](https://daily.dev/posts/design-systems-for-ai-agents-how-to-make-yours-agent-ready-stcywhhbg) · Headway · 0 upvotes · 0 comments

---

Tags: [#ai-agents](https://daily.dev/tags/ai-agents), [#mcp](https://daily.dev/tags/mcp), [#design-systems](https://daily.dev/tags/design-systems), [#atlassian](https://daily.dev/tags/atlassian)

[View this post on daily.dev](https://daily.dev/posts/teaching-ai-to-speak-our-design-language-qcj2tdmqh)