From 438d27b75bd57188dfcd7881dba149b394b19123 Mon Sep 17 00:00:00 2001 From: Francesco Giudici Date: Tue, 20 Oct 2026 09:04:48 +0000 Subject: [PATCH] AGENTS.md: experimental API compatibility policy Clarify that experimental APIs may change incompatibly without migration support. Signed-off-by: Francesco Giudici --- AGENTS.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index f9f93840af..aff300f138 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -245,6 +245,12 @@ Two manifest variants exist: - **Standard:** Production-ready features - **Experimental:** Features under development/testing (includes `ClusterObjectSet` API) +Experimental APIs may change incompatibly between releases. We do not provide migration support for +experimental API changes. +Stable APIs retain their compatibility guarantees, and bugs affecting supported production upgrades or +migrations must still be addressed. Experimental API changes must follow the API conventions and +regeneration requirements below. + ### API Conventions API changes in `api/v1/*_types.go` must follow the [OpenShift API conventions](https://github.com/openshift/enhancements/blob/master/dev-guide/api-conventions.md) in addition to upstream [Kubernetes API conventions](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md).