diff --git a/packages/env/src/workspace/legacy-cloud/index.ts b/packages/env/src/workspace/legacy-cloud/index.ts
index 268c885206..fae7c93810 100644
--- a/packages/env/src/workspace/legacy-cloud/index.ts
+++ b/packages/env/src/workspace/legacy-cloud/index.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import { z } from 'zod';
 
 export interface User {
diff --git a/packages/workspace/src/affine/api/index.ts b/packages/workspace/src/affine/api/index.ts
index f8b11d0f3d..9085b93a45 100644
--- a/packages/workspace/src/affine/api/index.ts
+++ b/packages/workspace/src/affine/api/index.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import { MessageCode, Messages } from '@affine/env/constant';
 import type {
   AcceptInvitingParams,
diff --git a/packages/workspace/src/affine/api/status.ts b/packages/workspace/src/affine/api/status.ts
index fc0cbbe765..b636141f2c 100644
--- a/packages/workspace/src/affine/api/status.ts
+++ b/packages/workspace/src/affine/api/status.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 export function createStatusApis(prefixUrl = '/') {
   return {
     healthz: async (): Promise<boolean> => {
diff --git a/packages/workspace/src/affine/atom.ts b/packages/workspace/src/affine/atom.ts
index 413e2f1904..51cb227101 100644
--- a/packages/workspace/src/affine/atom.ts
+++ b/packages/workspace/src/affine/atom.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import { atomWithStorage } from 'jotai/utils';
 
 import type { AccessTokenMessage } from '../affine/login';
diff --git a/packages/workspace/src/affine/channel.ts b/packages/workspace/src/affine/channel.ts
index 30b47a9773..ca75b78e85 100644
--- a/packages/workspace/src/affine/channel.ts
+++ b/packages/workspace/src/affine/channel.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import { DebugLogger } from '@affine/debug';
 import { WorkspaceFlavour } from '@affine/env/workspace';
 import { assertExists } from '@blocksuite/global/utils';
diff --git a/packages/workspace/src/affine/keck/handler.ts b/packages/workspace/src/affine/keck/handler.ts
index d19d664a65..bcd92478f5 100644
--- a/packages/workspace/src/affine/keck/handler.ts
+++ b/packages/workspace/src/affine/keck/handler.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import * as decoding from 'lib0/decoding';
 import * as encoding from 'lib0/encoding';
 import * as awarenessProtocol from 'y-protocols/awareness';
diff --git a/packages/workspace/src/affine/keck/index.ts b/packages/workspace/src/affine/keck/index.ts
index 63fb88fcc2..542d42fb07 100644
--- a/packages/workspace/src/affine/keck/index.ts
+++ b/packages/workspace/src/affine/keck/index.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import { isBrowser } from '@affine/env/constant';
 import * as encoding from 'lib0/encoding';
 import * as math from 'lib0/math';
diff --git a/packages/workspace/src/affine/keck/processor.ts b/packages/workspace/src/affine/keck/processor.ts
index 0593744cd1..d815227977 100644
--- a/packages/workspace/src/affine/keck/processor.ts
+++ b/packages/workspace/src/affine/keck/processor.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import * as decoding from 'lib0/decoding';
 import * as encoding from 'lib0/encoding';
 
diff --git a/packages/workspace/src/affine/login.ts b/packages/workspace/src/affine/login.ts
index b115c2ebf0..05fda728b3 100644
--- a/packages/workspace/src/affine/login.ts
+++ b/packages/workspace/src/affine/login.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import { DebugLogger } from '@affine/debug';
 import { assertExists } from '@blocksuite/global/utils';
 import { Slot } from '@blocksuite/store';
diff --git a/packages/workspace/src/affine/shared.ts b/packages/workspace/src/affine/shared.ts
index 229d71ca22..143103cd89 100644
--- a/packages/workspace/src/affine/shared.ts
+++ b/packages/workspace/src/affine/shared.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import { setupGlobal } from '@affine/env/global';
 import { rootStore } from '@toeverything/plugin-infra/manager';
 
diff --git a/packages/workspace/src/affine/sync.ts b/packages/workspace/src/affine/sync.ts
index f12ea9e013..10a24b47ad 100644
--- a/packages/workspace/src/affine/sync.ts
+++ b/packages/workspace/src/affine/sync.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import { DebugLogger } from '@affine/debug';
 import type { WorkspaceCRUD } from '@affine/env/workspace';
 import type { WorkspaceFlavour } from '@affine/env/workspace';
diff --git a/packages/workspace/src/providers/affine-download.ts b/packages/workspace/src/providers/affine-download.ts
index 615dfd5cf1..d11aa0bf34 100644
--- a/packages/workspace/src/providers/affine-download.ts
+++ b/packages/workspace/src/providers/affine-download.ts
@@ -1,3 +1,6 @@
+/**
+ * @deprecated Remove this file after we migrate to the new cloud.
+ */
 import { DebugLogger } from '@affine/debug';
 import type { AffineDownloadProvider } from '@affine/env/workspace';
 import type { DocProviderCreator } from '@blocksuite/store';