navigation-designlisted
Install: claude install-skill dtsong/my-claude-setup
# Navigation Design
## Purpose
Design the navigation architecture for a mobile or cross-platform feature, including screen hierarchy, deep linking scheme, state preservation strategy, and transition animations.
## Scope Constraints
Reads feature requirements, user flows, and existing navigation code for architectural analysis. Does not modify files or execute code. Does not interact with app runtimes or navigation frameworks directly.
## Inputs
- Feature requirements and user flows
- Target platforms and framework (React Navigation, Flutter Navigator, SwiftUI NavigationStack)
- Existing navigation structure (if extending)
- Deep linking requirements (universal links, custom schemes)
## Input Sanitization
No user-provided values are used in commands or file paths. All inputs are treated as read-only analysis targets.
## Procedure
### Progress Checklist
- [ ] Step 1: Map the screen hierarchy
- [ ] Step 2: Define navigation patterns
- [ ] Step 3: Design deep linking scheme
- [ ] Step 4: State preservation strategy
- [ ] Step 5: Transition design
- [ ] Step 6: Edge case handling
### Step 1: Map the Screen Hierarchy
Identify all screens the feature requires. Organize into a hierarchy:
- **Root screens** (accessible from tab bar or drawer)
- **Stack screens** (pushed onto a navigation stack from a root)
- **Modal screens** (presented modally — confirmation dialogs, full-screen overlays)
- **Nested stacks** (sub-flows that have their own back history)
### Step 2: Define