Merge branch 'pula'

Author: MihaiCristianCondrea

AGENTS.md

@@ -14,11 +14,32 @@ You are an experienced Android app developer.
 - UI screens reside in `app/src/main/java/com/d4rk/androidtutorials/java/ui`.
 - Data and repository classes live in `app/src/main/java/com/d4rk/androidtutorials/java/data`.
 
-## Testing
-- Run `./gradlew test` before committing changes.
-
 ## Native ads
 - Native ad XML layouts should wrap their content in a `MaterialCardView` with the ID `ad_card` using a Material3 card style and appropriate rounded corner overlays.
 - Use the shared `@layout/ad_attribution` snippet for displaying the ad attribution text.
 - Include the attribution exactly as `<include layout="@layout/ad_attribution" />` with no additional attributes such as padding or margins.
 - Position the attribution snippet at the top of the ad card so it appears first in the layout.
+
+## Architecture and principles
+@./docs/core/
+
+## UI/UX guidelines
+@./docs/ui-ux/
+
+## Coroutines and Flow
+@./docs/coroutines-flow/
+
+## Compose rules
+@./docs/compose/
+
+## Testing guidelines
+@./docs/tests/
+
+## General policies
+@./docs/general/
+
+# General app and libraries used documentation
+@./docs/screens/
+
+## Testing
+- Run `./gradlew test` before committing changes.

README.md

@@ -53,7 +53,7 @@ operations through a small set of use cases. This pattern was inspired by the
 implemented in a simplified form to avoid adding heavy dependencies. The result keeps the UI
 simple and ensures a clear separation of concerns across the whole app.
 
-For detailed guidance, see [Recommendations for Android architecture](docs/android-architecture-recommendations.md).
+For detailed guidance, see [Recommendations for Android architecture](docs/core/android-architecture-recommendations.md).
 
 ## Feedback