From 18aa3eda0fe9e36b260ac906fb6be3595ca23bec Mon Sep 17 00:00:00 2001 From: Morgan Wowk Date: Thu, 6 Aug 2026 15:48:50 -0700 Subject: [PATCH] docs: tell agents to keep platform specifics out of the generic core Add a repo-root CLAUDE.md with the rule the orchestrator and launcher interface are built on: the generic core stays platform-agnostic; platform-specific classification lives in the concrete launcher and reaches the orchestrator as a typed LauncherError. Co-authored-by: Morgan Wowk --- CLAUDE.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..fa513bc --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,11 @@ +# Agent notes + +## Keep platform specifics out of the generic core + +The orchestrator (`cloud_pipelines_backend/orchestrator_sql.py`) and the launcher +interface (`cloud_pipelines_backend/launchers/interfaces.py`) are +platform-agnostic. Do not put Kubernetes, HTTP, or cloud-SDK details in them. + +Platform logic belongs in the concrete launcher (e.g. `kubernetes_launchers.py`), +which turns backend failures into typed `LauncherError`s. The orchestrator acts +on the typed error, never on a raw status code.