From 5d984b9c8869d4e2408400fac3ba9c72680b82c9 Mon Sep 17 00:00:00 2001
From: Kyle Consalus <kyle.consalus@sentry.io>
Date: Thu, 20 Nov 2025 13:18:06 -0800
Subject: [PATCH] docs: Add update-migration script to AGENTS.md

Document the ./bin/update-migration script in the Database Operations
section. This script automates the process of resolving migration
conflicts after rebases by handling file renaming, dependency updates,
and lockfile updates.
---
 AGENTS.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index d621f10d104cca..f08bbf3f60adad 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -103,6 +103,10 @@ sentry django migrate
 # Create new migration
 sentry django makemigrations
 
+# Update migration after rebase conflict (handles renaming, dependencies, lockfile)
+./bin/update-migration <migration_name_or_number> <app_label>
+# Example: ./bin/update-migration 0101_workflow_when_condition_group_unique workflow_engine
+
 # Reset database
 make reset-db
 ```