Atlassian의 DESIGN.md 공개 - 이식 가능한 디자인 컨텍스트를 실전 테스트하며 얻은 교훈

Context

AI 생성 UI가 브랜드 정체성 없이 일반화되는 'slop' 현상 발생. 이는 AI가 학습 데이터 평균값에 의존하며 브랜드 및 컴포넌트 패턴에 대한 컨텍스트가 부족한 구조적 한계에 기인함.

Technical Solution

• 디자인 토큰과 디자인 근거(rationale)를 결합한 이식형 Markdown 포맷의 DESIGN.md 설계
• 기계 판독용 토큰 나열과 에이전트 판독용 의도(intent) 기술의 이분법적 구조 채택
• MCP 서버의 온디맨드 방식 대비 프롬프트에 전체 컨텍스트를 즉시 주입하는 스냅샷 전략 구사
• Tailwind 및 Shadcn 등 범용 라이브러리 커스터마이징을 위한 고수준 지침으로 디자인 언어 정렬
• 기존 컴포넌트 라이브러리 import 대신 재구현 명세를 제공하여 Zero-dependency 프로토타이핑 구현

Impact

• 프로덕션 적용 시 MCP 서버 대비 토큰 소비량 약 92% 증가
• 실행 간 토큰 소비 변동 폭 약 2.7배 증가
• 파일 크기 80KB 및 약 19,800 LLM 토큰의 고밀도 컨텍스트 구성