From 8809105a7c5b4fb238997754aa25e07bbd4dd3f2 Mon Sep 17 00:00:00 2001
From: "sentry-junior[bot]"
 <264270552+sentry-junior[bot]@users.noreply.github.com>
Date: Tue, 3 Nov 2026 11:36:27 +0000
Subject: [PATCH] docs(settings): Add settings-v3 scopes note to
 static/AGENTS.md

Co-Authored-By: Priscila Andre de Oliveira <29228205+priscilawebdev@users.noreply.github.com>
---
 static/AGENTS.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/static/AGENTS.md b/static/AGENTS.md
index 5158f5393a88..feec3153e3d1 100644
--- a/static/AGENTS.md
+++ b/static/AGENTS.md
@@ -39,6 +39,13 @@
   `reactRouterBrowserTracingIntegration` and `wrapCreateBrowserRouter`.
 - Lazy load route components when possible
 
+### Settings Navigation
+
+- `useSettingsV3()` gates the new settings navigation (`organizations:settings-v3`). Keep the old behavior when it is off.
+- `useSettingsScope()` derives the scope (`org`, `project`, `account`) from the URL. `getSettingsScopeTitle` gives each scope's title.
+- Under v3, account pages appear only in the Account scope, never in the organization navigation.
+- Pass `settingsV3` to the navigation config functions (`getUserOrgNavigationConfiguration`, `getUserNavigationConfiguration`, `getNavigationConfiguration`), including from Cmd+K and other callers.
+
 ### Frontend API Calls
 
 Use `apiOptions` with `useQuery` from TanStack Query; **never** use the deprecated `useApiQuery`/`getApiQueryData`/`setApiQueryData`. `staleTime` is required. For the full guide (conditional fetching, no call-site generics, response headers/pagination) → use the **`frontend-data-fetching`** skill.