/android-navigation

name: android-navigation
description: Implement screen routes and deep-link/App Link routing with Jetpack Compose Navigation on Android. Use when the primary task is Compose route configuration or external URL routing; defer typed-route APIs, XML/fragments, generic back-stack, and transition questions to their specific navigation skills.
metadata:
  triggers:
    files:
    - '**/*Screen.kt'
    - '**/*Activity.kt'
    - '**/NavGraph.kt'
    keywords:
    - NavController
    - NavHost
    - composable
    - navArgument
    - deepLinks

Android Navigation (Jetpack Compose)

**Priority: P2 (MEDIUM)**

Guidelines

• **Library**: Use `androidx.navigation:navigation-compose`.
• **Type Safety**: Use sealed classes for routes, never raw strings.
• **Deep Links**: Configure `intent-filter` in Manifest and `deepLinks` in NavHost.
• **Validation**: Validate arguments (e.g., proper IDs) before loading content.

Anti-Patterns

• **No String Routes**: Use `Screen.Product.route` instead of `"product/$id"`.
• **No Unvalidated Deep Links**: Check resource existence before rendering.
• **No Missing Manifest**: Deep links require `autoVerify=true` intent filters.

References

• [Navigation Patterns](references/navigation-patterns.md)