diff --git a/cliff.toml b/cliff.toml
index ac9de9e..72a1b36 100644
--- a/cliff.toml
+++ b/cliff.toml
@@ -1,4 +1,6 @@
 # Source: https://github.com/KooshaPari/phenotype-tooling/blob/main/templates/cliff.toml
+# Phenotype-org standard cliff.toml v2 (2026-06-11)
+# Changes from v1: adds ⚠️ **BREAKING** suffix for commits with `!` prefix
 # git-cliff config (Phenotype-org standard)
 # https://git-cliff.org/docs/configuration