efremidze/swift-architecture-skill

swift-architecture-skill は何をしますか？

Swiftのアーキテクチャパターンとプレイブック - MVVM、TCA、クリーンアーキテクチャなどに対応。

概要

このリポジトリは、Swiftプロジェクトで一般的に使用されるアーキテクチャパターンのリファレンスと実装ガイドを提供します。各パターンの概要、構成要素、トレードオフを理解し、適切なアーキテクチャを選択・適用できるようになります。

サポート対象パターン

• MVVM (Model-View-ViewModel): ビューとビジネスロジックの分離に優れたパターン。RxSwiftやCombineとの相性が良好。
• TCA (The Composable Architecture): 状態管理、アクション、レデューサーを中心とした関数型アーキテクチャ。大規模アプリに適している。
• Clean Architecture: 依存性の方向を制御し、テスタブルで保守性の高い設計を実現。VIPERやRIBsの基盤としても利用される。
• その他: MVC、MVP、VIPERなどのパターンもカバー。

使用方法

各パターンの詳細なドキュメントとサンプルコードは、/playbooks配下に格納されています。プロジェクトの要件に応じて、適切なパターンを選択し、参照してください。

必要条件

• Swift 5.0+
• Xcode 12.0+
• iOS 13.0+ / macOS 10.15+

インストール

Swift Package Managerを使用してプロジェクトに追加できます。

// Package.swift
dependencies: [
    .package(url: "https://github.com/efremidze/swift-architecture-skill.git", from: "1.0.0")
]

ライセンス

MIT

貢献

プルリクエストは歓迎します。大きな変更を加える場合は、まずIssueを開いて変更内容を議論してください。

関連プロジェクト

• Awesome Swift Architecture
• Swift Style Guide

---

このスキルは、Claude Code、Cursor、CodexなどのAIエージェントで使用するために設計されています。