# Design-MD 라이브러리 — 기여 가이드

> **목적**: 새로운 디자인 시스템 레퍼런스(DESIGN.md) 추가 시 반드시 준수해야 하는 저작권/스타일 유사도 가이드.
> **버전**: v1.0 (2026-05-03, IDS Phase 4 task-2390)
> **참조**: IDS 마스터플랜 §0.3 Style Extraction Allowed Range

---

## 1. 추출 기준 (Extraction Criteria)

### 허용 (✅ Allowed)
- 디자인 토큰: color (HEX), typography (font-family + size scale), spacing scale, border-radius, shadow scale
- 레이아웃 패턴 영감: 그리드 구조, 섹션 구성 — 코드 직접 복사 X
- 컴포넌트 스타일링 영감: button/card/input의 시각적 특성 기술 — 실제 코드 복제 X
- 퍼블릭 브랜드 컬러
- 공식 폰트 패밀리명 (폰트 파일 미포함)

### 금지 (❌ Forbidden)
- **70% 이상 직접 복제**: difflib SequenceMatcher 기준 ≥ 0.70 → **자동 차단**
- 컴포넌트 코드 직접 복사 (React/Vue/HTML 소스 토큰화 없이 사용)
- 유료 폰트 파일 포함
- 이미지 자산 직접 복사
- 비공개 디자인 시스템

---

## 2. 자동 차단 조건 (Automated Block Conditions)

| 조건 | 측정 방법 | 임계값 |
|---|---|---|
| 직접 복제 비율 | `difflib.SequenceMatcher().ratio()` | ≥ 0.70 |
| 단일 소스 의존도 | 1개 사이트에서 추출한 토큰 비율 | ≥ 90% |
| 라이센스 미명시 | `LICENSE` 파일 누락 | open-design 추출분에 한해 필수 |
| 컴포넌트 코드 직접 복사 | `<script>`, `<style>`, JSX/TSX 블록 발견 | 1건 이상 |

---

## 3. 라이센스 보존 의무 (License Preservation)

### open-design 저장소 (Apache-2.0) 추출분
- 각 브랜드 폴더에 `LICENSE` 파일을 함께 저장
- DESIGN.md 상단에 출처 명시 (Apache-2.0 라이센스 표시)

### 자체 작성 (insane-design 자동 생성 또는 수기 작성)
- 출처: "Inspired by {brand}.com, abstracted by Insuro Design System"
- 별도 LICENSE 파일 불필요

---

## 4. 출처 명시 표준 (Attribution Standard)

DESIGN.md 마지막 또는 상단에 출처 블록 추가:
```
> **출처**: Inspired by {brand}.com / brand identity, abstracted by Insuro Design System
> **추출 범위**: 디자인 토큰 + 레이아웃 영감 (코드 직접 복제 0%)
```

---

## 5. 기여 워크플로우 (Contribution Workflow)

1. 신규 브랜드 디렉토리 생성: `resources/design-md/{brand-slug}/`
2. `DESIGN.md` 작성 (TEMPLATE.md 기반, 8 섹션 표준)
3. 저작권 검사 (70% 복제율 자동 검증)
4. INDEX.md에 카테고리 항목 추가 (7 카테고리 중 1개 이상)
5. PR 생성 → Gemini 리뷰 → 머지

---

## 6. 표준 8 섹션 (Required Sections)

1. Visual Theme & Atmosphere
2. Color Palette & Roles (모두 HEX)
3. Typography Rules
4. Component Stylings (CSS)
5. Layout Principles
6. Depth & Elevation
7. Do's and Don'ts
8. Agent Prompt Guide

---

## 7. 7 카테고리 분류

- `insurance/finance` — 보험/금융
- `b2b` — SaaS / 협업
- `b2c` — 소비자
- `luxury` — 럭셔리
- `tech` — 기술/AI/Infra
- `minimal` — 미니멀/콘텐츠
- `korean` — 한국 브랜드

---

## 8. 회장 정책 준수

- 외부 API 직접 호출 금지 — Claude Code/Gemini CLI/Codex CLI 통합 경로만 사용
- 한글 100% 정확도 보장 (Pretendard, Noto Sans KR, Apple SD Gothic Neo 우선)
- task-2381 sync hook + task-2387 archived 가드 보존 의무

---

## 참조

- IDS 마스터플랜: `memory/plans/insuro-design-system/plan.md` v1.1
- 컨텍스트 노트: `memory/plans/insuro-design-system/context-notes.md`
- 회장 정책 정정: 2026-05-03
- open-design v0.2.0: https://github.com/nexu-io/open-design (Apache-2.0)