60개 컴포넌트를 만들었는데 잘 쓰이고 있는지 모르겠어서 만든 디자인 시스템 디버깅 도구 이야기
두줄요약
AI 생성 코드의 디자인 시스템 사용 여부를 화면에서 검증하는 하이라이트 도구를 만들었습니다. data 속성, 범용 훅, 독립 패키지와 AI 스킬 설계를 소개합니다.
문제 상황
- AI 에이전트 생성 코드에서 디자인 시스템 컴포넌트 사용 여부를 화면만으로 판별하기 어려운 상황
- 직접 작성한 HTML 태그와 스타일링이 디자인 시스템 컴포넌트를 대체하는 일관성 저하 위험
구조와 흐름
data-yds-component,data-yds-slot메타데이터를querySelectorAll로 탐색하는 하이라이트 기반 검증 방식- Dynamic CSS의 inset
box-shadow와mouseover·closest()를 이용한 레이아웃 비침해형 윤곽선·툴팁 제공 - 완제품 컴포넌트, YDS 전용 훅, 범용 속성 하이라이트 훅으로 이어지는 3단계 Headless API
선택 이유
- 호스트 프로젝트의 Tailwind 설정과 분리하기 위한 인라인 스타일 기반 UI
- 다양한 번들러·테스트 환경 대응을 위한 ESM·CJS 듀얼 모듈 출력과 Next.js용
use client배너 주입 - 패키지 즉시 사용성과 Claude Code 스킬 기반 맞춤 도구 생성을 함께 제공하는 배포 방식
주의할 점
- 동적 CSS에 주입되는 속성명과 색상값의 정규식 검증을 통한 CSS Injection 방지
- 라이브러리형 개발 도구에서 소비처 CSS 파이프라인 의존성 최소화


