diff --git a/fastvideo/workflows/__init__.py b/fastvideo/workflows/__init__.py
index e8207a7b2..1578a3905 100644
--- a/fastvideo/workflows/__init__.py
+++ b/fastvideo/workflows/__init__.py
@@ -1,2 +1,7 @@
 # SPDX-License-Identifier: Apache-2.0
-"""Reusable multi-step generation workflows."""
+"""Reusable multi-step generation workflows.
+
+EXPERIMENTAL: this package has no API stability promise yet. Interfaces
+may change between releases without deprecation while the training-side
+counterpart (planner/critic post-training) lands.
+"""