{
  "id": "page:docs-reference-repos-avdlee-swift-concurrency-agent-skill-research",
  "_kind": "Page",
  "_file": "wiki/docs/reference-repos/avdlee/swift-concurrency-agent-skill/research.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/reference-repos/AvdLee/Swift-Concurrency-Agent-Skill/research.md",
    "sourceKind": "repo-docs",
    "title": "AvdLee/Swift-Concurrency-Agent-Skill",
    "displayName": "AvdLee/Swift-Concurrency-Agent-Skill",
    "slug": "docs/reference-repos/avdlee/swift-concurrency-agent-skill/research",
    "articlePath": "wiki/docs/reference-repos/AvdLee/Swift-Concurrency-Agent-Skill/research.md",
    "article": "\n# AvdLee/Swift-Concurrency-Agent-Skill\n\n- **Archetype**: domain-skill-pack\n- **Stars**: 1,388\n- **Last pushed**: 2026-03-29\n- **License**: MIT\n- **Discovered**: 2026-04-12\n- **Skills found**: 1\n\n## Summary\nExpert-level Swift Concurrency guidance packaged as an agent skill. Covers safe concurrency patterns, performance optimization, and Swift 6 migration. Authored by a well-known iOS developer (Antoine van der Lee / SwiftLee). The single SKILL.md is exceptionally deep -- a diagnostic-first workflow with quick-fix mode, common diagnostics table, and project-settings-aware guardrails.\n\n## Assessment\nHIGH VALUE for domain specialization. The skill demonstrates a gold-standard pattern for encoding language-specific expertise: it begins by reading project settings (Package.swift / .pbxproj) to determine the exact Swift language mode and strict concurrency level before offering any guidance. The diagnostic table mapping compiler errors to smallest-safe-fix + escalation references is directly extractable as a methodology pattern. The \"Quick Fix Mode\" vs. full analysis branching based on issue scope is a reusable decision framework. Transferable to specializations/engineering/swift-concurrency or more broadly as a template for language-migration specializations.\n\n## Extraction Priority\n- High\n- Rationale: Authoritative source (prominent iOS developer), deeply procedural with diagnostic-first workflow, project-settings-aware guardrails, and a reusable pattern for encoding language migration expertise. The diagnostic table + quick-fix-mode branching is a novel pattern not yet in babysitter's process library.\n\n## Processes\n- **Swift Concurrency Diagnostic Workflow**: Read project settings -> capture diagnostic -> determine isolation boundary -> confirm UI-boundness -> apply smallest safe fix. Maps to a babysitter process with breakpoints for developer confirmation at each decision point.\n- **Swift 6 Migration Process**: Incremental migration with guardrails against blanket @MainActor, preference for structured concurrency, and documented safety invariants for escape hatches. Could be a multi-step babysitter process with tasks for each migration phase.\n- **Quick Fix Mode Decision Gate**: A reusable branching pattern -- if issue is localized + isolation is clear + fix is 1-2 steps, use quick path; otherwise escalate to full analysis. Extractable as a shared methodology pattern.\n\n## Patterns\n- **Diagnostic-first workflow**: Always analyze project settings and capture exact diagnostic before proposing fixes. Prevents incorrect guidance from assumed context.\n- **Smallest-safe-change principle**: Optimize for minimal behavioral change during migration. Avoid refactoring unrelated architecture.\n- **Quick Fix Mode branching**: Scope-based decision gate that routes simple issues to fast path and complex issues to full analysis. Reduces overhead for trivial fixes.\n- **Escape hatch documentation**: When recommending unsafe patterns (@preconcurrency, @unchecked Sendable), require documented safety invariants and removal plans.\n- **Reference file architecture**: Deep reference docs (actors.md, sendable.md, threading.md, testing.md, linting.md) linked from diagnostic table for escalation.\n\n## Library Mapping\n\n| Extractable Process | Library Status | Action | Existing Path | Target Placement |\n|-------------------|----------------|--------|---------------|------------------|\n| Swift Concurrency Diagnostic Workflow | NEW | Project-settings-aware diagnostic process with smallest-safe-fix methodology | - | specializations/business/swift-concurrency-diagnostic.js |\n| Swift 6 Migration Process | NEW | Incremental Swift 6 migration with safety guardrails and structured concurrency | - | specializations/business/swift-6-migration.js |\n| Quick Fix Mode Decision Gate | NEW | Scope-based branching for simple vs complex issue resolution | - | specializations/shared/quick-fix-mode-decision-gate.js |\n| Language Migration Framework | NEW | Generic pattern for language-version migration with diagnostic tables | - | specializations/shared/language-migration-framework.js |\n| Project Settings Analysis | NEW | Pre-analysis project configuration detection for context-aware guidance | - | specializations/shared/project-settings-analysis.js |\n| Diagnostic Table Methodology | NEW | Structured error-to-fix mapping with escalation references | - | specializations/shared/diagnostic-table-methodology.js |\n| Escape Hatch Documentation Pattern | NEW | Safety invariant documentation for unsafe migration patterns | - | specializations/shared/escape-hatch-documentation.js |\n| Smallest-Safe-Change Principle | NEW | Minimal behavioral change optimization for migration workflows | - | specializations/shared/smallest-safe-change-principle.js |\n\n## Plugin Marketplace Mapping\n\n| Plugin Idea | Marketplace Status | Action | Existing Plugin | Target Placement |\n|-------------|-------------------|--------|-----------------|------------------|\n| Swift Project Settings Hook | NEW | Automatic Package.swift/.pbxproj analysis on session start for Swift projects | - | plugins/a5c/marketplace/blueprints/swift-project-settings-hook/ |\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-reference-repos",
      "to": "page:docs-reference-repos-avdlee-swift-concurrency-agent-skill-research",
      "kind": "contains_page"
    }
  ]
}