@mmerterden/multi-agent-pipeline 20.2.1 → 20.3.0

package/pipeline/skills/shared/external/room-database/references/patterns.md

@@ -22,27 +22,27 @@ SKILL.md sections.
 
 ```kotlin
 @Entity(
-    tableName = "flights",
+    tableName = "orders",
     indices = [
-        Index(value = ["origin_code", "destination_code"]),
-        Index(value = ["departure_time"]),
+        Index(value = ["store_code", "region_code"]),
+        Index(value = ["placed_at"]),
     ],
 )
-data class FlightEntity(
+data class OrderEntity(
     @PrimaryKey
     val id: String,
-    @ColumnInfo(name = "origin_code")
-    val originCode: String,
-    @ColumnInfo(name = "origin_name")
-    val originName: String,
-    @ColumnInfo(name = "destination_code")
-    val destinationCode: String,
-    @ColumnInfo(name = "destination_name")
-    val destinationName: String,
-    @ColumnInfo(name = "departure_time")
-    val departureTime: String,
-    @ColumnInfo(name = "arrival_time")
-    val arrivalTime: String,
+    @ColumnInfo(name = "store_code")
+    val storeCode: String,
+    @ColumnInfo(name = "store_name")
+    val storeName: String,
+    @ColumnInfo(name = "region_code")
+    val regionCode: String,
+    @ColumnInfo(name = "region_name")
+    val regionName: String,
+    @ColumnInfo(name = "placed_at")
+    val placedAt: String,
+    @ColumnInfo(name = "delivered_at")
+    val deliveredAt: String,
     @ColumnInfo(name = "price_amount")
     val priceAmount: Double,
     @ColumnInfo(name = "price_currency")
@@ -57,16 +57,16 @@ data class FlightEntity(
 
 ```kotlin
 @Entity(
-    tableName = "booking_passengers",
-    primaryKeys = ["booking_id", "passenger_id"],
+    tableName = "shipment_packages",
+    primaryKeys = ["shipment_id", "package_id"],
 )
-data class BookingPassengerEntity(
-    @ColumnInfo(name = "booking_id")
-    val bookingId: String,
-    @ColumnInfo(name = "passenger_id")
-    val passengerId: String,
-    @ColumnInfo(name = "seat_number")
-    val seatNumber: String?,
+data class ShipmentPackageEntity(
+    @ColumnInfo(name = "shipment_id")
+    val shipmentId: String,
+    @ColumnInfo(name = "package_id")
+    val packageId: String,
+    @ColumnInfo(name = "tracking_number")
+    val trackingNumber: String?,
 )
 ```
 
@@ -74,49 +74,49 @@ data class BookingPassengerEntity(
 
 ```kotlin
 @Dao
-interface FlightDao {
+interface OrderDao {
 
-    @Query("SELECT * FROM flights WHERE origin_code = :origin AND destination_code = :destination ORDER BY departure_time ASC")
-    fun getFlights(origin: String, destination: String): Flow<List<FlightEntity>>
+    @Query("SELECT * FROM orders WHERE store_code = :store AND region_code = :region ORDER BY placed_at ASC")
+    fun getOrders(store: String, region: String): Flow<List<OrderEntity>>
 
-    @Query("SELECT * FROM flights WHERE id = :id")
-    fun getFlightById(id: String): Flow<FlightEntity?>
+    @Query("SELECT * FROM orders WHERE id = :id")
+    fun getOrderById(id: String): Flow<OrderEntity?>
 
-    @Query("SELECT * FROM flights WHERE id = :id")
-    suspend fun getFlightByIdOnce(id: String): FlightEntity?
+    @Query("SELECT * FROM orders WHERE id = :id")
+    suspend fun getOrderByIdOnce(id: String): OrderEntity?
 
     @Insert(onConflict = OnConflictStrategy.REPLACE)
-    suspend fun insertFlight(flight: FlightEntity)
+    suspend fun insertOrder(order: OrderEntity)
 
     @Insert(onConflict = OnConflictStrategy.REPLACE)
-    suspend fun insertFlights(flights: List<FlightEntity>)
+    suspend fun insertOrders(orders: List<OrderEntity>)
 
     @Upsert
-    suspend fun upsertFlights(flights: List<FlightEntity>)
+    suspend fun upsertOrders(orders: List<OrderEntity>)
 
     @Update
-    suspend fun updateFlight(flight: FlightEntity)
+    suspend fun updateOrder(order: OrderEntity)
 
     @Delete
-    suspend fun deleteFlight(flight: FlightEntity)
+    suspend fun deleteOrder(order: OrderEntity)
 
-    @Query("DELETE FROM flights WHERE id = :id")
-    suspend fun deleteFlightById(id: String)
+    @Query("DELETE FROM orders WHERE id = :id")
+    suspend fun deleteOrderById(id: String)
 
-    @Query("DELETE FROM flights WHERE updated_at < :threshold")
-    suspend fun deleteStaleFlights(threshold: Long)
+    @Query("DELETE FROM orders WHERE updated_at < :threshold")
+    suspend fun deleteStaleOrders(threshold: Long)
 
-    @Query("SELECT COUNT(*) FROM flights")
-    fun getFlightCount(): Flow<Int>
+    @Query("SELECT COUNT(*) FROM orders")
+    fun getOrderCount(): Flow<Int>
 
     @Transaction
-    suspend fun replaceAllFlights(flights: List<FlightEntity>) {
-        deleteAllFlights()
-        insertFlights(flights)
+    suspend fun replaceAllOrders(orders: List<OrderEntity>) {
+        deleteAllOrders()
+        insertOrders(orders)
     }
 
-    @Query("DELETE FROM flights")
-    suspend fun deleteAllFlights()
+    @Query("DELETE FROM orders")
+    suspend fun deleteAllOrders()
 }
 ```
 
@@ -133,9 +133,9 @@ interface FlightDao {
 ```kotlin
 @Database(
     entities = [
-        FlightEntity::class,
-        BookingEntity::class,
-        BookingPassengerEntity::class,
+        OrderEntity::class,
+        ShipmentEntity::class,
+        ShipmentPackageEntity::class,
     ],
     version = 2,
     autoMigrations = [
@@ -145,8 +145,8 @@ interface FlightDao {
 )
 @TypeConverters(Converters::class)
 abstract class AppDatabase : RoomDatabase() {
-    abstract fun flightDao(): FlightDao
-    abstract fun bookingDao(): BookingDao
+    abstract fun orderDao(): OrderDao
+    abstract fun shipmentDao(): ShipmentDao
 }
 ```
 
@@ -166,28 +166,28 @@ table changes.
 
 ```kotlin
 // DAO returns Flow
-@Query("SELECT * FROM flights WHERE origin_code = :origin")
-fun getFlightsByOrigin(origin: String): Flow<List<FlightEntity>>
+@Query("SELECT * FROM orders WHERE store_code = :store")
+fun getOrdersByStore(store: String): Flow<List<OrderEntity>>
 
 // Repository maps to domain models
-class FlightRepositoryImpl @Inject constructor(
-    private val dao: FlightDao,
-    private val mapper: FlightMapper,
-) : FlightRepository {
+class OrderRepositoryImpl @Inject constructor(
+    private val dao: OrderDao,
+    private val mapper: OrderMapper,
+) : OrderRepository {
 
-    override fun getFlights(origin: String): Flow<List<Flight>> =
-        dao.getFlightsByOrigin(origin)
+    override fun getOrders(store: String): Flow<List<Order>> =
+        dao.getOrdersByStore(store)
             .map { entities -> entities.map(mapper::toDomain) }
             .flowOn(Dispatchers.IO)
 }
 
 // ViewModel collects in viewModelScope
 @HiltViewModel
-class FlightListViewModel @Inject constructor(
-    private val repository: FlightRepository,
+class OrderListViewModel @Inject constructor(
+    private val repository: OrderRepository,
 ) : ViewModel() {
 
-    val flights: StateFlow<List<Flight>> = repository.getFlights("IST")
+    val orders: StateFlow<List<Order>> = repository.getOrders("LDN")
         .stateIn(
             scope = viewModelScope,
             started = SharingStarted.WhileSubscribed(5_000),
@@ -197,11 +197,11 @@ class FlightListViewModel @Inject constructor(
 
 // Compose collects as state
 @Composable
-fun FlightListScreen(viewModel: FlightListViewModel = hiltViewModel()) {
-    val flights by viewModel.flights.collectAsStateWithLifecycle()
+fun OrderListScreen(viewModel: OrderListViewModel = hiltViewModel()) {
+    val orders by viewModel.orders.collectAsStateWithLifecycle()
     LazyColumn {
-        items(flights, key = { it.id }) { flight ->
-            FlightCard(flight = flight)
+        items(orders, key = { it.id }) { order ->
+            OrderCard(order = order)
         }
     }
 }
@@ -231,10 +231,10 @@ class Converters {
     fun toInstant(value: Long?): Instant? = value?.let { Instant.fromEpochMilliseconds(it) }
 
     @TypeConverter
-    fun fromFlightStatus(value: FlightStatus): String = value.name
+    fun fromOrderStatus(value: OrderStatus): String = value.name
 
     @TypeConverter
-    fun toFlightStatus(value: String): FlightStatus = FlightStatus.valueOf(value)
+    fun toOrderStatus(value: String): OrderStatus = OrderStatus.valueOf(value)
 }
 ```
 
@@ -259,8 +259,8 @@ data class AddressEntity(
     val country: String,
 )
 
-@Entity(tableName = "passengers")
-data class PassengerEntity(
+@Entity(tableName = "customers")
+data class CustomerEntity(
     @PrimaryKey val id: String,
     val name: String,
     @Embedded(prefix = "address_")
@@ -272,20 +272,20 @@ data class PassengerEntity(
 ### @Relation (One-to-Many)
 
 ```kotlin
-data class BookingWithPassengers(
-    @Embedded val booking: BookingEntity,
+data class ShipmentWithPackages(
+    @Embedded val shipment: ShipmentEntity,
     @Relation(
         parentColumn = "id",
-        entityColumn = "booking_id",
+        entityColumn = "shipment_id",
     )
-    val passengers: List<BookingPassengerEntity>,
+    val packages: List<ShipmentPackageEntity>,
 )
 
 @Dao
-interface BookingDao {
+interface ShipmentDao {
     @Transaction
-    @Query("SELECT * FROM bookings WHERE id = :bookingId")
-    fun getBookingWithPassengers(bookingId: String): Flow<BookingWithPassengers?>
+    @Query("SELECT * FROM shipments WHERE id = :shipmentId")
+    fun getShipmentWithPackages(shipmentId: String): Flow<ShipmentWithPackages?>
 }
 ```
 
@@ -293,22 +293,22 @@ interface BookingDao {
 
 ```kotlin
 @Entity(
-    tableName = "flight_tags",
-    primaryKeys = ["flight_id", "tag_id"],
+    tableName = "order_tags",
+    primaryKeys = ["order_id", "tag_id"],
 )
-data class FlightTagCrossRef(
-    @ColumnInfo(name = "flight_id") val flightId: String,
+data class OrderTagCrossRef(
+    @ColumnInfo(name = "order_id") val orderId: String,
     @ColumnInfo(name = "tag_id") val tagId: String,
 )
 
-data class FlightWithTags(
-    @Embedded val flight: FlightEntity,
+data class OrderWithTags(
+    @Embedded val order: OrderEntity,
     @Relation(
         parentColumn = "id",
         entityColumn = "id",
         associateBy = Junction(
-            value = FlightTagCrossRef::class,
-            parentColumn = "flight_id",
+            value = OrderTagCrossRef::class,
+            parentColumn = "order_id",
             entityColumn = "tag_id",
         ),
     )
@@ -326,7 +326,7 @@ For simple schema changes (add column, add table, add index):
 
 ```kotlin
 @Database(
-    entities = [FlightEntity::class],
+    entities = [OrderEntity::class],
     version = 3,
     autoMigrations = [
         AutoMigration(from = 1, to = 2),
@@ -336,7 +336,7 @@ For simple schema changes (add column, add table, add index):
 abstract class AppDatabase : RoomDatabase()
 
 // Spec needed for column/table renames or deletes
-@RenameColumn(tableName = "flights", fromColumnName = "price", toColumnName = "price_amount")
+@RenameColumn(tableName = "orders", fromColumnName = "price", toColumnName = "price_amount")
 class Migration2To3 : AutoMigrationSpec
 ```
 
@@ -348,20 +348,20 @@ For complex changes (data transformation, merging tables):
 val MIGRATION_3_4 = object : Migration(3, 4) {
     override fun migrate(db: SupportSQLiteDatabase) {
         db.execSQL("""
-            CREATE TABLE IF NOT EXISTS bookings_new (
+            CREATE TABLE IF NOT EXISTS shipments_new (
                 id TEXT NOT NULL PRIMARY KEY,
-                flight_id TEXT NOT NULL,
+                order_id TEXT NOT NULL,
                 status TEXT NOT NULL DEFAULT 'PENDING',
                 created_at INTEGER NOT NULL DEFAULT 0,
-                FOREIGN KEY (flight_id) REFERENCES flights(id) ON DELETE CASCADE
+                FOREIGN KEY (order_id) REFERENCES orders(id) ON DELETE CASCADE
             )
         """)
         db.execSQL("""
-            INSERT INTO bookings_new (id, flight_id, status, created_at)
-            SELECT id, flight_id, status, 0 FROM bookings
+            INSERT INTO shipments_new (id, order_id, status, created_at)
+            SELECT id, order_id, status, 0 FROM shipments
         """)
-        db.execSQL("DROP TABLE bookings")
-        db.execSQL("ALTER TABLE bookings_new RENAME TO bookings")
+        db.execSQL("DROP TABLE shipments")
+        db.execSQL("ALTER TABLE shipments_new RENAME TO shipments")
     }
 }
 
@@ -400,22 +400,22 @@ object DatabaseModule {
         .build()
 
     @Provides
-    fun provideFlightDao(database: AppDatabase): FlightDao =
-        database.flightDao()
+    fun provideOrderDao(database: AppDatabase): OrderDao =
+        database.orderDao()
 
     @Provides
-    fun provideBookingDao(database: AppDatabase): BookingDao =
-        database.bookingDao()
+    fun provideShipmentDao(database: AppDatabase): ShipmentDao =
+        database.shipmentDao()
 }
 ```
 
 ## Testing with In-Memory Database
 
 ```kotlin
-class FlightDaoTest {
+class OrderDaoTest {
 
     private lateinit var database: AppDatabase
-    private lateinit var dao: FlightDao
+    private lateinit var dao: OrderDao
 
     @Before
     fun setup() {
@@ -426,7 +426,7 @@ class FlightDaoTest {
         .allowMainThreadQueries() // OK for tests only
         .build()
 
-        dao = database.flightDao()
+        dao = database.orderDao()
     }
 
     @After
@@ -435,33 +435,33 @@ class FlightDaoTest {
     }
 
     @Test
-    fun insertAndQuery_returnsCorrectFlight() = runTest {
-        val flight = FlightEntity(
-            id = "TK1",
-            originCode = "IST",
-            originName = "Istanbul",
-            destinationCode = "JFK",
-            destinationName = "New York",
-            departureTime = "2025-01-15T10:00:00Z",
-            arrivalTime = "2025-01-15T18:00:00Z",
+    fun insertAndQuery_returnsCorrectOrder() = runTest {
+        val order = OrderEntity(
+            id = "ORD-101",
+            storeCode = "LDN",
+            storeName = "London",
+            regionCode = "NYC",
+            regionName = "New York",
+            placedAt = "2025-01-15T10:00:00Z",
+            deliveredAt = "2025-01-15T18:00:00Z",
             priceAmount = 799.0,
             priceCurrency = "USD",
-            status = "SCHEDULED",
+            status = "PLACED",
         )
 
-        dao.insertFlight(flight)
+        dao.insertOrder(order)
 
-        val result = dao.getFlightByIdOnce("TK1")
+        val result = dao.getOrderByIdOnce("ORD-101")
         assertThat(result).isNotNull()
-        assertThat(result?.originCode).isEqualTo("IST")
+        assertThat(result?.storeCode).isEqualTo("LDN")
     }
 
     @Test
     fun flowQuery_emitsUpdates() = runTest {
-        dao.getFlights("IST", "JFK").test {
+        dao.getOrders("LDN", "NYC").test {
             assertThat(awaitItem()).isEmpty()
 
-            dao.insertFlight(testFlight)
+            dao.insertOrder(testOrder)
 
             val updated = awaitItem()
             assertThat(updated).hasSize(1)
@@ -471,13 +471,13 @@ class FlightDaoTest {
     }
 
     @Test
-    fun upsert_updatesExistingFlight() = runTest {
-        dao.insertFlight(testFlight)
-        val updated = testFlight.copy(status = "DELAYED")
-        dao.upsertFlights(listOf(updated))
+    fun upsert_updatesExistingOrder() = runTest {
+        dao.insertOrder(testOrder)
+        val updated = testOrder.copy(status = "SHIPPED")
+        dao.upsertOrders(listOf(updated))
 
-        val result = dao.getFlightByIdOnce(testFlight.id)
-        assertThat(result?.status).isEqualTo("DELAYED")
+        val result = dao.getOrderByIdOnce(testOrder.id)
+        assertThat(result?.status).isEqualTo("SHIPPED")
     }
 }
 ```
@@ -498,13 +498,13 @@ class MigrationTest {
     fun migrate3To4() {
         // Create database at version 3
         helper.createDatabase("test-db", 3).apply {
-            execSQL("INSERT INTO bookings (id, flight_id, status) VALUES ('B1', 'F1', 'CONFIRMED')")
+            execSQL("INSERT INTO shipments (id, order_id, status) VALUES ('S1', 'O1', 'CONFIRMED')")
             close()
         }
 
         // Run migration and validate
         val db = helper.runMigrationsAndValidate("test-db", 4, true, MIGRATION_3_4)
-        val cursor = db.query("SELECT * FROM bookings WHERE id = 'B1'")
+        val cursor = db.query("SELECT * FROM shipments WHERE id = 'S1'")
         assertThat(cursor.moveToFirst()).isTrue()
         assertThat(cursor.getColumnIndex("created_at")).isAtLeast(0)
     }

package/pipeline/skills/shared/external/search-first/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: search-first
-version: 1.0.0
 description: |
   Research-before-coding workflow. Before writing a custom implementation,
   check what already exists (repo utilities, installed libraries, packages,
   internal components) and decide adopt / extend / compose / build on evidence.
   Use at the start of any non-trivial feature or utility, especially when you
   are about to reach for a new dependency or hand-roll something common.
+metadata:
+  version: 1.0.0
 ---
 
 # Search-First

package/pipeline/skills/shared/external/security-review/SKILL.md

@@ -1,9 +1,10 @@
 ---
 name: security-review
 description: "Run a defensive, static security review of a diff or a repo: build a run-scoped threat model, find vulnerabilities joined to OWASP + CWE with CVSS scoring and evidence, and emit reviewer-shaped findings with before/after fixes. Use when reviewing code for security, auditing a dependency set, preparing a release for a security sign-off, or when a diff touches auth, crypto, input handling, networking or secrets."
-risk: low
-source: multi-agent-pipeline
-date_added: "2026-09-21"
+metadata:
+  risk: low
+  source: multi-agent-pipeline
+  date_added: "2026-09-21"
 ---
 
 # Security Review (defensive, static)

package/pipeline/skills/shared/external/shareplay-activities/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: shareplay-activities
 description: "Build shared real-time experiences using GroupActivities and SharePlay. Use when implementing shared media playback, collaborative app features, synchronized game state, or any FaceTime, Messages, AirDrop, or nearby visionOS group activity on iOS, macOS, tvOS, or visionOS."
+metadata:
+  source: "dpearson2699/swift-ios-skills (PolyForm Perimeter 1.0.0)"
 ---
-
 # GroupActivities / SharePlay
-
 Build shared real-time experiences using the GroupActivities framework. SharePlay
 connects people over FaceTime, Messages, AirDrop, and nearby visionOS sharing,
 synchronizing media playback, app state, or custom data. Targets Swift 6.3 / iOS 26+.

package/pipeline/skills/shared/external/signal-community/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: signal-community
-description: Check whether other people hit the same problem, via Stack Overflow and Hacker News (keyless) plus opt-in Reddit and X. Use when a bug report or complaint needs corroboration beyond one user. Advisory only: it belongs in a risks section, never in a business rule.
+description: "Check whether other people hit the same problem, via Stack Overflow and Hacker News (keyless) plus opt-in Reddit and X. Use when a bug report or complaint needs corroboration beyond one user. Advisory only: it belongs in a risks section, never in a business rule."
 ---
 
 # Community signal

package/pipeline/skills/shared/external/skill-creator/SKILL.md

@@ -1,10 +1,11 @@
 ---
 name: skill-creator
-version: 1.0.0
 description: "Author and refine skills for a plugin/toolkit efficiently. Use when creating a new skill, trimming or splitting an existing one, writing a skill's description, or choosing skill vs command vs agent vs CLAUDE.md. Encodes the house rules - lean SKILL.md as an index, progressive disclosure into bundled files, the reference (descriptive) vs workflow (imperative) split, no-prefix naming, and growing a skill from observed failures. Bundles a template, a pre-ship checklist, and good/bad description examples."
 user-invocable: true
 argument-hint: [new | trim | description]
 allowed-tools: Read, Write, Edit, Glob
+metadata:
+  version: 1.0.0
 ---
 
 # skill-creator - how to write skills here

package/pipeline/skills/shared/external/speech-recognition/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: speech-recognition
 description: "Transcribe speech to text using Apple's Speech framework. Use when implementing live microphone transcription with AVAudioEngine, recognizing recorded audio files, handling speech and microphone authorization, choosing on-device vs server-backed SFSpeechRecognizer behavior, or adopting SpeechAnalyzer, SpeechTranscriber, DictationTranscriber, AssetInventory, and async result streams on iOS 26+."
+metadata:
+  source: "dpearson2699/swift-ios-skills (PolyForm Perimeter 1.0.0)"
 ---
-
 # Speech Recognition
 
 Transcribe live and pre-recorded audio to text using Apple's Speech framework.

package/pipeline/skills/shared/external/spm-build-analysis/SKILL.md

@@ -2,6 +2,8 @@
 name: spm-build-analysis
 description: Analyze Swift Package Manager dependencies, package plugins, module variants, and CI-oriented build overhead that slow Xcode builds. Use when a developer suspects packages, plugins, or dependency graph shape are hurting clean or incremental build performance, mentions SPM slowness, package resolution time, build plugin overhead, duplicate module builds from configuration drift, circular dependencies between modules, oversized modules needing splitting, or modularization best practices.
 user-invocable: false
+metadata:
+  source: "AvdLee/Xcode-Build-Optimization-Agent-Skill (MIT)"
 ---
 
 # SPM Build Analysis

package/pipeline/skills/shared/external/storekit/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: storekit
 description: "Implement, review, or improve in-app purchases and subscriptions using StoreKit 2. Use when building paywalls with SubscriptionStoreView or ProductView, processing transactions with Product and Transaction APIs, verifying entitlements, handling purchase flows (consumable, non-consumable, auto-renewable), implementing offer codes or promotional/win-back/introductory offers, managing subscription status and renewal state, setting up StoreKit testing with configuration files, or integrating Family Sharing, Ask to Buy, refund handling, and billing retry logic."
+metadata:
+  source: "dpearson2699/swift-ios-skills (PolyForm Perimeter 1.0.0)"
 ---
 
 # StoreKit 2 In-App Purchases and Subscriptions

package/pipeline/skills/shared/external/swift-api-design-guidelines/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: swift-api-design-guidelines
 description: "Swift API Design Guidelines: clarity at the point of use, naming for readability over brevity, argument labels and prepositional phrases, method vs property choice, mutating/nonmutating pairs, protocol naming, generic parameter names, and documentation comment conventions. Use when naming a type, method or parameter, deciding between a method and a property, writing doc comments, or reviewing an API surface for consistency with the standard library."
+metadata:
+  source: "dpearson2699/swift-ios-skills (PolyForm Perimeter 1.0.0)"
 ---
 
 # Swift API Design Guidelines

package/pipeline/skills/shared/external/swift-architecture/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: swift-architecture
 description: "Select, implement, or migrate between app architecture patterns for Apple platform apps. Use when choosing between MV (Model-View with @Observable), MVVM, MVI, TCA (The Composable Architecture), Clean Architecture, VIPER, or Coordinator patterns; when evaluating architecture fit for a feature's complexity; when migrating from one pattern to another; or when reviewing whether an app's current architecture is appropriate. Scoped to Apple-platform patterns using Swift 6.3, SwiftUI, and UIKit."
+metadata:
+  source: "dpearson2699/swift-ios-skills (PolyForm Perimeter 1.0.0)"
 ---
-
 # Swift Architecture
 
 Select and implement the right architecture pattern for Apple platform apps built with Swift 6.3 and SwiftUI or UIKit.

package/pipeline/skills/shared/external/swift-charts/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: swift-charts
 description: "Implement, review, or improve data visualizations using Swift Charts. Use when building bar, line, area, point, pie, donut, or iOS 26 3D charts; when adding chart selection, scrolling, annotations, axes, scales, legends, or foregroundStyle grouping; when plotting functions with BarPlot, LinePlot, AreaPlot, PointPlot, Chart3D, or SurfacePlot; or when creating heat maps, Gantt charts, grouped bars, sparklines, threshold lines, or spatial visualizations."
+metadata:
+  source: "dpearson2699/swift-ios-skills (PolyForm Perimeter 1.0.0)"
 ---
-
 # Swift Charts
 
 Build data visualizations with Swift Charts targeting iOS 26+. Compose marks

package/pipeline/skills/shared/external/swift-codable/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: swift-codable
 description: "Implement Swift Codable models for JSON and property-list encoding and decoding with JSONDecoder, JSONEncoder, CodingKeys, and custom init(from:) or encode(to:). Use when parsing API responses, remapping keys, flattening nested JSON, handling date or data decoding strategies, decoding heterogeneous arrays, or integrating Codable with URLSession, SwiftData, or UserDefaults."
+metadata:
+  source: "dpearson2699/swift-ios-skills (PolyForm Perimeter 1.0.0)"
 ---
 
 # Swift Codable

package/pipeline/skills/shared/external/swift-concurrency/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: swift-concurrency
-description: "Resolve Swift concurrency compiler errors, adopt approachable concurrency (SE-0466), and write data-race-safe async code. Use when fixing Sendable conformance errors, actor isolation warnings, or strict concurrency diagnostics; when adopting default MainActor isolation, @concurrent, nonisolated(nonsending), or Task.immediate; when designing actor-based architectures, structured concurrency with TaskGroup, or background work offloading; or when migrating from @preconcurrency to full Swift 6 strict concurrency."
+description: "Swift concurrency language reference and migration: Sendable and actor-isolation diagnostics, approachable concurrency (SE-0466 default MainActor, @concurrent, nonisolated(nonsending), Task.immediate), actors, TaskGroup and the Swift 6 strict-mode migration. Use when fixing strict-concurrency errors or migrating; for the smallest fix to one diagnostic use swift-concurrency-expert, for a file-by-file review swift-concurrency-pro."
+metadata:
+  source: "dpearson2699/swift-ios-skills (PolyForm Perimeter 1.0.0)"
 ---
 
 # Swift Concurrency

package/pipeline/skills/shared/external/swift-concurrency-expert/SKILL.md

@@ -1,9 +1,10 @@
 ---
 name: swift-concurrency-expert
-description: "Review and fix Swift concurrency issues such as actor isolation and Sendable violations. Use when a Swift concurrency problem needs diagnosing, such as actor isolation or a Sendable violation."
-risk: safe
-source: "Dimillian/Skills (MIT)"
-date_added: "2026-03-25"
+description: "Review and fix Swift concurrency issues such as actor isolation and Sendable violations. Use when a Swift concurrency problem needs diagnosing, such as actor isolation or a Sendable violation; for Swift 6 migration use swift-concurrency, for a file-by-file review swift-concurrency-pro."
+metadata:
+  risk: safe
+  source: "Dimillian/Skills (MIT)"
+  date_added: "2026-03-25"
 ---
 
 # Swift Concurrency Expert