Communitygithub.com

saltjsx/design-system-boss

앱 전체의 모호한 디자인 시스템 요청(예: 'UI가 엉망이니 고쳐줘', '디자인 시스템이 필요해', '색상이 하드코딩되어 있어', '버튼을 일관되게 만들어 줘', '배송 전에 확인해 줘')에 사용합니다. 특정 화면은 ui-review, 단일 컴포넌트는 component-docs, 토큰 보고서는 token-mapping으로 라우팅합니다. 아직 UI가 없는 저장소는 범위 외입니다.

design-system-boss란 무엇인가요?

Design System Boss는 기존 UI가 포함된 앱을 대상으로 디자인 시스템 관련 모호한 요청(예: 'UI 정리', '디자인 시스템 구축', '하드코딩된 색상 교체', '버튼 일관성 확보', '출시 전 검토')을 처리하는 AI 라우터 에이전트 스킬입니다. 이 스킬은 앱을 분석하여 요청에 가장 적합한 플레이북(playbook)을 선택하고, 그 단계를 `.design-system/state.md` 파일에 복사한 후 실행합니다. 특정 화면 리뷰는 `ui-review`, 단일 컴포넌트 문서화는 `component-docs`, 토큰 매핑 보고서는 `token-mapping`과 같은 전담 에이전트에게 작업을 위임합니다. 주요 기능은 요청 유형(화면 검토, 컴포넌트, 토큰 매핑, 시스템 구축, 마이그레이션)에 따라 미리 정의된 플레이북을 자동 실행하며, `build-design-system`, `migrate-design-system` 등 동료 스킬과 협력하여 일관된 워크플로우를 보장합니다. 사용자의 말, `AGENTS.md` 또는 `CLAUDE.md`, 저장된 메모리가 다른 모든 설정보다 우선합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/saltjsx/compassneo/tree/HEAD/.claude/skills/design-system-boss

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Design system boss

라우터입니다. 앱을 읽고, 하나의 플레이북을 매칭한 후, 그 단계를 그대로 .design-system/state.md에 복사하고 실행합니다. 중단된 단계는 skipped (<reason>)로 목록에 남깁니다. 단어와 기본 취향은 build-design-system/references/glossary.md와 build-design-system/references/taste.md에 있습니다. 사용자의 말, AGENTS.md 또는 CLAUDE.md, 저장된 메모리가 다른 모든 내용보다 우선합니다.

트리거

요청 또는 상태플레이북
명명된 화면 또는 플로우, "출시 전 확인"playbooks/review.md
하나의 컴포넌트playbooks/component.md
"토큰을 사용하고 있나요?", 어떤 값이 어디에 매핑되는지token-mapping, 플레이북 없음
"하드코딩된 값을 토큰으로 교체"build-design-system 3단계, token-mapping 이후
시스템 없음, 또는 드리프트, 마이그레이션에 관한 언급 없음playbooks/build.md
시스템 존재, 요청이 마이그레이션을 명시하지 않음playbooks/migrate.md, 감사 모드
시스템 존재, 요청이 마이그레이션을 명시함playbooks/migrate.md, 전체 모드

설치된 시스템이 진실 공급원이므로, 어떤 플레이북도 그 위에 시드하거나 빌드하지 않습니다. 상태가 요청과 불일치할 때 상태가 우선하며, 보고서에 그 사실을 명시합니다. PR 요청이나 다른 사람의 저장소인 경우 최소한의 설치 공간(토큰, 수정된 컴포넌트 및 화면, 저장소 자체 린트를 검사로 사용)을 의미합니다.

설정 (실행당 한 번)

.design-system/을 .git/info/exclude에 추가합니다. 쓰기 플레이북은 사용자가 지정한 브랜치를 사용하거나, 실행 브랜치를 생성하고 시작 브랜치를 .design-system/start-branch에 기록합니다. 감사 모드와 리뷰 및 컴포넌트 플레이북은 브랜치를 생성하지 않으며 .design-system/ 아래에만 기록합니다(컴포넌트 항목은 docs/system/에도 기록). 모든 질문은 기본값(취향, 디자인 출처, 파일럿 플로우)을 적용하여 한 번만 합니다. .design-system/roles.md(코디네이터, 작업자, 검증자, 리뷰어, 각각 모델 또는 inherit-parent)와 추가 전용 decisions.tsv를 작성합니다. 작성자는 스스로를 평가하지 않습니다.

절대 배포하지 않음

  • build-design-system의 금지 목록에 있는 모든 것: 요청하지 않은 푸시나 배포, 시작 브랜치에 대한 커밋, 스태시, 삭제된 퍼블릭 익스포트, 아무도 알리지 않은 건너뛴 단계.
  • 다른 에이전트를 시작할 수 있는 호스트에서 보스가 작성한 제품 코드.
  • "고쳐줘"에 대한 마이그레이션, 또는 트리거 행이 요청과 일치하지 않는 경우.
  • 완화된 중단 조건, 또는 형제의 검사 편집.
  • 아무도 선택하지 않은 시각적 방향. 출처 없는 "현대적으로 만들어"는 현재 모양을 기본값으로 하는 게이트가 됩니다.
  • 작업자가 실행 중인 상태의 핸드백, 또는 기본값이 있었던 질문 대기.
  • 동료 에이전트의 메시지를 사용자의 결정으로 처리.
  • build-design-system의 준비 감사가 열려 있는 동안의 마이그레이션.

형제 스킬

스킬담당
build-design-system토큰, 컴포넌트, 검사, 준비 상태
migrate-design-system앱 마이그레이션, 장애 학습, 마감 시 수정 패스
token-mapping원시 값 → 토큰, 읽기 전용
component-docs하나의 컴포넌트 항목
ui-review렌더링된 비평, 순위

migrate-design-system의 학습 내용은 해당 표면을 다루는 모든 브리핑에서 번호로 인용하세요.

완료

플레이북의 마지막 단계가 반환되었고, 보고서의 모든 숫자가 마감 시 실행된 명령어에서 비롯되었으며, 최종 메시지는 답변되지 않은 기본값, 변경된 사항, 그리고 발견되었지만 수정되지 않은 항목의 순위표(최대 30행)로 시작합니다. 중지 조건(저장소 없음, 거부된 도구 호출, git이 되돌릴 수 없는 단계)이 적용되는 경우, 완료된 내용과 실행을 차단 해제하는 가장 작은 응답을 명시하세요.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬