이 디렉터리는 조직 차원의 디자인 원칙·취향·토큰·컴포넌트·패턴·페이지 아키타입과 릴리스 이력을 보존하는 정본이다. 프로젝트는 전체를 복제하지 않고 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만 허용한다. 컴파일:

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에 명시한다.