diff --git a/guides/upgrades-migrations/administration/index.md b/guides/upgrades-migrations/administration/index.md
index 8e5c34f28..2d01354dc 100644
--- a/guides/upgrades-migrations/administration/index.md
+++ b/guides/upgrades-migrations/administration/index.md
@@ -15,3 +15,5 @@ These guides cover architectural changes and migration paths affecting Administr
 * [Vite migration](./vite)
 * [Vue migration build removal](./vue-migration-build)
 * [Native Vue implementation](./vue-native)
+
+For automated detection and fixing of supported Administration migration patterns, see the [Shopware CLI automatic refactoring](../../../products/tools/cli/automatic-refactoring.md) guide.
diff --git a/products/tools/cli/automatic-refactoring.md b/products/tools/cli/automatic-refactoring.md
index e2f508c06..157dc976d 100644
--- a/products/tools/cli/automatic-refactoring.md
+++ b/products/tools/cli/automatic-refactoring.md
@@ -102,6 +102,14 @@ shopware-cli project fix /path/to/your/project --allow-non-git
 
 By default, `project fix` requires a Git repository to safely track changes.
 
+### Administration migration rules
+
+The fixer also includes deterministic rules for known Administration migration patterns, including Administration Twig component migrations and component property or event changes. These rules apply when running `project fix` or `extension fix` as described above.
+
+The rules only cover cases where the old pattern and its replacement can be identified without ambiguity. They are not a general-purpose Administration migration engine and do not guarantee full compatibility with a target Shopware version. Manual review is still required for changes that are not covered by a deterministic rule.
+
+For manual migration guidance, see the [Administration migration guide](../../../guides/upgrades-migrations/administration/index.md).
+
 ## After running refactoring
 
 Use Git or your diff tool to review the changes.