diff --git a/packages/opencode/src/v2/storage/database.ts b/packages/opencode/src/v2/storage/database.ts
index 7ac5db016a..73f68ad9f8 100644
--- a/packages/opencode/src/v2/storage/database.ts
+++ b/packages/opencode/src/v2/storage/database.ts
@@ -25,6 +25,8 @@ export const layerForPath = (filename: string) =>
 
 export const layer = Layer.unwrap(
   Effect.sync(() => {
+    // TODO: Extract migration/bootstrap from the legacy Database.Client() so V2 storage
+    // can ensure the schema exists without opening the old global Drizzle connection.
     LegacyDatabase.Client()
     return layerForPath(LegacyDatabase.getPath())
   }),