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