출처
- 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과 함께 저장되어 있다.