К основному содержанию
скилл CX Codex

ios-navigation · pproenca — скилл для Claude Code: что делает и как установить

Скилл ios-navigation задаёт строгие правила навигации SwiftUI для модульной архитектуры MVVM-C на Swift 6.2. Помогает проектировать переходы, диплинки и модальные экраны.

MIT 275 установок ★ 227 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pproenca/dot-skills --skill ios-navigation -a claude-code
Открыть на GitHub

Что делает ios-navigation

Скилл внедряет строгие правила навигации для модульных iOS-приложений. Протоколы координаторов размещаются в слое Domain, а конкретные классы и контейнер зависимостей DependencyContainer находятся в главном таргете. Модули фичей подключают только Domain и DesignSystem, не обращаясь к слою данных или соседним модулям напрямую.

Набор правил полностью исключает AnyView, устаревший ObservableObject и обёртку @Published. Навигационные экраны требуют макроса @Equatable, а реактивное состояние строится на @Observable. Координатор управляет всеми модальными окнами. Инлайн-флаги @State для открытия sheet здесь запрещены.

Какие задачи решает

  • Спроектировать иерархию переходов в SwiftUI через NavigationStack
  • Вынести навигационную логику экрана в отдельный координатор с @Observable
  • Проверить модуль на запрещённые вызовы AnyView и инлайн-модалки
  • Настроить обработку диплинков добавлением маршрутов в NavigationPath

Примеры запросов агенту

  • Проверь навигацию в модуле профиля на соответствие правилам clinic MVVM-C
  • Спроектируй многошаговый флоу оформления заказа через координатор и NavigationStack
  • Перепиши показ модального экрана со связки @State на вызов через координатор

Как установить ios-navigation

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill ios-navigation -a claude-code

2Вручную: положить файлы

~/.claude/skills/ios-navigation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ios-navigation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об ios-navigation

Как установить ios-navigation в Claude Code?

Выполните в терминале команду npx skills add pproenca/dot-skills --skill ios-navigation -a claude-code.

Что проверяет скилл ios-navigation?

Он следит за соблюдением архитектуры clinic modular MVVM-C: требует хранить протоколы координаторов в Domain, запрещает AnyView и обязывает управлять NavigationPath из таргета приложения.

Почему скилл запрещает ObservableObject?

В стандартах под Swift 6.2 скилл требует использовать только макрос @Observable, полностью исключая ObservableObject и @Published для навигационного состояния.

Исходный текст

SKILL.md · MIT
---
name: ios-navigation
description: 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.
---

# 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)

All guidance in this skill assumes the clinic modular MVVM-C architecture:

- Feature modules import `Domain` + `DesignSystem` only (never `Data`, never sibling features)
- App target is the convergence point and owns `DependencyContainer`, concrete coordinators, and Route Shell wiring
- `Domain` stays pure Swift and defines models plus repository, `*Coordinating`, `ErrorRouting`, and `AppError` contracts
- `Data` owns SwiftData/network/sync/retry/background I/O and implements Domain protocols
- Read/write flow defaults to stale-while-revalidate reads and optimistic queued writes
- ViewModels call repository protocols directly (no default use-case/interactor layer)

## When to Apply

Reference these guidelines when:
- Designing navigation hierarchies with NavigationStack or NavigationSplitView
- Choosing between push, sheet, and fullScreenCover
- Implementing hero animations, zoom transitions, or gesture-driven dismissals
- Building multi-step flows (onboarding, checkout, registration)
- Using @Observable with @Environment and @Bindable for shared navigation state
- Reviewing code for navigation anti-patterns and modular architecture compliance
- Adding deep linking, state restoration, or tab persistence
- Ensuring VoiceOver and reduce motion support for navigation

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Navigation Architecture | CRITICAL | `arch-` |
| 2 | Navigation Anti-Patterns | CRITICAL | `anti-` |

| 3 | Transition & Animation | HIGH | `anim-` |
| 4 | Modal Presentation | HIGH | `modal-` |
| 5 | Flow Orchestration | HIGH | `flow-` |
| 6 | Navigation Performance | MEDIUM-HIGH | `perf-` |
| 7 | Navigation Accessibility | MEDIUM | `ally-` |
| 8 | State & Restoration | MEDIUM | `state-` |

## Quick Reference

### 1. Navigation Architecture (CRITICAL)

- [`arch-navigation-stack`](references/arch-navigation-stack.md) - Use NavigationStack over deprecated NavigationView
- [`arch-value-based-links`](references/arch-value-based-links.md) - Use value-based NavigationLink over destination closures
- [`arch-destination-registration`](references/arch-destination-registration.md) - Register navigationDestination at stack root
- [`arch-destination-item`](references/arch-destination-item.md) - Use navigationDestination(item:) for optional-based navigation (iOS 26 / Swift 6.2)
- [`arch-route-enum`](references/arch-route-enum.md) - Define routes as Hashable enums
- [`arch-split-view`](references/arch-split-view.md) - Use NavigationSplitView for multi-column layouts
- [`arch-coordinator`](references/arch-coordinator.md) - Extract navigation logic into Observable coordinator
- [`arch-observable-environment`](references/arch-observable-environment.md) - Use @Environment with @Observable and @Bindable for shared state
- [`arch-deep-linking`](references/arch-deep-linking.md) - Handle deep links by appending to NavigationPath
- [`arch-navigation-path`](references/arch-navigation-path.md) - Use NavigationPath for heterogeneous type-erased navigation
- [`arch-equatable-views`](references/arch-equatable-views.md) - Apply @Equatable macro to every navigation view
- [`arch-observable-only`](references/arch-observable-only.md) - Use @Observable only — never ObservableObject or @Published
- [`arch-no-anyview`](references/arch-no-anyview.md) - Never use AnyView in navigation — use @ViewBuilder or generics
- [`arch-coordinator-modals`](references/arch-coordinator-modals.md) - Present all modals via coordinator — never inline @State

### 2. Navigation Anti-Patterns (CRITICAL)

- [`anti-mixed-link-styles`](references/anti-mixed-link-styles.md) - Avoid mixing NavigationLink(destination:) with NavigationLink(value:)
- [`anti-scattered-destinations`](references/anti-scattered-destinations.md) - Avoid scattering navigationDestination across views
- [`anti-shared-stack`](references/anti-shared-stack.md) - Avoid sharing NavigationStack across tabs
- [`anti-hidden-back-button`](references/anti-hidden-back-button.md) - Avoid hiding back button without preserving swipe gesture
- [`anti-navigation-in-init`](references/anti-navigation-in-init.md) - Avoid heavy work in view initializers
- [`anti-hamburger-menu`](references/anti-hamburger-menu.md) - Avoid hamburger menu navigation
- [`anti-programmatic-tab-switch`](references/anti-programmatic-tab-switch.md) - Avoid programmatic tab selection changes

### 3. Transition & Animation (HIGH)

- [`anim-zoom-transition`](references/anim-zoom-transition.md) - Use zoom navigation transition for hero animations (iOS 18+)
- [`anim-matched-geometry-same-view`](references/anim-matched-geometry-same-view.md) - Use matchedGeometryEffect only within same view hierarchy
- [`anim-spring-config`](references/anim-spring-config.md) - Use modern spring animation syntax (iOS 26 / Swift 6.2)
- [`anim-gesture-driven`](references/anim-gesture-driven.md) - Use interactive spring animations for gesture-driven transitions
- [`anim-transition-source-styling`](references/anim-transition-source-styling.md) - Style transition sources with shape and background
- [`anim-reduce-motion-transitions`](references/anim-reduce-motion-transitions.md) - Respect reduce motion for all navigation animations
- [`anim-scroll-driven`](references/anim-scroll-driven.md) - Use onScrollGeometryChange for scroll-driven transitions (iOS 18+)

### 4. Modal Presentation (HIGH)

- [`modal-sheet-vs-push`](references/modal-sheet-vs-push.md) - Use push for drill-down, sheet for supplementary content
- [`modal-detents`](references/modal-detents.md) - Use presentation detents for contextual sheet sizing
- [`modal-fullscreen-cover`](references/modal-fullscreen-cover.md) - Use fullScreenCover only for immersive standalone experiences
- [`modal-sheet-placement`](references/modal-sheet-placement.md) - Place .sheet on container view, not on NavigationLink
- [`modal-interactive-dismiss`](references/modal-interactive-dismiss.md) - Guard unsaved changes with interactiveDismissDisabled
- [`modal-nested-navigation`](references/modal-nested-navigation.md) - Use separate NavigationStack inside modals

### 5. Flow Orchestration (HIGH)

- [`flow-tab-independence`](references/flow-tab-independence.md) - Give each tab its own NavigationStack
- [`flow-multi-step`](references/flow-multi-step.md) - Use NavigationStack with route array for multi-step flows
- [`flow-sidebar-navigation`](references/flow-sidebar-navigation.md) - Use NavigationSplitView with selection binding for sidebar
- [`flow-tab-sidebar-adaptive`](references/flow-tab-sidebar-adaptive.md) - Use sidebarAdaptable TabView for iPad tab-to-sidebar (iOS 18+)
- [`flow-pop-to-root`](references/flow-pop-to-root.md) - Implement pop-to-root by clearing NavigationPath
- [`flow-screen-independence`](references/flow-screen-independence.md) - Keep screens independent of parent navigation context

### 6. Navigation Performance (MEDIUM-HIGH)

- [`perf-lazy-destinations`](references/perf-lazy-destinations.md) - Use value-based NavigationLink for lazy destination construction
- [`perf-task-modifier`](references/perf-task-modifier.md) - Use .task for async data loading on navigation
- [`perf-state-object-ownership`](references/perf-state-object-ownership.md) - Own @Observable state with @State, pass as plain property
- [`perf-avoid-body-side-effects`](references/perf-avoid-body-side-effects.md) - Avoid side effects in view body


### 7. Navigation Accessibility (MEDIUM)

- [`ally-rotor-headers`](references/ally-rotor-headers.md) - Mark navigation section headers for VoiceOver rotor
- [`ally-focus-after-navigation`](references/ally-focus-after-navigation.md) - Manage focus after programmatic navigation events
- [`ally-group-navigation-elements`](references/ally-group-navigation-elements.md) - Group related navigation elements to reduce swipe count
- [`ally-hide-decorative-navigation`](references/ally-hide-decorative-navigation.md) - Hide decorative navigation elements from VoiceOver
- [`ally-keyboard-focus`](references/ally-keyboard-focus.md) - Use @FocusState for keyboard navigation in forms

### 8. State & Restoration (MEDIUM)

- [`state-codable-routes`](references/state-codable-routes.md) - Make route enums Codable for navigation persistence
- [`state-scene-storage`](references/state-scene-storage.md) - Use SceneStorage for per-scene navigation persistence
- [`state-tab-persistence`](references/state-tab-persistence.md) - Persist selected tab with SceneStorage
- [`state-deep-link-urls`](references/state-deep-link-urls.md) - Parse deep link URLs into route enums
- [`state-avoid-app-level-path`](references/state-avoid-app-level-path.md) - Avoid defining NavigationPath at App level

## How to Use

Read individual reference files for detailed explanations and code examples:

- [Section definitions](references/_sections.md) - Category structure and impact levels
- [Rule template](assets/templates/_template.md) - Template for adding new rules

## Reference Files

| File | Description |
|------|-------------|
| [references/_sections.md](references/_sections.md) | Category definitions and ordering |
| [assets/templates/_template.md](assets/templates/_template.md) | Template for new rules |
| [metadata.json](metadata.json) | Version and reference information |

© pproenca · MIT · pproenca/dot-skills

Похожие скиллы

Все скиллы по теме «Мобильная разработка» →

Сначала — ios-navigation от других авторов.

ios-navigation HoangNguyen0403 Скилл ios-navigation настраивает навигацию в SwiftUI через NavigationStack и Universal Links без сбоев в стеке переходов. CX Codex +1 1установок ios-development rshankras Скилл ios-development для iOS-разработки: разбор Swift-кода, проверка UI по Apple HIG, аудит доступности и планирование приложения. CX Codex +1 871установок ios-dev Prisma-Labs-Dev Скилл ios-dev для Claude Code координирует руководства по паттернам, проверку корректности и справочники Apple при разработке под iOS и SwiftUI. CX Codex +1 813установок swiftui-navigation dpearson2699 Скилл swiftui-navigation обучает ассистента строить типобезопасную навигацию в SwiftUI: от стеков со строгими маршрутами до модальных окон и вкладок. Пригодится при проектировании переходов для iOS и macOS. CX Codex +1 4 700установок build-ios-apps официальный OpenAI Плагин build-ios-apps для Codex и ChatGPT объединяет скиллы для разработки под iOS: от SwiftUI и App Intents до профилирования ETTrace и поиска утечек по memgraph. CX Codex GP ChatGPT ★ 8 052звёзд репо ios-application-dev MiniMax-OpenSource Скилл ios-application-dev для Claude Code — справочник по UIKit, SnapKit и SwiftUI с чек-листами для проверки iOS-интерфейсов. CX Codex +1 2 200установок ios-swift-development aj-geddes Скилл ios-swift-development для разработки нативных iOS-приложений на Swift в Claude Code. Охватывает MVVM, SwiftUI, асинхронные запросы через URLSession и сохранение данных с Core Data. CX Codex +1 1 500установок

Из того же набора139

Весь набор →
swift-ui-architect Скилл swift-ui-architect контролирует модульную архитектуру MVVM-C на SwiftUI, Swift 6.2 и локальных SPM-пакетах. Защищает границы слоёв Domain, Data и Feature при генерации и рефакторинге кода. CX Codex +1 283установок ios-taste Скилл ios-taste проектирует интерфейсы SwiftUI для iOS 18+ с упором на задачи пользователя, исключая шаблонный код. CX Codex +1 280установок ios-storyboard Скилл ios-storyboard для Claude Code помогает поддерживать и рефакторить экраны Storyboard в проектах на Swift 6.2, править Auto Layout, разрешать конфликты слияния и готовить миграцию на SwiftUI. CX Codex +1 277установок rails-design-system Скилл rails-design-system с 51 правилом построения дизайн-системы в Rails. Когда создавать партиалы, компоненты, хелперы, Turbo Frames и Stimulus-контроллеры. CX Codex +1 276установок swift-data Помогает проектировать слой данных на SwiftData в модульных приложениях на iOS 26 и Swift 6.2. Используйте его при работе с моделями, репозиториями и синхронизацией. CX Codex +1 275установок ios-chaos-monkey Скилл ios-chaos-monkey для Claude Code содержит правила и TDD-сценарии для выявления крашей и гонок данных в iOS на Swift 6.2. CX Codex +1 274установок nginx-c-module-perf Скилл nginx-c-module-perf даёт рекомендации по производительности и отказоустойчивости модулей nginx на C. Пригодится при настройке буферов, соединений, кэша и обработки ошибок. CX Codex +1 267установок react-native-elements Скилл подсказывает, как применять React Native Elements: настраивать темы, выбирать компоненты и собирать производительные списки. Пригодится при разработке и проверке React Native-приложений. CX Codex +1 265установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой