CLAUDE.md git:20260928.60e1776A

Immutable. This exact content never changes and is served at /api/v1/blob/72e0bd857cfd1a93.

# Swift Architecture Skill

This repository contains an Agent Skill that provides Swift architecture design and implementation patterns for iOS codebases.

## Project Structure

```
.claude-plugin/
  plugin.json                 # Claude Code plugin manifest
  marketplace.json            # Marketplace listing manifest
swift-architecture-skill/     # The Agent Skill itself
  SKILL.md                    # Skill definition and workflow
  references/
    selection-guide.md        # Architecture decision framework
    concurrency.md            # Shared async, cancellation, and error-mapping rules
    observation.md            # Shared @Observable vs ObservableObject guidance
    mvp.md                    # MVP pattern playbook
    mvvm.md                   # MVVM pattern playbook
    mvi.md                    # MVI pattern playbook
    tca.md                    # TCA (Composable Architecture) playbook
    clean-architecture.md     # Clean Architecture playbook
    viper.md                  # VIPER pattern playbook
    coordinator.md            # Coordinator pattern playbook
    reactive.md               # Reactive (Combine/RxSwift) playbook
tooling/                      # Validation scripts, evals, and benchmarks
README.md                     # Installation and usage docs
```

## How the Skill Works

1. User requests architecture guidance for a Swift feature or module
2. The skill routes to the appropriate architecture playbook based on explicit request or inferred constraints
3. The playbook provides concrete patterns, code examples, anti-patterns, testing strategies, and PR review checklists
4. Output is tailored to the user's specific feature context

## Key Conventions

- All architecture references are standalone markdown playbooks in `references/`
- Each playbook follows a consistent structure: core concepts, code patterns, anti-patterns with fixes, testing strategy, and PR review checklist
- The skill supports MVP, MVVM, MVI, TCA, Clean Architecture, VIPER, Coordinator, and Reactive patterns
- When no architecture is specified, use `references/selection-guide.md` to infer the best fit
- Code examples use modern Swift concurrency (async/await, actors) and cover both SwiftUI and UIKit patterns