(airflow) branch main updated: Docs execution API version check via side effects in AGENTS.md (#71484)

[po...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git


The following commit(s) were added to refs/heads/main by this push:
     new 2a98049ea22 Docs execution API version check via side effects in AGENTS.md (#71484)
2a98049ea22 is described below

commit 2a98049ea2228d6470ae012dd14638fa5e54063e
Author: Jason(Zhe-You) Liu <68...@users.noreply.github.com>
AuthorDate: Thu Aug 13 19:50:09 2026 +0800

    Docs execution API version check via side effects in AGENTS.md (#71484)
---
 airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md b/airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md
index 4cacd2368ba..157fae64acc 100644
--- a/airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md
+++ b/airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md
@@ -32,6 +32,17 @@ uv run --active --group codegen --project apache-airflow-task-sdk --directory ta
 - Don't use keyword arguments with `endpoint()` — use positional: `endpoint("/path", ["GET"])`.
 - Don't add changes to already-released version files.
 - Don't forget response converters for new fields in nested objects.
+- Don't branch business logic by comparing the negotiated API version to a date/version string. For this case, subclass `VersionChangeWithSideEffects` for the version change and check its `is_applied` flag instead:
+
+  ```python
+  class AddArgBindingsToTIRunContext(VersionChangeWithSideEffects): ...
+
+
+  def _client_supports_arg_bindings() -> bool:
+      return AddArgBindingsToTIRunContext.is_applied
+  ```
+
+  See [Cadwyn's docs](https://docs.cadwyn.dev/concepts/version_changes/#version-changes-with-side-effects).
 
 ### Adding a New Feature End-to-End