swift-refactor

Swift/SwiftUI のリファクタリング（モジュール化された MVVM-C）

Swift/SwiftUI のコードを、ローカルの SPM パッケージ境界と App ターゲットのコンポジションルート配線を備えたモジュール化 MVVM-C に移行するための包括的なリファクタリングガイドです。

必須のアーキテクチャスタック

┌───────────────────────────────────────────────────────────────┐
│ App target: DependencyContainer, Coordinators, Route Shells   │
├───────────────────────────────────────────────────────────────┤
│ Feature modules: View + ViewModel (Domain + DesignSystem deps)│
├───────────────────────────────────────────────────────────────┤
│ Data package: repositories, remote/local stores, sync, retry  │
├───────────────────────────────────────────────────────────────┤
│ Domain package: models, repository/coordinator/error protocols │
└───────────────────────────────────────────────────────────────┘

依存関係のルール：Feature モジュールは Data をインポートせず、兄弟 Feature もインポートしません。

Clinic アーキテクチャ契約（iOS 26 / Swift 6.2）

このスキルのガイダンスはすべて、Clinic のモジュール化 MVVM-C アーキテクチャを前提としています。

• Feature モジュールがインポートするのは Domain と DesignSystem のみです（Data および兄弟 Feature はインポートしません）。
• App ターゲットが集約地点となり、DependencyContainer、具象コーディネーター、Route Shell の配線を所有します。
• Domain は純粋な Swift を保ち、モデルに加えて、リポジトリ、*Coordinating、ErrorRouting、AppError の各コントラクトを定義します。
• Data は SwiftData／ネットワーク／同期／再試行／バックグラウンド I/O を所有し、Domain プロトコルを実装します。
• 読み書きのフローでは、デフォルトで stale-while-revalidate による読み取りと、楽観的なキュー書き込みを使用します。
• ViewModel はリポジトリプロトコルを直接呼び出します（デフォルトのユースケース／インタラクターレイヤーはありません）。

適用する場面

次の場合に、これらのガイドラインを参照してください。

• 非推奨の SwiftUI API（ObservableObject、NavigationView、古い onChange）から移行する
• @Observable ViewModel を使用する状態管理に再構成する
• パフォーマンス向上のため、ビューに @Equatable による差分検出を追加する
• 大きなビューを、本文が最大 10 ノードになるように分割する
• ナビゲーションをコーディネーター + Route Shell パターンにリファクタリングする
• Domain/Data/Feature/App のパッケージ境界に沿ってリファクタリングする
• DependencyContainer による依存性注入を設定する
• リスト／コレクションのスクロールパフォーマンスを改善する
• 手動の Task 管理を .task(id:) とキャンセル可能な読み込みに置き換える

必ず守る制約（iOS 26 / Swift 6.2）

• ViewModel／コーディネーターには @Observable を使用し、ObservableObject／@Published は使用しません。
• NavigationStack は App ターゲットの Route Shell とコーディネーターが所有します。
• すべてのビューに @Equatable マクロを付け、AnyView は使用しません。
• Domain がリポジトリ／コーディネーター／エラールーティングのプロトコルを定義し、フレームワークに依存する I/O は行いません。
• 専用のユースケース／インタラクターレイヤーは設けません。ViewModel がリポジトリプロトコルを直接呼び出します。
• ビューからリポジトリに直接アクセスしません。

優先度別ルールカテゴリ

優先度	カテゴリ	影響	プレフィックス	ルール数
1	ビューのアイデンティティと差分検出	CRITICAL	diff-	4
2	API の最新化	CRITICAL	api-	7
3	状態アーキテクチャ	CRITICAL	state-	6
4	ビューの構成	HIGH	view-	7
5	ナビゲーションと調整	HIGH	nav-	5
6	レイヤーアーキテクチャ	HIGH	layer-	5
7	アーキテクチャパターン	HIGH	arch-	5
8	依存性注入	MEDIUM-HIGH	di-	2
9	型安全性とプロトコル	MEDIUM-HIGH	type-	4
10	リストとコレクションのパフォーマンス	MEDIUM	list-	4
11	非同期処理とデータフロー	MEDIUM	data-	3
12	Swift 言語の基礎	MEDIUM	swift-	8

クイックリファレンス

1. ビューのアイデンティティと差分検出（CRITICAL）

• diff-equatable-views - すべての SwiftUI ビューに @Equatable マクロを追加します
• diff-closure-skip - クロージャープロパティには @EquatableIgnored を使用します
• diff-identity-stability - ForEach では安定した O(1) 識別子を使用します
• diff-printchanges-debug - 再レンダリングの原因を特定するには _printChanges() を使用します

2. API のモダナイズ（CRITICAL）

• api-observable-macro - ObservableObject を @Observable マクロに移行する
• api-navigationstack-migration - NavigationView を NavigationStack に置き換える
• api-onchange-signature - 新しい onChange シグネチャに移行する
• api-environment-object-removal - @EnvironmentObject を @Environment に置き換える
• api-alert-confirmation-dialog - Alert を confirmationDialog API に移行する
• api-list-foreach-identifiable - id: .self を Identifiable への準拠に置き換える
• api-toolbar-migration - navigationBarItems を toolbar モディファイアに置き換える

3. 状態アーキテクチャ（CRITICAL）

• state-scope-minimization - 状態のスコープを最も近い利用箇所まで最小化する
• state-derived-over-stored - 冗長な @State の代わりに計算プロパティを使用する
• state-binding-extraction - @Binding を切り出して、子ビューの再描画を分離する
• state-remove-observation - @ObservedObject を @Observable によるトラッキングに移行する
• state-onappear-to-task - onAppear クロージャを .task モディファイアに置き換える
• state-stateobject-placement - @StateObject を @Observable を使用した @State に移行する

4. ビューの構成（HIGH）

• view-extract-subviews - 差分確認のチェックポイントとしてサブビューを切り出す
• view-eliminate-anyview - AnyView を @ViewBuilder またはジェネリクスに置き換える
• view-computed-to-struct - 計算ビューのプロパティを struct ビューに変換する
• view-modifier-extraction - 繰り返し使用するモディファイアをカスタム ViewModifiers に切り出す
• view-conditional-content - 条件付きビューの代わりに Group または条件付きモディファイアを使用する
• view-preference-keys - コールバッククロージャを PreferenceKey に置き換える
• view-body-complexity - ビューの body を最大 10 ノードに抑える

5. ナビゲーションと調整（HIGH）

• nav-centralize-destinations - ナビゲーションをコーディネーターパターンにリファクタリングする
• nav-value-based-links - NavigationLink をコーディネーターのルートに置き換える
• nav-path-state-management - プログラムによるナビゲーションに NavigationPath を使用する
• nav-split-view-adoption - 複数列レイアウトに NavigationSplitView を使用する
• nav-sheet-item-pattern - シートのブール値トリガーをアイテムバインディングに置き換える

6. レイヤーアーキテクチャ（HIGH）

• layer-dependency-rule - フレームワークのインポートがないドメインレイヤーを切り出す
• layer-usecase-protocol - ユースケース／インタラクターレイヤーを削除し、ViewModel とリポジトリプロトコルでオーケストレーションを行う
• layer-repository-protocol - リポジトリプロトコルは Domain に、実装は Data に配置する
• layer-no-view-repository - ビューからのリポジトリへの直接アクセスを削除する
• layer-viewmodel-boundary - ViewModel を、表示用に整えた状態のみを公開するようリファクタリングする

7. アーキテクチャパターン（高）

• arch-viewmodel-elimination - インラインの状態を@Observable ViewModelに再構成します
• arch-protocol-dependencies - ViewModelレイヤーを通じてプロトコル依存関係を抽出します
• arch-environment-key-injection - サービスの注入にEnvironmentキーを使用します
• arch-feature-module-extraction - 機能を独立したモジュールに抽出します
• arch-model-view-separation - ビジネスロジックをDomainモデルとリポジトリに基づくViewModelに抽出します

8. 依存性注入（中〜高）

• di-container-composition - アプリのルートで依存関係コンテナを構成します
• di-mock-testing - プロトコル依存関係ごとにモック実装を追加します

9. 型安全性とプロトコル（中〜高）

• type-tagged-identifiers - String IDをタグ付き型に置き換えます
• type-result-over-optionals - エラーフラグ付きのOptionalではなくResult型を使用します
• type-phantom-types - コンパイル時の状態マシンにファントム型を使用します
• type-force-unwrap-elimination - 安全な代替手段を使って強制アンラップを排除します

10. リストとコレクションのパフォーマンス（中）

• list-constant-viewcount - ForEachが要素ごとに一定のビュー数を生成するようにします
• list-filter-in-model - フィルター／ソートのロジックをForEachからViewModelに移します
• list-lazy-stacks - 内容が無制限の場合はVStack／HStackをLazy版に置き換えます
• list-id-keypath - 明示的なid keyPathを指定し、暗黙の識別性に依存しないようにします

11. 非同期処理とデータフロー（中）

• data-task-modifier - onAppearでの非同期処理を.taskモディファイアに置き換えます
• data-error-loadable - 読み込み状態をブール値フラグではなく列挙型で表します
• data-cancellation - .taskの自動キャンセルを使用し、Taskを手動で管理しないようにします

12. Swift言語の基礎（中）

• swift-let-vs-var - 定数にはlet、変数にはvarを使用します
• swift-structs-vs-classes - classよりstructを優先します
• swift-camel-case-naming - camelCaseの命名規則を使用します
• swift-string-interpolation - 動的テキストには文字列補間を使用します
• swift-functions-clear-names - 関数とパラメーターに明確な名前を付けます
• swift-for-in-loops - コレクションにはfor-inループを使用します
• swift-optionals - アンラップを使ってOptionalを安全に処理します
• swift-closures - インライン関数にはクロージャを使用します

使用方法

詳しい説明とコード例については、個々のリファレンスファイルをお読みください。

• セクションの定義 - カテゴリー構成と影響度
• ルールテンプレート - 新しいルールを追加するためのテンプレート

リファレンスファイル

ファイル	説明
references/_sections.md	カテゴリーの定義と順序
assets/templates/_template.md	新しいルール用のテンプレート