피드로 돌아가기
Dev.toFrontend
원문 읽기
AI Agent의 일관된 UI 구현을 위한 Intent 기반 DESIGN.md 설계 전략
How to Write DESIGN.md Prose That AI Agents Actually Follow
AI 요약
Context
단순 Token 값 기반의 디자인 시스템 제공 시 AI Agent가 맥락을 이해하지 못해 발생하는 디자인 일관성 결여 문제 분석. 정적인 값(Value)만으로는 명시되지 않은 엣지 케이스에 대응하는 일반화 능력을 확보하기 어려운 한계 존재.
Technical Solution
- Token 값의 단순 나열이 아닌 설계 의도(Intent)와 규칙(Rule) 중심의 Prose 작성 구조 채택
- AI Agent의 추론 능력(Reasoning)을 활용하여 미정의 상황에서도 일관성을 유지하는 일반화 메커니즘 구축
- Overview, Colors, Typography, Layout 등 역할 중심의 Canonical Section 구성을 통한 정보 계층화
- Do's and Don'ts 섹션에 명시적 가드레일을 설정하여 오답 범위(Off-brand output)를 원천 차단
- Token 이름과 Rationale을 결합하여 AI가 값과 논리적 근거를 매핑하도록 설계
- WCAG AA Contrast(4.5:1)와 같은 정량적 제약 조건을 명시하여 기술적 정확도 확보
실천 포인트
1. 디자인 토큰 정의 시 단순 HEX 값 대신 해당 색상의 사용 목적과 제한 사항을 기술했는가?
2. Do's and Don'ts 섹션을 통해 AI가 범하기 쉬운 구체적인 실수 사례를 정의했는가?
3. 외부 디자이너가 문서를 보고 시스템을 정확히 적용할 수 있을 만큼의 추론 근거가 포함되었는가?
4. 접근성 표준과 같은 정량적 수치를 가드레일로 설정했는가?