Individual skill

ios-navigation

Opinionated SwiftUI navigation enforcement for iOS 26 / Swift 6.2 clinic modular MVVM-C apps. Enforces Domain coordinator protocols, App-target `DependencyContainer` + concrete coordinators + route shells, `NavigationPath` ownership, coordinator-owned modal state, deep-link/state-restoration readiness, and stale-while-revalidate/optimistic queued flow compatibility. Use when designing or refactoring clinic navigation flows.

skills/.experimental/ios-navigation/SKILL.md

Read pinned source

Source commit cf93c57cac89d6fc3e4194686000411567f5caf3

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Not checked yet
Last checked: Nov 5, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 222
Repository last updated: Aug 15, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

engineering Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 10,504 bytes
assets/templates/_template.mddoc · 586 bytes
metadata.jsonasset · 1,472 bytes
references/_sections.mddoc · 2,636 bytes
references/ally-focus-after-navigation.mddoc · 3,401 bytes
references/ally-group-navigation-elements.mddoc · 4,067 bytes
references/ally-hide-decorative-navigation.mddoc · 3,359 bytes
references/ally-keyboard-focus.mddoc · 4,023 bytes
references/ally-rotor-headers.mddoc · 3,864 bytes
references/anim-gesture-driven.mddoc · 3,873 bytes
references/anim-matched-geometry-same-view.mddoc · 3,941 bytes
references/anim-reduce-motion-transitions.mddoc · 3,635 bytes
references/anim-scroll-driven.mddoc · 3,076 bytes
references/anim-spring-config.mddoc · 2,969 bytes
references/anim-transition-source-styling.mddoc · 2,920 bytes
references/anim-zoom-transition.mddoc · 3,054 bytes
references/anti-hamburger-menu.mddoc · 4,434 bytes
references/anti-hidden-back-button.mddoc · 3,315 bytes
references/anti-mixed-link-styles.mddoc · 2,601 bytes
references/anti-navigation-in-init.mddoc · 2,899 bytes
references/anti-programmatic-tab-switch.mddoc · 4,539 bytes
references/anti-scattered-destinations.mddoc · 2,739 bytes
references/anti-shared-stack.mddoc · 2,473 bytes
references/arch-coordinator-modals.mddoc · 4,010 bytes
references/arch-coordinator.mddoc · 4,529 bytes
references/arch-deep-linking.mddoc · 4,563 bytes
references/arch-destination-item.mddoc · 2,331 bytes
references/arch-destination-registration.mddoc · 4,073 bytes
references/arch-equatable-views.mddoc · 2,853 bytes
references/arch-navigation-path.mddoc · 4,792 bytes
references/arch-navigation-stack.mddoc · 2,697 bytes
references/arch-no-anyview.mddoc · 2,595 bytes
references/arch-observable-environment.mddoc · 3,085 bytes
references/arch-observable-only.mddoc · 2,884 bytes
references/arch-route-enum.mddoc · 4,121 bytes
references/arch-split-view.mddoc · 3,804 bytes
references/arch-value-based-links.mddoc · 3,028 bytes
references/flow-multi-step.mddoc · 2,650 bytes
references/flow-pop-to-root.mddoc · 3,456 bytes
references/flow-screen-independence.mddoc · 3,911 bytes
references/flow-sidebar-navigation.mddoc · 3,540 bytes
references/flow-tab-independence.mddoc · 3,934 bytes
references/flow-tab-sidebar-adaptive.mddoc · 3,886 bytes
references/modal-detents.mddoc · 3,425 bytes
references/modal-fullscreen-cover.mddoc · 3,819 bytes
references/modal-interactive-dismiss.mddoc · 4,864 bytes
references/modal-nested-navigation.mddoc · 4,474 bytes
references/modal-sheet-placement.mddoc · 3,026 bytes
references/modal-sheet-vs-push.mddoc · 3,511 bytes
references/perf-avoid-body-side-effects.mddoc · 3,015 bytes
references/perf-lazy-destinations.mddoc · 2,887 bytes
references/perf-state-object-ownership.mddoc · 2,551 bytes
references/perf-task-modifier.mddoc · 2,552 bytes
references/state-avoid-app-level-path.mddoc · 3,999 bytes
references/state-codable-routes.mddoc · 3,335 bytes
references/state-deep-link-urls.mddoc · 4,054 bytes
references/state-scene-storage.mddoc · 4,502 bytes
references/state-tab-persistence.mddoc · 3,766 bytes

Read excerpt


# iOS Navigation (Modular MVVM-C)

Opinionated navigation enforcement for SwiftUI apps using the clinic modular architecture. Focus on coordinator + route shell wiring, feature isolation, and resilient push/sheet/deep-link flows.

## Non-Negotiable Constraints (iOS 26 / Swift 6.2)

- `@Equatable` macro on every navigation view, `AnyView` never
- `@Observable` everywhere, `ObservableObject` / `@Published` never
- App-target coordinators own `NavigationPath`; route shells own `.navigationDestination` mappings
- Coordinator-owned modal state, inline `@State` booleans for sheets never
- Domain layer defines coordinator protocols; concrete coordinators stay out of feature modules


## Clinic Architecture Contract (iOS 26 / Swift 6.2)