buildanything 1.7.0 → 1.8.0

package/skills/ios/swift-accessibility/resources/audit-template.swift

@@ -0,0 +1,128 @@
+// AccessibilityAuditTests.swift
+// Drop-in XCUITest file for automated accessibility auditing.
+// Requires a platform that supports performAccessibilityAudit().
+// The helper methods below skip gracefully on older deployment targets.
+//
+// Usage:
+// 1. Add this file to your UI test target
+// 2. Add navigation steps for each screen in your app
+// 3. Run tests — failures indicate accessibility issues
+//
+// These tests use performAccessibilityAudit() to catch:
+// - Missing accessibility labels
+// - Low color contrast (WCAG thresholds)
+// - Touch targets below 44x44pt
+// - Text that doesn't scale with Dynamic Type
+// - Clipped or truncated text
+// - Incorrect accessibility traits
+
+import XCTest
+
+final class AccessibilityAuditTests: XCTestCase {
+
+    let app = XCUIApplication()
+
+    override func setUpWithError() throws {
+        continueAfterFailure = false
+        app.launch()
+    }
+
+    // MARK: - Full Audit (All Checks)
+
+    /// Audits the launch screen with all accessibility checks.
+    /// Add one test method per key screen in your app.
+    func testLaunchScreenAccessibility() throws {
+        try performAudit()
+    }
+
+    // MARK: - Per-Screen Audits
+    //
+    // Copy this pattern for each screen. Navigate to the screen,
+    // then run the audit.
+    //
+    // func testSettingsScreenAccessibility() throws {
+    //     app.tabBars.buttons["Settings"].tap()
+    //     try performAudit()
+    // }
+    //
+    // func testProfileScreenAccessibility() throws {
+    //     app.tabBars.buttons["Profile"].tap()
+    //     try performAudit()
+    // }
+
+    // MARK: - Filtered Audits
+
+    /// Contrast and labels only — the two most common failures.
+    func testContrastAndLabels() throws {
+        try performAudit([.contrast, .sufficientElementDescription])
+    }
+
+    /// Touch targets and element detection.
+    func testHitRegionsAndDetection() throws {
+        try performAudit([.hitRegion, .elementDetection])
+    }
+
+    /// Dynamic Type scaling and text clipping.
+    func testDynamicTypeSupport() throws {
+        try performAudit([.dynamicType, .textClipped])
+    }
+
+    // MARK: - Audit with Known Issue Exclusions
+
+    /// Full audit that ignores specific known issues.
+    /// Replace the example exclusion with your own.
+    func testAuditWithExclusions() throws {
+        try performAudit(.all) { issue in
+            // Example: ignore contrast issues on branded splash logo
+            // if issue.auditType == .contrast,
+            //    issue.element?.identifier == "splashLogo" {
+            //     return true  // true = ignore this issue
+            // }
+            return false  // false = fail on this issue
+        }
+    }
+
+    // MARK: - Multi-Screen Regression Test
+
+    /// Navigates through key screens and audits each one.
+    /// Customize the navigation steps for your app's tab bar or flow.
+    func testFullAppAccessibilityRegression() throws {
+        // Screen 1: Launch / Home
+        try performAudit()
+
+        // Screen 2: Navigate to second tab (customize for your app)
+        // app.tabBars.buttons["Search"].tap()
+        // try performAudit()
+
+        // Screen 3: Navigate to third tab
+        // app.tabBars.buttons["Settings"].tap()
+        // try performAudit()
+    }
+
+    private func performAudit(
+        _ auditTypes: XCUIAccessibilityAuditType = .all
+    ) throws {
+        try requireAccessibilityAuditSupport()
+        if #available(iOS 17, macOS 14, tvOS 17, watchOS 10, visionOS 1, *) {
+            try app.performAccessibilityAudit(for: auditTypes)
+        }
+    }
+
+    private func performAudit(
+        _ auditTypes: XCUIAccessibilityAuditType = .all,
+        issueHandler: @escaping (XCUIAccessibilityAuditIssue) throws -> Bool
+    ) throws {
+        try requireAccessibilityAuditSupport()
+        if #available(iOS 17, macOS 14, tvOS 17, watchOS 10, visionOS 1, *) {
+            try app.performAccessibilityAudit(for: auditTypes, issueHandler)
+        }
+    }
+
+    private func requireAccessibilityAuditSupport() throws {
+        guard #available(iOS 17, macOS 14, tvOS 17, watchOS 10, visionOS 1, *) else {
+            throw XCTSkip(
+                "performAccessibilityAudit() requires iOS 17+, macOS 14+, tvOS 17+, watchOS 10+, or visionOS 1+."
+            )
+        }
+    }
+}

package/skills/ios/swift-accessibility/resources/qa-checklist.md

@@ -0,0 +1,258 @@
+# Accessibility QA Checklist
+
+Standalone checklist for manual accessibility testing. Hand this to QA testers — no skill or Claude knowledge required.
+
+Aligned with Apple's 9 App Store Accessibility Nutrition Labels and WCAG 2.2 Level AA.
+
+---
+
+## How to Use This Checklist
+
+1. Test on a **real device** — Simulator doesn't fully support VoiceOver, Voice Control, or Switch Control
+2. Test **every key user flow**: launch, onboarding, login, main feature, settings, purchase (if applicable)
+3. Mark each item: Pass / Fail / N/A
+4. A single Fail in a Nutrition Label category means that label **cannot be claimed** on the App Store
+
+---
+
+## Before You Start: Xcode Tools
+
+### Xcode Canvas Variants (during development)
+In the preview canvas, click the **Variants** button (grid icon) at the bottom:
+- **Dynamic Type Variants** — renders the view at all 12 text sizes
+- **Color Scheme Variants** — shows light and dark mode side by side
+- **Orientation Variants** — portrait and landscape
+
+### Xcode Canvas Device Settings (during development)
+Click the **Device Settings** button (slider icon) at the bottom of the canvas:
+- Set color scheme, Dynamic Type size, and orientation for a single preview
+- Combine settings to test specific scenarios (e.g., dark mode + large text)
+
+### Accessibility Inspector (Simulator or device)
+Xcode menu → Open Developer Tool → Accessibility Inspector
+- **Inspection tab** — point at any element to see its label, traits, value, and frame size
+- **Audit tab** — run automated checks on the current screen (missing labels, low contrast, small targets)
+- **Settings tab** — toggle Increase Contrast, Reduce Motion, Bold Text, Reduce Transparency on the Simulator without changing device settings
+
+### performAccessibilityAudit() (automated tests)
+Add to XCUITest target (iOS 17+). Catches missing labels, low contrast, small hit regions, clipped text, and Dynamic Type failures in CI. See `resources/audit-template.swift` for a drop-in template.
+
+---
+
+## 1. VoiceOver
+
+**Enable:** Settings → Accessibility → VoiceOver (or triple-click Side button if configured)
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 1.1 | Navigate all elements | Swipe right repeatedly through entire screen | Every interactive element is reachable |
+| 1.2 | Labels are meaningful | Tap each element, listen to announcement | Label describes the element concisely, not "button" or "image" |
+| 1.3 | No redundant type in label | Listen for "button button" or "image image" | VoiceOver adds type automatically — label should not include it |
+| 1.4 | State as traits | Toggle a switch, select a tab | VoiceOver says "selected" / "on" / "off" — not embedded in the label text |
+| 1.5 | Decorative images hidden | Swipe through screen | Decorative images are skipped |
+| 1.6 | Reading order is logical | Use "Read All" (two-finger swipe up) | Content reads in visual order, top-to-bottom, left-to-right |
+| 1.7 | Focus after navigation | Push a new screen | Focus moves to first element of new screen (usually title or back button) |
+| 1.8 | Focus after modal dismiss | Dismiss a sheet/alert | Focus returns to the element that triggered it |
+| 1.9 | Adjustable controls work | Swipe up/down on slider or stepper | Value changes and is announced |
+| 1.10 | Dynamic changes announced | Trigger a loading state or error | VoiceOver announces the change ("Loading complete", "Error: …") |
+| 1.11 | Complete a key flow | Do the main task start-to-finish with VoiceOver | Task completes without sighted assistance |
+
+---
+
+## 2. Voice Control
+
+**Enable:** Settings → Accessibility → Voice Control
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 2.1 | Show numbers | Say "Show numbers" | Every interactive element has a number overlay |
+| 2.2 | Tap by number | Say "Tap [number]" | Correct element activates |
+| 2.3 | Show names | Say "Show names" | Every element shows its visible text label |
+| 2.4 | Tap by name | Say "Tap [label]" | Element activates — label must match visible text exactly |
+| 2.5 | Text input | Say "Type [text]" in a text field | Text is entered correctly |
+| 2.6 | Scrolling | Say "Scroll down" / "Scroll up" | Content scrolls |
+| 2.7 | Icon-only elements | Say "Tap Share" (or the label) for icon-only buttons | Button activates — requires `.accessibilityInputLabels` |
+
+---
+
+## 3. Larger Text (Dynamic Type)
+
+**Enable:** Settings → Accessibility → Display & Text Size → Larger Text → drag slider to max
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 3.1 | Text scales | Set to Accessibility 5 (max) | All text is larger |
+| 3.2 | No clipping | Navigate all screens at max size | No text cut off without "..." affordance |
+| 3.3 | No overlapping | Check all screens at max size | No elements overlap |
+| 3.4 | Layout adapts | Check horizontal layouts | Rows/columns reflow to vertical when needed |
+| 3.5 | Fixed UI chrome | Long-press on tab bar icons or toolbar items | Large Content Viewer shows enlarged version |
+| 3.6 | Small text readable | Set to smallest size | Text is still readable |
+
+**Quick check with Xcode:** Use Canvas Dynamic Type Variants to see all 12 sizes at once.
+
+---
+
+## 4. Sufficient Contrast
+
+**Tool:** Accessibility Inspector → Inspection tab → Color contrast
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 4.1 | Normal text | Check body text against background | ≥ 4.5:1 contrast ratio |
+| 4.2 | Large text | Check headings (≥ 18pt or 14pt bold) | ≥ 3:1 contrast ratio |
+| 4.3 | Non-text elements | Check icons, borders, focus rings | ≥ 3:1 contrast ratio |
+| 4.4 | Both modes | Repeat all checks in Dark Mode | Passes in both light and dark |
+| 4.5 | Increased Contrast | Enable Increase Contrast in Accessibility Inspector Settings | Borders and separators become more visible |
+| 4.6 | Placeholder text | Check text field placeholders | ≥ 4.5:1 against background |
+
+---
+
+## 5. Dark Interface
+
+**Enable:** Settings → Display & Brightness → Dark
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 5.1 | All text readable | Navigate all screens | No white-on-white or invisible text |
+| 5.2 | Borders visible | Check cards, sections, separators | Borders and dividers are visible |
+| 5.3 | Images correct | Check photos, icons | No white halo; images aren't inverted incorrectly |
+| 5.4 | Status indicators | Check colored status elements | Still distinguishable in dark mode |
+
+---
+
+## 6. Differentiate Without Color
+
+**Enable:** Settings → Accessibility → Display & Text Size → Color Filters → Grayscale
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 6.1 | Status indicators | Check error/success/warning states | Distinguishable by shape, icon, or text — not color alone |
+| 6.2 | Charts and graphs | Check data visualizations | Data series distinguishable by pattern, shape, or label |
+| 6.3 | Links | Check link text | Underlined or otherwise distinguishable from body text |
+| 6.4 | Form validation | Trigger an error state | Error is indicated by icon or text, not just red color |
+
+---
+
+## 7. Reduced Motion
+
+**Enable:** Settings → Accessibility → Motion → Reduce Motion
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 7.1 | Navigation transitions | Push/pop screens | No sliding animation — dissolve or instant |
+| 7.2 | UI animations | Trigger state changes, loading | Animations removed or replaced with fade/opacity |
+| 7.3 | Auto-playing content | Check for auto-playing animations/video | Stopped or has manual play control |
+| 7.4 | Parallax effects | Scroll content | No parallax or motion effects |
+
+**Quick check:** Toggle Reduce Motion in Accessibility Inspector Settings tab while running in Simulator.
+
+---
+
+## 8. Captions
+
+**Applies to:** Apps with video or audio content
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 8.1 | Captions available | Play a video with dialogue | Captions can be enabled via player controls |
+| 8.2 | Auto-enable | Enable Closed Captions in Settings → Accessibility → Subtitles & Captioning | Captions appear automatically |
+| 8.3 | Captions accurate | Read captions while watching | Captions match spoken content |
+| 8.4 | Timing correct | Watch captions during video | Captions sync with audio |
+
+---
+
+## 9. Audio Descriptions
+
+**Applies to:** Apps with video content where visual information is important
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 9.1 | Audio Descriptions available | Play a video | Audio Description track can be selected |
+| 9.2 | Auto-enable | Enable Audio Descriptions in Settings → Accessibility → Audio Descriptions | Audio Descriptions play automatically |
+| 9.3 | Content described | Listen to Audio Descriptions | Important visual information is narrated |
+
+---
+
+## 10. Additional Checks
+
+### Switch Control
+
+**Enable:** Settings → Accessibility → Switch Control
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 10.1 | Scanning | Enable auto-scan | Every element is highlighted in sequence |
+| 10.2 | Activation | Select a highlighted element | Correct action triggers |
+| 10.3 | Custom actions | Navigate to elements with swipe actions | Actions appear in scanning menu |
+| 10.4 | No timeouts | Use the app slowly | Nothing times out or auto-advances |
+
+### Full Keyboard Access (iPad / Mac)
+
+**Enable:** Settings → Accessibility → Keyboards → Full Keyboard Access
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 10.5 | Tab navigation | Press Tab repeatedly | Focus moves through all interactive elements |
+| 10.6 | Reverse Tab | Press Shift+Tab | Focus moves backward |
+| 10.7 | Activation | Press Space or Return on focused element | Element activates |
+| 10.8 | Escape dismissal | Press Escape on modal | Modal dismisses |
+| 10.9 | No focus traps | Tab through entire app | Focus never gets stuck |
+
+---
+
+## Summary Template
+
+After testing, fill in:
+
+| Nutrition Label | Status | Blocking Issues |
+|---|---|---|
+| VoiceOver | Pass / Fail | |
+| Voice Control | Pass / Fail | |
+| Larger Text | Pass / Fail | |
+| Sufficient Contrast | Pass / Fail | |
+| Dark Interface | Pass / Fail | |
+| Differentiate Without Color | Pass / Fail | |
+| Reduced Motion | Pass / Fail | |
+| Captions | Pass / Fail / N/A | |
+| Audio Descriptions | Pass / Fail / N/A | |
+
+### App Store recommendation draft
+
+Use the completed summary above to prepare an App Store Accessibility Nutrition Label recommendation:
+
+- You could claim: every label marked Pass
+- You should not claim: every label marked Fail
+- Not applicable: every label marked N/A
+- Add short reasons for both supported and unsupported labels
+
+Example handoff:
+
+```md
+Accessibility Nutrition Label recommendation
+
+You could claim:
+- VoiceOver
+- Voice Control
+- Larger Text
+- Sufficient Contrast
+- Dark Interface
+- Differentiate Without Color
+- Reduced Motion
+
+Why you could claim them:
+- VoiceOver: all reviewed common tasks are reachable, labeled, and operable with VoiceOver
+- Voice Control: all reviewed interactive elements can be activated by visible name or input label
+- Larger Text: reviewed screens reflow correctly and remain readable at the largest supported sizes
+- Sufficient Contrast: reviewed text and interactive elements meet contrast requirements in light and dark mode
+- Dark Interface: reviewed screens support dark appearance without unreadable content or broken chrome
+- Differentiate Without Color: reviewed states and status indicators remain understandable without color alone
+- Reduced Motion: reviewed transitions and state changes respect Reduce Motion
+
+You should not claim:
+- Captions
+- Audio Descriptions
+
+Why you should not claim them:
+- Captions: the app has no primary video or long-form media experience in the reviewed scope
+- Audio Descriptions: the app has no video content that would justify this label in the reviewed scope
+```

package/skills/ios/swift-concurrency/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Antoine van der Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/ios/swift-concurrency/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: swift-concurrency
+description: 'Diagnose data races, convert callback-based code to async/await, implement actor isolation patterns, resolve Sendable conformance issues, and guide Swift 6 migration. Use when developers mention: (1) Swift Concurrency, async/await, actors, or tasks, (2) "use Swift Concurrency" or "modern concurrency patterns", (3) migrating to Swift 6, (4) data races or thread safety issues, (5) refactoring closures to async/await, (6) @MainActor, Sendable, or actor isolation, (7) concurrent code architecture or performance optimization, (8) concurrency-related linter warnings (SwiftLint or similar; e.g. async_without_await, Sendable/actor isolation/MainActor lint).'
+---
+# Swift Concurrency
+
+## Fast Path
+
+Before proposing a fix:
+
+1. Analyze `Package.swift` or `.pbxproj` to determine Swift language mode, strict concurrency level, default isolation, and upcoming features. Do this always, not only for migration work.
+2. Capture the exact diagnostic and offending symbol.
+3. Determine the isolation boundary: `@MainActor`, custom actor, actor instance isolation, or `nonisolated`.
+4. Confirm whether the code is UI-bound or intended to run off the main actor.
+
+Project settings that change concurrency behavior:
+
+| Setting | SwiftPM (`Package.swift`) | Xcode (`.pbxproj`) |
+|---|---|---|
+| Language mode | `swiftLanguageVersions` or `-swift-version` (`// swift-tools-version:` is not a reliable proxy) | Swift Language Version |
+| Strict concurrency | `.enableExperimentalFeature("StrictConcurrency=targeted")` | `SWIFT_STRICT_CONCURRENCY` |
+| Default isolation | `.defaultIsolation(MainActor.self)` | `SWIFT_DEFAULT_ACTOR_ISOLATION` |
+| Upcoming features | `.enableUpcomingFeature("NonisolatedNonsendingByDefault")` | `SWIFT_UPCOMING_FEATURE_*` |
+
+If any of these are unknown, ask the developer to confirm them before giving migration-sensitive guidance. Do not guess.
+
+Guardrails:
+
+- Do not recommend `@MainActor` as a blanket fix. Justify why the code is truly UI-bound.
+- Prefer structured concurrency over unstructured tasks. Use `Task.detached` only with a clear reason.
+- If recommending `@preconcurrency`, `@unchecked Sendable`, or `nonisolated(unsafe)`, require a documented safety invariant and a follow-up removal plan.
+- Optimize for the smallest safe change. Do not refactor unrelated architecture during migration.
+- Course references are for deeper learning only. Use them sparingly and only when they clearly help answer the developer's question.
+
+## Quick Fix Mode
+
+Use Quick Fix Mode when all of these are true:
+
+- The issue is localized to one file or one type.
+- The isolation boundary is clear.
+- The fix can be explained in 1-2 behavior-preserving steps.
+
+Skip Quick Fix Mode when any of these are true:
+
+- Build settings or default isolation are unknown.
+- The issue crosses module boundaries or changes public API behavior.
+- The likely fix depends on unsafe escape hatches.
+
+## Common Diagnostics
+
+| Diagnostic | First check | Smallest safe fix | Escalate to |
+|---|---|---|---|
+| `Main actor-isolated ... cannot be used from a nonisolated context` | Is this truly UI-bound? | Isolate the caller to `@MainActor` or use `await MainActor.run { ... }` only when main-actor ownership is correct. | `references/actors.md`, `references/threading.md` |
+| `Actor-isolated type does not conform to protocol` | Must the requirement run on the actor? | Prefer isolated conformance (e.g., `extension Foo: @MainActor SomeProtocol`); use `nonisolated` only for truly nonisolated requirements. | `references/actors.md` |
+| `Sending value of non-Sendable type ... risks causing data races` | What isolation boundary is being crossed? | Keep access inside one actor, or convert the transferred value to an immutable/value type. | `references/sendable.md`, `references/threading.md` |
+| `SwiftLint async_without_await` | Is `async` actually required by protocol, override, or `@concurrent`? | Remove `async`, or use a narrow suppression with rationale. Never add fake awaits. | `references/linting.md` |
+| `wait(...) is unavailable from asynchronous contexts` | Is this legacy XCTest async waiting? | Replace with `await fulfillment(of:)` or Swift Testing equivalents. | `references/testing.md` |
+| Core Data concurrency warnings | Are `NSManagedObject` instances crossing contexts or actors? | Pass `NSManagedObjectID` or map to a Sendable value type. | `references/core-data.md` |
+| `Thread.current` unavailable from asynchronous contexts | Are you debugging by thread instead of isolation? | Reason in terms of isolation and use Instruments/debugger instead. | `references/threading.md` |
+| SwiftLint concurrency-related warnings | Which specific lint rule triggered? | Use `references/linting.md` for rule intent and preferred fixes; avoid dummy awaits. | `references/linting.md` |
+
+## When Quick Fixes Fail
+
+1. Gather project settings if not already confirmed.
+2. Re-evaluate which isolation boundaries the type crosses.
+3. Route to the matching reference file for a deeper fix.
+4. If the fix may change behavior, document the invariant and add verification steps.
+
+## Smallest Safe Fixes
+
+Prefer changes that preserve behavior while satisfying data-race safety:
+
+- **UI-bound state**: isolate the type or member to `@MainActor`.
+- **Shared mutable state**: move it behind an `actor`, or use `@MainActor` only if the state is UI-owned.
+- **Background work**: when work must hop off caller isolation, use an `async` API marked `@concurrent`; when work can safely inherit caller isolation, use `nonisolated` without `@concurrent`.
+- **Sendability issues**: prefer immutable values and explicit boundaries over `@unchecked Sendable`.
+
+## Concurrency Tool Selection
+
+| Need | Tool | Key Guidance |
+|---|---|---|
+| Single async operation | `async/await` | Default choice for sequential async work |
+| Fixed parallel operations | `async let` | Known count at compile time; auto-cancelled on throw |
+| Dynamic parallel operations | `withTaskGroup` | Unknown count; structured — cancels children on scope exit |
+| Sync → async bridge | `Task { }` | Inherits actor context; use `Task.detached` only with documented reason |
+| Shared mutable state | `actor` | Prefer over locks/queues; keep isolated sections small |
+| UI-bound state | `@MainActor` | Only for truly UI-related code; justify isolation |
+
+### Common Scenarios
+
+**Network request with UI update**
+```swift
+Task { @concurrent in
+    let data = try await fetchData()
+    await MainActor.run { self.updateUI(with: data) }
+}
+```
+
+**Processing array items in parallel**
+```swift
+await withTaskGroup(of: ProcessedItem.self) { group in
+    for item in items {
+        group.addTask { await process(item) }
+    }
+    for await result in group {
+        results.append(result)
+    }
+}
+```
+
+## Swift 6 Migration Quick Guide
+
+Key changes in Swift 6:
+- **Strict concurrency checking** enabled by default
+- **Complete data-race safety** at compile time
+- **Sendable requirements** enforced on boundaries
+- **Isolation checking** for all async boundaries
+
+### Migration Validation Loop
+
+Apply this cycle for each migration change:
+
+1. **Build** — Run `swift build` or Xcode build to surface new diagnostics
+2. **Fix** — Address one category of error at a time (e.g., all Sendable issues first)
+3. **Rebuild** — Confirm the fix compiles cleanly before moving on
+4. **Test** — Run the test suite to catch regressions (`swift test` or Cmd+U)
+5. **Only proceed** to the next file/module when all diagnostics are resolved
+
+If a fix introduces new warnings, resolve them before continuing. Never batch multiple unrelated fixes — keep commits small and reviewable.
+
+For detailed migration steps, see `references/migration.md`.
+
+## Reference Router
+
+Open the smallest reference that matches the question:
+
+- Foundations
+  - `references/async-await-basics.md` — async/await syntax, execution order, async let, URLSession patterns
+  - `references/tasks.md` — Task lifecycle, cancellation, priorities, task groups, structured vs unstructured
+  - `references/actors.md` — Actor isolation, @MainActor, global actors, reentrancy, custom executors, Mutex
+  - `references/sendable.md` — Sendable conformance, value/reference types, @unchecked, region isolation
+  - `references/threading.md` — Execution model, suspension points, Swift 6.2 isolation behavior
+- Streams
+  - `references/async-sequences.md` — AsyncSequence, AsyncStream, when to use vs regular async methods
+  - `references/async-algorithms.md` — Debounce, throttle, merge, combineLatest, channels, timers
+- Applied topics
+  - `references/testing.md` — Swift Testing first, XCTest fallback, leak checks
+  - `references/performance.md` — Profiling with Instruments, reducing suspension points, execution strategies
+  - `references/memory-management.md` — Retain cycles in tasks, memory safety patterns
+  - `references/core-data.md` — NSManagedObject sendability, custom executors, isolation conflicts
+- Migration and tooling
+  - `references/migration.md` — Swift 6 migration strategy, closure-to-async conversion, @preconcurrency, FRP migration
+  - `references/linting.md` — Concurrency-focused lint rules and SwiftLint `async_without_await`
+- Glossary
+  - `references/glossary.md` — Quick definitions of core concurrency terms
+
+## Verification Checklist
+
+When changing concurrency code:
+
+1. Re-check build settings before interpreting diagnostics.
+2. Build and clear one category of errors before moving on. Do not batch unrelated fixes into the same change.
+3. Run tests, especially actor-, lifetime-, and cancellation-sensitive tests.
+4. Use Instruments for performance claims instead of guessing.
+5. Verify deallocation and cancellation behavior for long-lived tasks.
+6. Check `Task.isCancelled` in long-running operations.
+7. Never use semaphores or ad hoc locking in async contexts when actor isolation or `Mutex` would express ownership more safely.
+
+---
+
+**Note**: This skill is based on the comprehensive [Swift Concurrency Course](https://www.swiftconcurrencycourse.com?utm_source=github&utm_medium=agent-skill&utm_campaign=skill-footer) by Antoine van der Lee.

package/skills/ios/swift-concurrency/references/_index.md

@@ -0,0 +1,50 @@
+# Reference Index
+
+Quick navigation for the Swift Concurrency skill.
+
+## Foundations
+
+| File | Use it for |
+|---|---|
+| `async-await-basics.md` | closure-to-async bridges and foundational async/await usage |
+| `tasks.md` | `Task`, cancellation, task groups, structured vs unstructured work |
+| `actors.md` | actor isolation, `@MainActor`, reentrancy, isolated conformances |
+| `sendable.md` | `Sendable`, `@Sendable`, region isolation, escape hatches |
+| `threading.md` | execution model, suspension points, Swift 6.2 isolation behavior |
+
+## Streams
+
+| File | Use it for |
+|---|---|
+| `async-sequences.md` | deciding between `AsyncSequence`, `AsyncStream`, and one-shot async APIs |
+| `async-algorithms.md` | debounce, throttle, merge, `combineLatest`, channels, timers |
+
+## Applied Topics
+
+| File | Use it for |
+|---|---|
+| `testing.md` | Swift Testing first, XCTest fallback, leak checks |
+| `performance.md` | Instruments workflow, actor hops, suspension cost |
+| `memory-management.md` | retain cycles, long-lived tasks, cleanup |
+| `core-data.md` | `NSManagedObjectID`, `perform`, default isolation conflicts |
+
+## Migration and Tooling
+
+| File | Use it for |
+|---|---|
+| `migration.md` | rollout order, build settings, migration guardrails |
+| `linting.md` | concurrency-focused lint rules |
+| `glossary.md` | quick definitions |
+
+## Problem Router
+
+- "I need to fix a compiler error quickly" → `../SKILL.md`
+- "I need to replace a callback with async/await" → `async-await-basics.md`
+- "I need to protect shared mutable state" → `actors.md`
+- "I need to pass data safely across boundaries" → `sendable.md`
+- "I need stream operators" → `async-algorithms.md`
+- "I need to understand why code runs where it runs" → `threading.md`
+- "I need to stop a leak or lifetime issue" → `memory-management.md`
+- "I need to migrate to Swift 6" → `migration.md`
+- "I need to test async code" → `testing.md`
+- "I need to optimize slow async code" → `performance.md`