
목차DESIGN.md 한 장에는 뭐가 들어 있나요?
리니어, 노션, 일레븐랩스, 람보르기니. 세계에서 제일 잘 만든 제품 2천여 개의 디자인 언어를 누군가 전부 파일로 바꿨습니다. 파일 이름만 봐도 용도를 알 수 있어요. DESIGN.md. 클로드 코드와 코덱스가 직접 읽는 마크다운 형식입니다.
사람들은 영어 소개 트윗을 28만 번, 일본어 소개를 26만 번 봤고, 9천 번 넘게 북마크했습니다. 북마크는 나중에 쓰려고 저장하는 행동이라, 저는 조회수보다 이 숫자를 더 정직한 수요 지표로 봅니다.
DESIGN.md 한 장에는 뭐가 들어 있나요?
설계 규칙을 통째로 담았습니다.
- 색상 팔레트와 디자인 토큰
- 서체와 크기, 굵기의 위계
- 여백 체계와 페이지 배치
- 컴포넌트별 스타일링 규칙
- 그리고 제일 값진 항목, 뭘 쓰고 뭘 피할지의 명시 규칙
딱 한 동작이면 됩니다. styles.refero.design에서 마음에 드는 제품 스타일을 골라 내려받고, 프로젝트 루트에 .md 한 장을 놓습니다. 그다음 에이전트에게 UI를 시키면, 그 규칙대로 짓습니다. 커서, 클로드 코드, 코덱스, v0을 지원하고 테일윈드 v4와 CSS 변수 형식까지 갖췄어요.
왜 이게 AI 촌티의 해독제인가요?
일본어로 소개한 사람이 정곡을 찔렀습니다. AI 특유의 촌스러운 UI를 박멸하는 사이트.
에이전트는 어딘가 서로 닮은 화면을 만듭니다. 같은 그라데이션, 같은 보라색 계열, 같은 카드 배치. 모델이 훈련 데이터의 평균값을 뱉기 때문이에요. 프롬프트로 예쁘게, 모던하게를 아무리 외쳐도 평균의 중력을 벗어나기 어렵습니다.
DESIGN.md를 쓰면 그 중력에서 빨리 벗어날 수 있어요. 말로 취향을 설명하는 대신, 검증된 제품의 규칙 체계를 통째로 이식해요. 에이전트는 평균을 흉내 내는 대신 이 법전을 따릅니다.
디자인 자산은 어디까지 추상화되나요?
저는 이 방식을 낯익은 흐름의 다음 단계로 봅니다.
전에는 컴포넌트 코드를 모아 레고처럼 조립했어요. beautifului, shadcn 계열 리소스를 에이전트에게 주고 통합시키는 방법. 그때는 부품 단위로 자산을 모았습니다.
DESIGN.md는 규칙 단위로 모아요. 부품은 사람이 여전히 고르고 조립해야 하지만, 규칙은 에이전트가 알아서 전체에 적용합니다. 사람들은 디자인 자산을 이미지에서 코드로, 코드에서 규칙으로 한 칸씩 추상화하고 있어요.
멩투가 디자인 팀 전체를 three.js 코드 사이트로 옮긴 것도 같은 줄기예요. 전부 코드라서 AI가 정밀하게 고칠 수 있죠. 이제 그 코드 위에 규칙 층을 하나 더 얹는 거예요.
남는 생각
저는 이 라이브러리가 무료인 지금이 창이라고 봅니다.
사이트에 현재 무료라고 적어 뒀어요. 사람들이 북마크 9천 개로 수요를 보여 줬으니, 운영자도 이 창을 오래 열어 두지는 않을 거예요.
그리고 저는 더 큰 과제를 하나 봅니다. 남의 DESIGN.md를 쓰는 것에서 멈추지 않고, 내 제품의 DESIGN.md를 만들어두는 것.
에이전트에게 취향을 이식하는 파일 한 장. 앞으로 팀은 디자인 시스템을 이 파일 한 장부터 만들 거예요. 그리는 에이전트에게도 문체 코퍼스처럼 규칙 파일을 주면 됩니다.
원문·소스
- 원 소개 트윗(@Voxyz_ai): https://x.com/Voxyz_ai/status/2093766772029559077
- 일본어 확산 트윗: https://x.com/codex_lab_/status/2094091484320657619
- 라이브러리: https://styles.refero.design/
FAQ
자주 묻는 질문
- DESIGN.md 한 장에는 뭐가 들어 있나요?
- 색상 팔레트와 디자인 토큰, 서체 위계, 여백과 배치, 컴포넌트 스타일, 뭘 쓰고 뭘 피할지의 명시 규칙입니다. styles.refero.design에서 내려받아 프로젝트 루트에 놓으면 에이전트가 그 규칙대로 짓습니다.
- 왜 AI 촌티의 해독제인가요?
- 에이전트는 훈련 데이터의 평균값으로 화면을 그려서, 누가 시켜도 비슷한 그라데이션과 보라색 카드를 내놓습니다. DESIGN.md를 쓰면 말로 취향을 설명하는 대신 검증된 제품의 규칙 체계를 통째로 이식할 수 있어요.
- 디자인 자산은 어디까지 추상화되나요?
- 부품 코드(shadcn 계열)를 조립하던 단계 다음이 규칙 파일입니다. 부품은 사람이 고르는 감각이 필요하지만, 규칙 파일은 에이전트가 화면 전체에 적용해요.
