diff --git a/swift/ql/lib/change-notes/2025-10-22-swift-6.2-class-changes.md b/swift/ql/lib/change-notes/2025-10-22-swift-6.2-class-changes.md
new file mode 100644
index 00000000000..bc8b2140c9f
--- /dev/null
+++ b/swift/ql/lib/change-notes/2025-10-22-swift-6.2-class-changes.md
@@ -0,0 +1,6 @@
+---
+category: breaking
+---
+* The `OpenedArchetypeType` class has been renamed as `ExistentialArchetypeType`.
+* The `OtherAvailabilitySpec` class had been removed. Use `AvailabilitySpec::isWildcard` instead.
+* The `PlatformVersionAvailabilitySpec` has been removed. Use `AvailabilitySpec::getPlatform` and `AvailabilitySpec::getVersion` instead.
diff --git a/swift/ql/lib/change-notes/2025-10-22-swift-6.2.md b/swift/ql/lib/change-notes/2025-10-22-swift-6.2.md
new file mode 100644
index 00000000000..145037125dd
--- /dev/null
+++ b/swift/ql/lib/change-notes/2025-10-22-swift-6.2.md
@@ -0,0 +1,4 @@
+---
+category: majorAnalysis
+---
+* Upgraded to allow analysis of Swift 6.2.