글. 오카무라 카에(Kylie) / 서비스웹개발팀
AI가 짠 코드, 정말 디자인 시스템을 쓰고 있을까요?
저희 조직은 현재 전사적으로 AI 에이전트 기반 개발을 적극적으로 도입하고 있습니다. Claude Code에 “이 화면을 YDS 컴포넌트를 잘 활용해서 구현해줘”라고 명령만 내리면 에이전트가 척척 코드를 작성해 줍니다.
하지만 여기서 한 가지 문제가 생겼습니다.
에이전트가 정말 디자인 시스템 컴포넌트를 사용했는지 완성된 화면만 봐서는 알 수가 없다는 점입니다.
사람이 직접 코드를 작성할 때는 “내가 직접 BoxButton을 import해서 썼다”는 것을 본인이 정확히 인지합니다. 하지만 AI 에이전트가 짠 코드는 다릅니다. 결과물 화면이 시안대로 잘 렌더링되면 아무 의심 없이 넘어가기 십상입니다.
하지만 막상 코드를 열어보면 엉뚱한 경우가 종종 있습니다. YDS 컴포넌트를 가져다 쓴 게 아니라 <button className=”…”> 같은 방식으로 직접 태그를 만들고 스타일링을 입혀놓은 것입니다. 겉보기에는 완벽하게 똑같아 보이지만 속은 완전히 다릅니다.
그렇다고 매번 일일이 코드를 열어 import 경로를 확인하는 것은 너무나 비효율적인 일입니다. 에이전트가 생성해 내는 코드의 양이 많아질수록 이 문제는 더욱 커집니다.
결국 화면을 보는 것만으로도 “여기는 디자인 시스템 컴포넌트고, 저기는 아니다”를 직관적으로 빠르게 판별할 수 있는 시각적 검증 도구가 절실히 필요했습니다.
한 줄의 메타데이터에서 시작된 변화
data 속성이라는 뜻밖의 자산
해결의 실마리는 이미 코드 안에 있었습니다. YDS의 모든 컴포넌트는 루트 요소에 다음과 같은 속성을 포함하고 있습니다.
<button data-yds-component="BoxButton">
<span data-yds-slot="content">
<span data-yds-slot="prefix-icon">...</span>
버튼 텍스트
</span>htnml
</button>data-yds-component는 컴포넌트 이름을, data-yds-slot은 하위 파트 이름을 담는 HTML5 표준 Custom Data Attributes입니다. 브라우저가 무시하고, 렌더링에 영향을 주지 않으며 접근성에도 영향을 주지 않는 순수한 메타데이터입니다.
그런데 이 속성에는 의도하지 않았던 잠재력이 있었습니다.
document.querySelectorAll('[data-yds-component]')
// → 이 페이지의 모든 YDS 컴포넌트가 추출된다페이지에서 YDS 컴포넌트만 프로그래밍적으로 골라낼 수 있다는 것. 디버깅 도구의 토대가 이미 코드 안에 준비되어 있었던 셈입니다.
프로토타입: 40줄짜리 훅 만들기
아이디어 자체는 매우 단순했습니다. [data-yds-component]를 가진 모든 DOM 요소에 빨간 테두리를 씌우고, 마우스를 올리면 해당 컴포넌트의 이름을 툴팁으로 보여주자는 것이었습니다.
핵심은 useHighlightDevTools라는 훅 하나였습니다. 이 훅이 하는 일은 크게 두 가지입니다.
1) Dynamic CSS 주입
const style = document.createElement('style');
style.textContent = `
[data-yds-component] {
box-shadow: inset 0 0 0 2px rgba(239, 68, 68, 0.7) !important;
}
`;
document.head.appendChild(style);도구를 활성화하면 <style> 태그를 <head>에 삽입하고 비활성화하면 제거하는 방식입니다.
여기서 border나 outline 대신 inset box-shadow를 사용한 이유가 있습니다. border는 요소의 실제 크기를 변경하고, outline은 경우에 따라 레이아웃 시각 효과를 교란할 수 있습니다. 반면 i


