sidebar-menu-arch

What problem does it solve?

This Skill helps you recognize, audit, and correctly modify the AppShellV2 sidebar architecture so that navigation stays consistent across modules, groups, permissions, and the frontend grouping contract.

Core Features & Use Cases

• Single-link sidebar items (v3 / ADR 0180): Ensure each module publishes exactly one sidebar destination via DataController::items() using href, not dropdown popups.
• Visual grouping via the frontend contract: Map module labels into canonical UI groups through SIDEBAR_GROUPS (and icons via MENU_ICON_MAP), so items land in the correct accordion group.
• Contextual sub-navigation via PageHeader ghosts (Zona C): Move “sub-items” into ghosts that become header tabs for the destination page, avoiding duplicated navigation patterns.
• Use cases: Add a new module entry to the sidebar, move an item between visual groups, debug why a module doesn’t appear, or audit ordering/permissions when an item is missing or falls back incorrectly.

Quick Start

Ask your AI to “Audit the sidebar for module X: verify its DataController::items() label matches SIDEBAR_GROUPS, confirm the sidebar uses href single-link with ghosts tabs (no popup dropdown), and list exactly which backend and frontend files must be updated.”