Skip to content

Align agent guidance with Navigation 3#2105

Open
jelychow wants to merge 2 commits intoandroid:mainfrom
jelychow:codex/update-agents-navigation
Open

Align agent guidance with Navigation 3#2105
jelychow wants to merge 2 commits intoandroid:mainfrom
jelychow:codex/update-agents-navigation

Conversation

@jelychow
Copy link
Copy Markdown

@jelychow jelychow commented May 7, 2026

Summary

  • Update the root AGENTS.md architecture note from Jetpack Navigation 2 for Compose to Navigation 3.
  • Mention the current NavKey back stacks, NavDisplay rendering, and adaptive navigation scenes reflected in the source.

Verification

  • git diff --check -- AGENTS.md
  • rg confirmed androidx.navigation3 imports, NavDisplay usage, and the updated AGENTS.md text

Notes

  • Full Gradle build not run; this is a documentation-only change.

The root agent guidance still described Navigation 2 for Compose, but the app now uses the Navigation 3 APIs with NavKey state, NavDisplay, and adaptive scene strategies. Update the architecture note so future agents follow the codebase that is actually present.

Constraint: Documentation-only correction for AGENTS.md

Rejected: Mention Jetpack Navigation 2 compatibility | the implementation imports androidx.navigation3 and renders with NavDisplay

Confidence: high

Scope-risk: narrow

Tested: git diff --check -- AGENTS.md

Tested: rg confirmed androidx.navigation3 imports, NavDisplay usage, and AGENTS.md no longer references Navigation 2 for Compose

Not-tested: Full Gradle build not run because this is a documentation-only change
@jelychow jelychow requested a review from dturner as a code owner May 7, 2026 09:58
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the AGENTS.md documentation to reflect the transition from Jetpack Navigation 2 to Jetpack Navigation 3, incorporating components like NavKey-based back stacks and NavDisplay. The review feedback suggests refining the description to retain architectural descriptors such as 'state-driven' and 'type-safe' to provide better guidance and improved phrasing.

Comment thread AGENTS.md Outdated
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant