DESIGN.md

코딩 에이전트에게 시각적 아이덴티티를 설명하기 위한 형식 사양입니다. DESIGN.md는 에이전트가 디자인 시스템을 지속적이고 구조적으로 이해하도록 합니다.

형식

DESIGN.md 파일은 기계가 읽을 수 있는 디자인 토큰(YAML 프런트 매터)과 사람이 읽을 수 있는 디자인 근거(마크다운 본문)를 결합합니다. 토큰은 에이전트에 정확한 값을 제공합니다. 본문은 해당 값이 존재하는 이유와 적용 방법을 설명합니다.

이 파일을 읽는 에이전트는 Public Sans 글꼴의 진한 잉크 헤드라인, 따뜻한 석회석 배경, Boston Clay CTA 버튼을 가진 UI를 생성할 것입니다.

시작하기

DESIGN.md를 사양에 따라 검증하고, 깨진 토큰 참조를 잡으며, WCAG 대비 비율을 확인하고, 구조적 발견사항을 도출하십시오. 모든 결과는 에이전트가 활용할 수 있는 구조화된 JSON으로 제공됩니다.

디자인 시스템의 두 버전을 비교하여 토큰 수준과 본문 수준의 회귀를 감지합니다:

사양

전체 DESIGN.md 사양은 docs/spec.md에 있습니다. 아래는 요약 참조입니다.

파일 구조

DESIGN.md 파일은 두 가지 계층으로 구성됩니다:

1. YAML 프런트 매터 — 파일 상단의 --- 구분자로 구분된 기계가 읽을 수 있는 디자인 토큰.
2. 마크다운 본문 — ## 섹션으로 조직된 사람이 읽을 수 있는 디자인 근거.

토큰은 규범적 값입니다. 본문은 이를 적용하는 방법에 대한 맥락을 제공합니다.

토큰 스키마

토큰 유형

유형	형식	예시
색상	모든 CSS 색상(hex, rgb(), oklch(), 이름 등)	"#1A1C1E", "oklch(62% 0.18 250)"

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.