# KBX v12 — Release Governance

## Foundation iteration과 KBX contract version 분리

`Foundation v12`는 구현 기반의 내부 진화 번호다.
KBX UX Contract의 호환성 버전과 동일한 개념으로 사용하지 않는다.

현재 첨부 기준 문서의 Contract는 `v1.0`으로 취급한다.

## 자동 영향도

CI는 이전 baseline과 다음을 비교한다.

- Screen Manifest
- Component Manifest
- Token Manifest

판정:

| 변경 | 최소 영향 |
|---|---|
| Component/Screen/Token 제거 | major |
| Component/Screen/Token 신규 공개 | minor |
| Component major version 증가 | major |
| Component minor version 증가 | minor |
| Component patch version 증가 | patch |
| Semantic/Component Token 값 변경 | patch + visual-risk |
| 공개 계약 변화 없음 | none |

개발자가 `declaredChangeLevel`을 실제 요구 수준보다 낮게 선언하면 CI가 실패한다.

## Breaking Change

Major가 필요하면 `docs/release/migration-guide.md`가 반드시 존재해야 한다.

## 목적

Version 숫자를 형식적으로 관리하는 것이 아니라 다음 질문에 답하기 위함이다.

- 기존 화면이 깨지는가?
- 기존 사용자 동작이 달라지는가?
- 기존 Figma Component/Variant가 깨지는가?
- 기존 Grid/Lookup/Keyboard 계약을 Migration해야 하는가?
