설정
플러그인 사용해보기
Design 플러그인에는 화면이나 PR을 토큰 파일 및 컴포넌트 인벤토리와 비교하도록 이미 구성된 /design-system이 포함되어 있습니다. 관리자가 플러그인을 관리하고 있고 아직 사용할 수 없다면 이 단계를 건너뛰세요. 아래 내용 중 이것이 필요한 것은 없습니다.
/design-systemAudit, document, or extend your design system./ux-copyWrite or review UX copy — microcopy, error messages, empty states, CTAs.도구 연결하기
Claude Cowork는 여러분의 시스템과 직접 연동될 때 더욱 강력해집니다. 권한과 접근 권한은 여러분이 직접 관리합니다. 도구 접근 권한에 대해 알아보기(새 탭에서 열림).
설정하려면 Cowork에서 Customize → Connectors로 이동하세요.
작업 폴더 설정하기
사용할 파일(프로덕션 스크린샷, 검토 중인 PR diff, 토큰 파일, 컴포넌트 인벤토리)을 컴퓨터의 한 폴더로 드래그한 다음, Cowork가 그 폴더를 가리키도록 설정하세요. Cowork는 그 폴더에서 읽고 드리프트 보고서를 다시 그 폴더에 작성합니다. 디자인 QA를 정기적으로 실행한다면, 해당 폴더에서 Cowork 프로젝트를 생성(새 탭에서 열림)하여 시스템 소스가 계속 연결되도록 하세요.
프롬프트
Claude Cowork에 이것을 복사하세요
이 폴더에 있는 배포된 화면과 열려 있는 PR을 우리 디자인 시스템과 대조하여 검토하세요. 각각에 대해 토큰, 컴포넌트, 간격, 또는 상호작용 패턴에서 벗어난 모든 부분을 나열하고, 심각도를 평가하고, 시스템에 맞는 수정안을 제안하세요. 이미 일치하는 항목은 건너뛰세요.
이것이 효과적인 이유
확인할 항목을 명확히 적으세요. 토큰, 컴포넌트, 간격, 상호작용: 체크리스트가 명확합니다.
각 발견 사항에 심각도를 요청하세요. 트리아지 담당자가 이번 스프린트에서 무엇을 고쳐야 할지 알 수 있습니다.
제외할 항목을 명시하세요. 보고서에는 작업 내용만 담기고 잡음은 담기지 않습니다.
참조 파일을 폴더에 넣으세요. 토큰과 인벤토리는 기억되는 것이 아니라 읽히는 것입니다.
더 나은 초안 얻기
맞춰야 할 예시를 추가하세요. 마음에 드는 예시를 폴더에 넣으면 Cowork가 여러분의 구조와 어조에 맞춥니다.
불확실한 부분을 표시하도록 요청하세요. "확신이 없는 부분은 표시해 주세요"를 추가하면 초안을 검토할 때 어디를 먼저 봐야 할지 알 수 있습니다.
Cowork를 여러분에게 맞게 활용하기
플러그인의 /design-system은 일반적인 출발점입니다. 2단계에서 실제로 PR에 게시할 만한 드리프트 보고서가 나오면, Cowork에게 여러분만의 스킬 버전을 작성하도록 요청하세요. 심각도 기준, 허용되는 예외, 컴포넌트-코드 매핑, 그리고 엔지니어들이 반응하는 댓글 어조를 추가하세요. 몇 분간의 대화만으로 이후부터는 스킬이 여러분의 기준에 맞춰 실행됩니다.
지금까지 이 작업에서 한 일을 스킬로 만들거나, 제 피드백을 반영해 /design-system 스킬을 수정해 주세요.
반복 가능하게 만들기
아티팩트로 공유하기
드리프트는 스프린트 사이에 조용히 누적됩니다. Cowork에게 보고서를 아티팩트로 게시하도록 요청하면 디자인 시스템 팀은 하나의 링크만 가지게 됩니다 — 스킬을 다시 실행하거나 새로고침되도록 예약할 수 있습니다.
그 드리프트 보고서를 design-system 채널용 아티팩트로 게시해 주세요. 아직 열려 있는 고심각도 항목의 누적 집계를 유지해 주세요.
UI에 영향을 주는 모든 PR에서 실행하기
드리프트는 병합 전에 잡는 것이 가장 비용이 적게 듭니다. 프롬프트에 /schedule을 입력하거나 Cowork 사이드바에서 Scheduled를 열어, 맞춤 설정한 스킬이 하루에 두 번 실행되어 열려 있는 PR과 최신 프로덕션 스크린샷을 확인하도록 설정하세요.
/schedule 평일 오전 10시와 오후 4시에, "ui" 라벨이 붙은 열려 있는 PR과 Design-QA/Sprint-42의 새 화면을 확인하고, 각각에 /design-system을 실행한 다음, 드리프트 보고서를 댓글로 게시하거나 #design-system에 게시해 주세요.
오전 10시와 오후 4시에 열려 있는 UI PR과 QA 폴더를 확인하고, /design-system을 실행한 다음, 드리프트 보고서를 PR 댓글로 게시하거나 #design-system에 게시합니다.
팀원과 공유하기
맞춤 설정한 /design-system에는 이제 여러분의 토큰, 컴포넌트 맵, 심각도 척도, 예외 목록이 담겨 있습니다. 모든 스쿼드가 모든 PR에서 동일한 리뷰를 받을 수 있도록 공유하면, 시스템 팀이 "이것이 시스템에 맞는지"를 판단하는 병목이 되지 않습니다.