diff --git a/BUILDING.md b/BUILDING.md
index 20c4082..e65180b 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -505,6 +505,14 @@ rm -rf ~/.gradle/caches/
 # Solution: Build the plugin module instead of the test app
 ./gradlew :plugin:assembleRelease
 
+# Problem: Build fails with "Cannot locate tasks that match ':android:assembleRelease'"
+# Solution: Use correct project name - available projects are:
+# - :app (test app, may have Capacitor issues)
+# - :plugin (plugin library, recommended)
+# - :capacitor-android
+# - :capacitor-cordova-android-plugins
+./gradlew :plugin:assembleRelease
+
 # Problem: Build fails with "Plugin with id 'kotlin-android' not found"
 # Solution: The plugin module doesn't need Kotlin plugin for Java/Kotlin code
 # Check the plugin/build.gradle file
@@ -518,6 +526,11 @@ rm -rf ~/.gradle/caches/
 # - npx cap update  
 # - npx cap add android
 
+# ⚠️  NOTE: npx cap sync will fail in plugin development projects!
+# This is expected - plugin projects don't have www/ directory
+# Error: "Could not find the web assets directory: ./www"
+# This is normal for plugin development projects
+
 # To fix after Capacitor operations:
 ./scripts/fix-capacitor-build.sh