diff --git a/db/docs/agent_activity_events.yml b/db/docs/agent_activity_events.yml
index d014ef1f114766b715c192e5627dada12f1a6021..56bd77dbd4caff2fd83138bbd743ef3972459bb9 100644
--- a/db/docs/agent_activity_events.yml
+++ b/db/docs/agent_activity_events.yml
@@ -7,4 +7,19 @@ feature_categories:
 description: Historical timeline events belonging to a cluster agent
 introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/74577
 milestone: '14.6'
-gitlab_schema: gitlab_main
+gitlab_schema: gitlab_main_cell
+allow_cross_joins:
+- gitlab_main_clusterwide
+allow_cross_transactions:
+- gitlab_main_clusterwide
+allow_cross_foreign_keys:
+- gitlab_main_clusterwide
+desired_sharding_key:
+  project_id:
+    references: projects
+    backfill_via:
+      parent:
+        foreign_key: agent_id
+        table: cluster_agents
+        sharding_key: project_id
+        belongs_to: agent
diff --git a/db/docs/cluster_agent_tokens.yml b/db/docs/cluster_agent_tokens.yml
index 36e843406b012fe086019827ad0c51db9f998a38..a4771e445c2f67cbbf4620c9491ab6f2cc3da040 100644
--- a/db/docs/cluster_agent_tokens.yml
+++ b/db/docs/cluster_agent_tokens.yml
@@ -7,4 +7,19 @@ feature_categories:
 description: Tokens used by cluster agents to connect to GitLab
 introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/33228
 milestone: '13.3'
-gitlab_schema: gitlab_main
+gitlab_schema: gitlab_main_cell
+allow_cross_joins:
+- gitlab_main_clusterwide
+allow_cross_transactions:
+- gitlab_main_clusterwide
+allow_cross_foreign_keys:
+- gitlab_main_clusterwide
+desired_sharding_key:
+  project_id:
+    references: projects
+    backfill_via:
+      parent:
+        foreign_key: agent_id
+        table: cluster_agents
+        sharding_key: project_id
+        belongs_to: agent
diff --git a/db/docs/deployment_clusters.yml b/db/docs/deployment_clusters.yml
index 011c5252593682f77a21bf252c617e024f3eaa84..dc79d50d718c12cda3b0d07828ccc60b59019d42 100644
--- a/db/docs/deployment_clusters.yml
+++ b/db/docs/deployment_clusters.yml
@@ -7,4 +7,19 @@ feature_categories:
 description: "(Deprecated) Join table between `deployments` and `clusters`"
 introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/24235
 milestone: '12.8'
-gitlab_schema: gitlab_main
+gitlab_schema: gitlab_main_cell
+allow_cross_joins:
+- gitlab_main_clusterwide
+allow_cross_transactions:
+- gitlab_main_clusterwide
+allow_cross_foreign_keys:
+- gitlab_main_clusterwide
+desired_sharding_key:
+  project_id:
+    references: projects
+    backfill_via:
+      parent:
+        foreign_key: deployment_id
+        table: deployments
+        sharding_key: project_id
+        belongs_to: deployment