service-catalog/update_catalog/skills/breaking_change_check/SKILL.md

name, description, user-invokable

name	description	user-invokable
breaking_change_check	Determine breaking changes from Structured Diff JSON using deterministic rules.	false

breaking_change_check (Skill)

Rule-engine based breaking change detector.

Input schema

{
  "diff_json": "object",
  "custom_values": "object (optional)"
}

custom_values가 제공되면 values_key_removed 판단 시 custom-values.yaml에서 실제 사용 중인 key만 breaking으로 분류하고, 나머지는 warnings로 기록한다. 제공되지 않으면 제거된 모든 key를 breaking으로 판단한다.

Breaking 판단 기준

rule	severity	breaking 조건
values_key_removed	high	custom-values.yaml에 해당 key가 존재하는 경우
values_type_changed	high	항상
resource_removed	high	항상
service_port_changed	high	항상
dependency_major_changed	high	항상 (sub-chart 내부 breaking 가능)

breaking = severity in ("high", "critical")

Output schema

{
  "breaking": "boolean",
  "severity": "critical|high|medium|warning",
  "reasons": "array",
  "warnings": "array"
}