Add-to-app Android Projects are incompatible with AGP 9

src/content/add-to-app/android/project-setup.md

@@ -11,6 +11,11 @@ subproject or as AARs.
 The integration flow can be done using the Android Studio
 IDE with the [Flutter plugin][] or manually.
 
+:::warning **Do not update to AGP 9 if you are using Add-to-app.**
+
+The host app and Flutter module cannot properly sync when using AGP 9.
+For more details, see [Issue #180502][]. :::
+
 :::warning
 Your existing Android app might support architectures
 such as `mips` or `x86`. Flutter currently [only supports][]
@@ -509,3 +514,4 @@ Continue to the [Adding a Flutter screen to an Android app][] guide.
 [local repository]: https://docs.gradle.org/current/userguide/declaring_repositories.html#sub:maven_local
 [only supports]: /resources/faq#what-devices-and-os-versions-does-flutter-run-on
 [Using Flutter in China]: /community/china
+[Issue #180502]: {{site.github}}/flutter/flutter/issues/180502

src/content/release/breaking-changes/migrate-to-agp-9.md

@@ -137,16 +137,32 @@ your app's `<app-src>/android/gradle.properties` file.
 Execute `flutter run` to confirm that your app builds and
 launches on a connected Android device or emulator.
 
-## Timeline
+## Next Steps
 
-In stable release: TBD (for more details, see [Issue #179914][])
+**Current Status:** Add-to-app Android projects are currently
+incompatible with AGP 9: [Issue #180502][].
+This support is paused while the Flutter team migrates internal build logic
+from the deprecated AGP DSL to the new DSL.
+
+**Future Updates:** After the AGP DSL migration is complete,
+the following changes should occur:
+
+- **Remove DSL Gradle Property:** Once the Flutter team completes the migration
+to the new AGP DSL, you can remove `android.newDsl=false` from your
+`gradle.properties` file. The documentation will be updated to
+reflect that change.
+
+- **Full Add-to-app Support:** Full support for Add-to-app on AGP 9
+will be enabled upon completion of the DSL migration
+and potentially additional updates.
 
 ## References
 
 Relevant issues:
 
 - [Issue #175688][]: Audit flutter for compatibility with the AGP 9.0.0
 - [Issue #180137][]: Migrate from old to new AGP DSL
+- [Issue #180502][]: Add-to-app Android projects cannot sync with AGP 9
 
 The Gradle build files in your app vary based on the Flutter version 
 used when your app was created. 
@@ -159,3 +175,4 @@ in your app's directory.
 [Issue #179914]: {{site.github}}/flutter/flutter/issues/179914
 [Issue #175688]: {{site.github}}/flutter/flutter/issues/175688
 [Issue #180137]: {{site.github}}/flutter/flutter/issues/180137
+[Issue #180502]: {{site.github}}/flutter/flutter/issues/180502