# Organization Design System

이 디렉터리는 조직 차원의 디자인 원칙·취향·토큰·컴포넌트·패턴·페이지 아키타입과 릴리스 이력을 보존하는 정본이다. 프로젝트는 전체를 복제하지 않고 `releases/<version>.yaml`의 정확한 릴리스와 필요한 component/pattern subset, 그리고 명시적 delta만 연결한다.

`generated/DESIGN.md`, `registry.json`, `tokens.css`, `tailwind.tokens.json`, `tokens.dtcg.json`은 어댑터 산출물이다. 편집하지 않는다. 제품 전략·IA·와이어프레임의 정본은 각 프로젝트의 승인된 `experience-blueprint`와 `wireframe-set`이며, DESIGN.md가 이를 대신하지 않는다.

상태 승격은 `experimental → candidate → stable → deprecated`만 허용한다. 컴파일:

```bash
python3 .claude/hooks/compile_design_system.py
python3 .claude/hooks/compile_design_system.py --check
python3 .claude/hooks/compile_design_system.py --diff path/to/DESIGN.md
python3 .claude/hooks/design_registry.py --surface public-web --state stable
python3 .claude/hooks/design_registry.py --surface interactive-learning --state candidate
```

`interactive-learning`은 일반 public page의 별칭이 아니다. Atlas 탐색, 인과 학습 루프,
피드백·복귀 상태를 위한 별도 pattern/page-archetype 집합이며 workload profile에서도 독립
surface archetype으로 분류한다.

`--diff`는 전달된 DESIGN.md와 정본에서 다시 생성한 DESIGN.md의 unified diff를 출력한다.
프로젝트 구현은 `lint_design_system_adherence.py`에서 raw color뿐 아니라 동일 local component-id의
중복과 조직 release에 이미 있는 component의 무신고 로컬 재구현도 거부한다. 정당한 프로젝트 전용
확장은 `ui-design.design-system-bindings[].delta.components`에 명시한다.