DESIGN.md, 에이전트가 자동으로 읽지 않는 이유

Published on

2026년 4월 24일

2026.03.18 Google Stitch 발표 기준
DESIGN.md alpha 스펙

DESIGN.md, 에이전트가 자동으로 읽지 않는 이유

Google Stitch가 2026년 3월 18일 공개한 DESIGN.md는 AI 코딩 에이전트에게 디자인 시스템을 전달하는 새로운 포맷입니다. 그런데 막상 써보면 “에이전트가 알아서 읽겠지”라는 기대가 빗나가는 경우가 생깁니다. 포맷의 실제 구조부터 에이전트 연결 방식, alpha 스펙의 리스크까지 공식 문서를 직접 확인하며 정리했습니다.

alpha

현재 스펙 버전

8개

공식 섹션 수

−3%

컨텍스트 파일 과잉 시 성공률 변화

+20%

LLM 생성 컨텍스트 파일 비용 증가

DESIGN.md가 뭔지, 한 줄로 정리하면

DESIGN.md는 디자인 시스템을 AI 코딩 에이전트가 읽을 수 있는 단일 텍스트 파일로 압축한 포맷입니다. Google Labs 공식 GitHub 레포지토리에는 이렇게 나와 있습니다. “DESIGN.md gives agents a persistent, structured understanding of a design system.” 한 번 만들어두면 프로젝트마다 디자인 룰을 처음부터 다시 설명할 필요가 없어집니다.

기존에도 디자인 토큰은 있었습니다. Figma Variables, tokens.json, Tailwind 테마 파
오늘 AI 채용하기
$9.9/월부터
대화

AGENTS.md, AI 코딩 에이전트, DESIGN.md, 디자인 시스템, Google Stitch

최신 글

“5세대 실손 계약재매입, 11월까지 없는 조건”
2026.05.04 기준 INSURANCE 5세대 실손 계약재매입,11월까지 없는 조건 5세대 실손보험이 5월 4일 출시됩니다. 그런데 기존 가입자가 전환 시 보상받는 ‘계약 재매입’은 11월로 밀렸습니다. 상품만 먼저 나오고 유인책은 6개월 뒤에 오는 구조입니다…. 자세히 보기: “5세대 실손 계약재매입, 11월까지 없는 조건”
노란우산공제 해지, 건보료가 4배 뛰는 조건
2026.04.24 기준 소득세법 제21조 · 건강보험법 시행령 제41조 기준 노란우산공제 해지,건보료가 4배 뛰는 조건 경영난에 어쩔 수 없이 해지했다가 건강보험료 고지서를 보고 당황하는 사례가 빠르게 늘고 있습니다. 2023~2025년 인천에서만 1만 2,729건,… 자세히 보기: 노란우산공제 해지, 건보료가 4배 뛰는 조건
DESIGN.md, 에이전트가 자동으로 읽지 않는 이유
2026.03.18 Google Stitch 발표 기준 DESIGN.md alpha 스펙 DESIGN.md, 에이전트가 자동으로 읽지 않는 이유 Google Stitch가 2026년 3월 18일 공개한 DESIGN.md는 AI 코딩 에이전트에게 디자인 시스템을 전달하는 새로운 포맷입니다. 그런데 막상… 자세히 보기: DESIGN.md, 에이전트가 자동으로 읽지 않는 이유
Claude Code Ultraplan, 내 요청이 어느 모드로 처리되는지 모릅니다
Claude Code v2.1.92+ 기준 2026.04.24 기준 Claude Code Ultraplan, 내 요청이어느 모드로 처리되는지 모릅니다 출시 직후부터 “새 요금제 등장이냐”는 반응이 쏟아졌습니다. 실제로는 구독 티어가 아니라 클라우드 기반 계획 기능입니다. 그런데 그… 자세히 보기: Claude Code Ultraplan, 내 요청이 어느 모드로 처리되는지 모릅니다
GPT-4o mini 파인튜닝, 쓸수록 더 나오는 비용 구조
2026.04.24 기준 · OpenAI API 공식 가격 기준 “GPT-4o mini 파인튜닝은 저렴하다”는 말이 맞습니다 — 학습을 돌리는 순간까지는요. 막상 만들어진 모델을 호출하기 시작하면 기본 모델보다 추론 비용이 2배 올라갑니다. 공식 가격… 자세히 보기: GPT-4o mini 파인튜닝, 쓸수록 더 나오는 비용 구조
Claude Opus 4.7 비용, 실제로 재봤습니다
2026.04.16 출시 기준 claude-opus-4-7 기준 IT/AI Claude Opus 4.7 비용, 실제로 재봤습니다 가격표엔 Opus 4.6과 똑같이 입력 $5/백만 토큰, 출력 $25/백만 토큰이라고 적혀 있습니다. 그런데 실제 청구서는 달랐습니다. 토크나이저 교체, xhigh… 자세히 보기: Claude Opus 4.7 비용, 실제로 재봤습니다
건강보험 임의계속가입, 실업급여 받으면 달라지는 조건
2026.04.24 기준 국민건강보험법 제110조 기준 건강보험 임의계속가입,실업급여 받으면 달라지는 조건 퇴사 후 “임의계속가입만 하면 보험료 걱정 없다”고 생각하기 쉽습니다. 실업급여를 받는 상황이라면 이 공식이 그대로 통하지 않는 지점이 있습니다. 신청 기한,… 자세히 보기: 건강보험 임의계속가입, 실업급여 받으면 달라지는 조건
본인부담상한제 환급, 이 경우엔 그냥 깎입니다
2026.03.12 건보법 개정 기준 보건복지부 공식 자료 참조 본인부담상한제 환급, 이 경우엔 그냥 깎입니다 병원비 많이 쓴 해엔 국가가 돌려준다고 알고 계신 분이 많습니다. 맞는 말이지만, 2026년 3월부터 그 환급금이 통보… 자세히 보기: 본인부담상한제 환급, 이 경우엔 그냥 깎입니다
애플 인텔리전스 한국어, 안 되는 기능이 있습니다
iOS 26.1 기준 · 2026.04.24 공식 문서 기반 애플 인텔리전스 한국어,안 되는 기능이 있습니다 2025년 3월 31일, iOS 18.4와 함께 애플 인텔리전스 한국어 지원이 시작됐습니다. 그런데 막상 써보면 “이게 왜 안… 자세히 보기: 애플 인텔리전스 한국어, 안 되는 기능이 있습니다
지역가입자 재산보험료 정률제, 더 내는 구간이 있습니다
2026.04.24 기준 건강보험 지역가입자 지역가입자 재산보험료 정률제,더 내는 구간이 있습니다 “정률제로 바뀌면 서민 부담이 줄어든다”는 말, 절반은 맞고 절반은 틀립니다. 재산 규모에 따라 오히려 보험료가 오르는 구간이 분명히 존재합니다. 법 개정… 자세히 보기: 지역가입자 재산보험료 정률제, 더 내는 구간이 있습니다