arch-tcalisted

# The Composable Architecture (TCA) **Source references (study after reading this skill):** - pointfreeco/swift-composable-architecture — https://github.com/pointfreeco/swift-composable-architecture - CaseStudies — https://github.com/pointfreeco/swift-composable-architecture/tree/main/Examples/CaseStudies - Tutorials — https://pointfreeco.github.io/swift-composable-architecture/main/tutorials/composablearchitecture - TCA perf trade-offs (Karin Prater) — https://www.swiftyplace.com/blog/the-composable-architecture-performance Code in this skill follows the canonical CaseStudies conventions: `@Reducer`, `@ObservableState`, `Reduce { state, action in switch action }`, `.ifLet`, `StackState`, `@DependencyClient`. ## When to use - Greenfield SwiftUI apps, correctness-critical (payments, multi-step flows). - At least one engineer who shipped TCA in production. - Not for trivial screens (overkill). ## Folder structure ``` App/ UsersApp.swift AppFeature.swift Features/ UserList/ UserListFeature.swift UserListView.swift UserDetail/ UserDetailFeature.swift UserDetailView.swift Dependencies/ UserClient.swift Domain/ User.swift ``` ## Reference implementation The full worked `UserList + UserDetail` feature lives in **`examples/tca/`** — `@Reducer` features with `@ObservableState`, a `UserClient` dependency, SwiftUI views bound to `Store`, and `TestStore` tests. The shared `Domain` follows `skills/REFERENCE_FEATURE.md`; the example vendors its own copy