diff --git a/README.md b/README.md
index cb66827..c7fb788 100644
--- a/README.md
+++ b/README.md
@@ -178,6 +178,7 @@ The PostgREST MCP server allows you to connect your own users to your app via RE
 ## Resources
 
 - [**Model Context Protocol**](https://modelcontextprotocol.io/introduction): Learn more about MCP and its capabilities.
+- [**From development to production**](/docs/production.md): Learn how to safely promote changes to production environments.
 
 ## License
 
diff --git a/packages/mcp-server-supabase/src/server.ts b/packages/mcp-server-supabase/src/server.ts
index a7d7fb5..3c0beb6 100644
--- a/packages/mcp-server-supabase/src/server.ts
+++ b/packages/mcp-server-supabase/src/server.ts
@@ -340,7 +340,7 @@ export function createSupabaseMcpServer(options: SupabaseMcpServerOptions) {
       }),
       apply_migration: tool({
         description:
-          'Applies a migration to the database. Use this when executing DDL operations.',
+          'Applies a migration to the database. Use this when executing DDL operations. Do not hardcode references to generated IDs in data migrations.',
         parameters: z.object({
           project_id: z.string(),
           name: z.string().describe('The name of the migration in snake_case'),