docs: refresh runtime guidance

docs/terminology.md

@@ -51,19 +51,18 @@ Examples:
 
 ## Compatibility Rule
 
-Some API paths and fields still use legacy names:
+Some fields still use legacy names:
 
-- `/api/workspaces/{workspace_id}/agents/...`
 - `workspace_id` on approval records
 
-When reading those surfaces:
+Current API path rule:
 
-- design-time CRUD routes use `workspace_id` literally
-- runtime-read routes may use the same slot for `run_id`
+- design-time CRUD uses `/api/workspaces/{workspace_id}/...`
+- runtime agent assets use `/api/runs/{run_id}/agents/...`
 
 For new code:
 
-- prefer `runId` for runtime variables
+- prefer `runId` for runtime variables and runtime API paths
 - prefer `workspaceId` only for design-time registry flows
 
 ## UI Wording