출처
- source_url: https://news.hada.io/topic?id=30990
- author: neo (GeekNews, 원문 atlassian.com/blog)
- published: 2026-07-01
- raw: raw source:
web-2026-07-07-atlassian-design-md-portable-design-context
요약
AI가 생성한 UI는 브랜드 정체성 없이 그라디언트 버튼·대문자 제목·일반적 카드 레이아웃 같은 획일적 결과(“slop”)로 수렴하는 경향이 있다. 원인은 브랜드·컴포넌트·패턴 컨텍스트 부재 — “Generic in, generic out”이다. Google이 자사 Stitch 도구를 위해 설계한 오픈소스 Markdown 포맷 DESIGN.md는 이 문제를 풀기 위해 디자인 시스템의 핵심 요소를 프롬프트에 통째로 넣을 수 있는 한 파일로 압축한다. 기계 판독용 디자인 토큰과, 사람·에이전트가 읽는 색상·간격·레이아웃·컴포넌트 근거(rationale) 두 부분으로 구성되며, 시스템의 완전한 기술 명세가 아니라 **의도(intent)**만 담는 것이 철학이다.
Atlassian은 자체 mcp 서버(ADS MCP)와 AI skills로 이미 디자인 컨텍스트를 제공해온 상태에서 DESIGN.md를 실전 테스트했다. Team ‘26 키노트에서 Figma Make가 내부 MCP 도구 없이 DESIGN.md만으로 Atlassian 스타일의 대시보드를 한 번에 생성하는 데는 성공적이었다.
프로덕션 적용 시 트레이드오프: 로그인 화면 같은 단순 작업에서 DESIGN.md를 유일한 가이드로 쓰자 자체 MCP·skills 대비 토큰 약 92% 추가 소비, 생성 시간 증가, 실행 간 토큰 변동 약 2.7배가 관측됐다(모델·프롬프트·컨텍스트 품질에 따라 달라질 수 있는 비결정적 결과라는 단서는 있음). 세 가지 구조적 한계가 지적된다:
- 온디맨드가 아닌 일괄 로딩: MCP는
ads_plan같은 tool call로 필요한 컴포넌트 지침만 그때그때 가져오지만, DESIGN.md는 매번 전체를 로드해 시작부터 비용이 높고 적은 턴에서 컨텍스트가 잘릴 수 있다. - 압축으로 인한 컨텍스트 손실: 온디맨드 MCP·skills는 약 2.5MB 지침을 증류해 쓰지만, DESIGN.md는 한 번에 로드되므로 훨씬 더 줄여야 한다 — 실제 파일은 80KB(약 19,800 토큰)까지 줄이면서 50개+ 컴포넌트 사용 지침 상당 부분과 저사용 토큰을 제거했다. 그 결과 에이전트가 스스로 컨텍스트를 수집하거나 컴포넌트 구현을 직접 읽는 경향이 관찰됐다.
- 시스템 내부 노출: DESIGN.md는 재구현을 위한 명세이므로, 확립된 프로덕션 환경에서는 기존 컴포넌트를 import하기보다 새로 재구현하려는 경향을 유도해 기술 부채를 낳을 수 있다.
가장 유용한 경우: 고수준 예술적 방향 문서화, 익숙하지 않은 환경에서의 빠른 프로토타이핑, 디자인 도구와의 상호운용성, 적응형 UI를 위한 고객 테마링 — 공통적으로 기존 디자인 시스템 도구가 사용 불가하거나 비실용적인 상황이다. 결론은 DESIGN.md가 풍부한 디자인 시스템 도구의 대체재가 아니라 보완재라는 것. Atlassian은 자사 파일을 atlassian.design/DESIGN.md에 공개하고 표준 형성에 참여 중이다.
관련 위키
원문 보존 위치
원문 전체는 raw source: web-2026-07-07-atlassian-design-md-portable-design-context에 source_url과 함께 저장되어 있다.