diff --git a/docs/decisions/0002-k0s-optional-workload-runtime.md b/docs/decisions/0002-k0s-optional-workload-runtime.md
index 77cbeaf..60ee655 100644
--- a/docs/decisions/0002-k0s-optional-workload-runtime.md
+++ b/docs/decisions/0002-k0s-optional-workload-runtime.md
@@ -40,9 +40,14 @@ API-only 描述的是运行拓扑，而不是 API 功能子集。其他组件仍
 API-only 实例测试真实 CRD、admission、watch 和 reconcile 行为，而不必先准备 CNI、
 worker 与完整 GitOps 环境。
 
-API-only 可以用于隔离的 API 实验、bootstrap 与恢复开发，但不构成独立的长期环境，也
-不是日常开发的默认路径。日常开发进程可以直接连接 managed runtime Dev 的 API。Flux、
-in-cluster service discovery、Pod 调度和 executor 集成仍然必须在 Dev 中验证。
+API-only 的主要用途是 CI 中的临时集成环境：每个 job 启动独立的真实 API server，安装
+CRD，运行待测试的 controller 二进制，完成后整体销毁。由于不启动 worker、CNI 和容器
+runtime，它适合验证 API、watch、admission、reconcile、finalizer 和 status 行为，而不必
+为每个测试任务建立完整 Kubernetes workload cluster。
+
+它也可以用于隔离 API 实验、bootstrap 与恢复开发，但不构成独立的长期环境，也不是日常
+本地开发的默认路径。日常开发进程直接连接 managed runtime Dev 的 API。Flux、in-cluster
+service discovery、Pod 调度和 executor 集成仍然必须在 Dev 中验证。
 
 ### Managed runtime
 
diff --git a/docs/decisions/0003-dev-api-development-loop.md b/docs/decisions/0003-dev-api-development-loop.md
index b3848be..8e97177 100644
--- a/docs/decisions/0003-dev-api-development-loop.md
+++ b/docs/decisions/0003-dev-api-development-loop.md
@@ -27,8 +27,16 @@ developer workstation
 修改代码后只需重新编译或由 file watcher 重启本地进程。只有进入真实部署集成验证时，
 才构建不可变镜像并交给 Dev GitOps 部署。
 
-API-only profile 仍然保留，但主要用于隔离 API 实验、bootstrap 和恢复开发；它不是为了
-每位开发者复制一个长期 local environment。
+API-only profile 仍然保留，但主要用于 CI 中按 job 创建的临时集成环境，也可以服务于
+隔离 API 实验、bootstrap 和恢复开发；它不是为了每位开发者复制一个长期 local
+environment。
+
+CI 根据测试范围选择环境：
+
+- controller/API 集成测试使用临时 API-only k0s；
+- 只涉及纯逻辑的测试不启动 Kubernetes；
+- 需要 Pod、Service、CNI、Flux 或 executor 的端到端测试部署到 managed runtime Dev，
+  或在具备相应能力的临时执行环境中运行。
 
 ## 单写入者约束