design-system은(는) 무엇을 하나요?
익숙하지 않은 플레이스홀더가 보이거나 연결된 도구를 확인해야 하는 경우 CONNECTORS.md를 참조하세요.
디자인 시스템을 관리하세요 — 일관성 감사, 컴포넌트 문서화, 새로운 패턴 설계.
사용법
/design-system audit # 전체 시스템 감사
/design-system document [component] # 컴포넌트 문서화
/design-system extend [pattern] # 새 컴포넌트나 패턴 설계
디자인 시스템의 구성 요소
디자인 토큰
시각적 언어를 정의하는 기본 값:
- 색상 (브랜드, 의미, 중립)
- 타이포그래피 (스케일, 굵기, 줄 높이)
- 간격 (스케일, 컴포넌트 패딩)
- 테두리 (반경, 두께)
- 그림자 (높이 레벨)
- 모션 (지속 시간, 이징)
컴포넌트
재사용 가능한 UI 요소로 다음이 정의됨:
- 변형 (기본, 보조, 고스트)
- 상태 (기본, 호버, 활성, 비활성, 로딩, 오류)
- 크기 (sm, md, lg)
- 동작 (상호작용, 애니메이션)
- 접근성 (ARIA, 키보드)
패턴
컴포넌트를 결합한 일반적인 UI 솔루션:
- 폼 (입력 그룹, 유효성 검사, 제출)
- 내비게이션 (사이드바, 탭, 브레드크럼)
- 데이터 표시 (테이블, 카드, 목록)
- 피드백 (토스트, 모달, 인라인 메시지)
원칙
- 일관성이 창의성보다 우선 — 시스템은 팀이 바퀴를 재발명하지 않도록 존재합니다.
- 제약 내에서의 유연성 — 컴포넌트는 구성 가능해야 하며, 고정적이지 않아야 합니다.
- 모든 것을 문서화 — 문서화되지 않은 것은 존재하지 않습니다.
- 버전 관리 및 마이그레이션 — 호환성을 깨는 변경은 마이그레이션 경로가 필요합니다.
출력 — 감사
## 디자인 시스템 감사
### 요약
**검토된 컴포넌트:** [X] | **발견된 문제:** [X] | **점수:** [X/100]
### 명명 일관성
| 문제 | 컴포넌트 | 권장 사항 |
|-------|------------|----------------|
| [일관성 없는 명명] | [목록] | [채택할 표준] |
### 토큰 적용 범위
| 카테고리 | 정의됨 | 발견된 하드코딩 값 |
|----------|---------|----------------------|
| 색상 | [X] | [X]개의 하드코딩된 hex |
| 간격 | [X] | [X]개의 임의 값 |
| 타이포그래피 | [X] | [X]개의 사용자 정의 글꼴/크기 |
### 컴포넌트 완성도
| 컴포넌트 | 상태 | 변형 | 문서 | 점수 |
|-----------|--------|----------|------|-------|
| 버튼 | ✅ | ✅ | ⚠️ | 8/10 |
| 입력 | ✅ | ⚠️ | ❌ | 5/10 |
### 우선 조치 사항
1. [가장 영향력 있는 개선]
2. [두 번째 우선순위]
3. [세 번째 우선순위]
출력 — 문서
## 컴포넌트: [이름]
### 설명
[이 컴포넌트가 무엇이며 언제 사용하는지]
### 변형
| 변형 | 사용 시기 |
|---------|----------|
| [기본] | [주요 작업] |
| [보조] | [지원 작업] |
### 속성
| 속성 | 유형 | 기본값 | 설명 |
|----------|------|---------|-------------|
| [속성] | [유형] | [기본값] | [설명] |
### 상태
| 상태 | 시각 | 동작 |
|-------|--------|----------|
| 기본 | [설명] | — |
| 호버 | [설명] | [상호작용] |
| 활성 | [설명] | [상호작용] |
| 비활성 | [설명] | 상호작용 불가 |
| 로딩 | [설명] | [애니메이션] |
### 접근성
- **역할**: [ARIA 역할]
- **키보드**: [Tab, Enter, Escape 동작]
- **스크린 리더**: [...
### 권장 사항 및 금지 사항
| ✅ 해야 할 일 | ❌ 하지 말아야 할 일 |
|------|---------|
| [모범 사례] | [안티패턴] |
### 코드 예제
[프레임워크에 맞는 코드 스니펫]
출력 — 확장
## 새 컴포넌트: [이름]
### 문제
[이 컴포넌트가 해결하는 사용자 니즈 또는 갭]
### 기존 패턴
| 관련 컴포넌트 | 유사성 | 부족한 점 |
|-------------------|-----------|---------------------|
| [컴포넌트] | [공유되는 점] | [누락된 점] |
### 제안된 설계
#### API / 속성
| 속성 | 유형 | 기본값 | 설명 |
|----------|------|---------|-------------|
| [속성] | [유형] | [기본값] | [설명] |
#### 변형
| 변형 | 사용 시기 | 시각 |
|---------|----------|--------|
| [변형] | [시나리오] | [설명] |
#### 상태
| 상태 | 동작 | 참고 |
|-------|----------|-------|
| 기본 | [설명] | — |
| 호버 | [설명] | [상호작용] |
| 비활성 | [설명] | 상호작용 불가 |
| 로딩 | [설명] | [애니메이션] |
#### 사용된 토큰
- 색상: [어떤 토큰]
- 간격: [어떤 토큰]
- 타이포그래피: [어떤 토큰]
### 접근성
- **역할**: [ARIA 역할]
- **키보드**: [예상되는 상호작용]
- **스크린 리더**: [...
### 미해결 질문
- [디자인 검토가 필요한 결정]
- [해결해야 할 엣지 케이스]
커넥터가 연결된 경우
~~디자인 도구가 연결된 경우:
- Figma에서 직접 컴포넌트 감사 — 명명, 변형 및 토큰 사용 확인
- 문서 작성을 위해 컴포넌트 속성 및 레이어 구조 가져오기
~~지식 베이스가 연결된 경우:
- 기존 컴포넌트 문서 및 사용 지침 검색
- 업데이트된 문서를 위키에 게시
팁
- 감사로 시작하세요 — 어디로 갈지 결정하기 전에 현재 위치를 파악하세요.
- 만들면서 문서화하세요 — 컴포넌트를 설계하는 동안 문서화하는 것이 더 쉽습니다.
- 완벽보다 적용 범위를 우선시하세요 — 10개 컴포넌트의 100%보다 80% 컴포넌트 문서화가 낫습니다.