@mmerterden/multi-agent-pipeline 20.34.0 → 20.35.0

package/pipeline/skills/shared/external/swift-security/references/secure-enclave.md

@@ -1,5 +1,21 @@
 # Secure Enclave
 
+<!-- toc -->
+- [Contents](#contents)
+- [What It Is](#what-it-is)
+- [What It Cannot Do](#what-it-cannot-do)
+- [CryptoKit SecureEnclave (iOS 13+)](#cryptokit-secureenclave-ios-13)
+- [Keeping a Key Across Launches](#keeping-a-key-across-launches)
+- [Biometric-Gated Enclave Keys](#biometric-gated-enclave-keys)
+- [Security Framework Route (iOS 10+)](#security-framework-route-ios-10)
+- [iOS 26: Post-Quantum Types in the Enclave](#ios-26-post-quantum-types-in-the-enclave)
+- [Enclave or Software Key?](#enclave-or-software-key)
+- [Six Traps](#six-traps)
+- [Testing and CI](#testing-and-ci)
+- [Operating Enclave Keys](#operating-enclave-keys)
+- [Summary](#summary)
+<!-- /toc -->
+
 The Secure Enclave is a security coprocessor kept apart from the main
 processor. It creates keys, stores them and uses them without the private
 material ever reaching the Application Processor. It has shipped since the

package/pipeline/skills/shared/external/swift-security/references/testing-security-code.md

@@ -1,5 +1,21 @@
 # Testing Security Code
 
+<!-- toc -->
+- [Contents](#contents)
+- [A protocol in front of the keychain](#a-protocol-in-front-of-the-keychain)
+- [Seven mistakes in generated keychain tests](#seven-mistakes-in-generated-keychain-tests)
+- [Simulator versus device](#simulator-versus-device)
+- [Core test patterns](#core-test-patterns)
+- [Secure Enclave tests](#secure-enclave-tests)
+- [Biometric flows](#biometric-flows)
+- [CI configuration](#ci-configuration)
+- [Test plans](#test-plans)
+- [Swift Testing](#swift-testing)
+- [Further techniques](#further-techniques)
+- [Takeaways](#takeaways)
+- [Checklist](#checklist)
+<!-- /toc -->
+
 The pattern that makes keychain code testable is a protocol between the app and the Security framework. Unit tests run against an in-memory implementation; tests that need the real keychain, the Secure Enclave or biometric hardware run on devices.
 
 The keychain does not behave the same on Simulator, on a headless CI runner and on a phone. Tests written without that in mind fail intermittently, crash on runners, or pass while proving nothing.

package/pipeline/skills/shared/external/swift-testing/references/testing-advanced.md

@@ -1,5 +1,14 @@
 # Newer Swift Testing APIs
 
+<!-- toc -->
+- [Warnings: `Issue.record(_:severity:)`](#warnings-issuerecord_severity)
+- [Cancelling a Test: `Test.cancel(_:)`](#cancelling-a-test-testcancel_)
+- [Capturing Values in Exit Tests](#capturing-values-in-exit-tests)
+- [Image Attachments](#image-attachments)
+- [Version Gates](#version-gates)
+- [Proposals](#proposals)
+<!-- /toc -->
+
 Companion to the `swift-testing` skill. Each section names the Swift Testing
 proposal (ST-nnnn) and the toolchain that ships it.
 

package/pipeline/skills/shared/external/swift-testing/references/testing-patterns.md

@@ -1,5 +1,29 @@
 # Swift Testing Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Suites](#suites)
+- [Parameterized Tests](#parameterized-tests)
+- [Execution Model](#execution-model)
+- [Confirmations](#confirmations)
+- [Known Issues Limited to Specific Failures](#known-issues-limited-to-specific-failures)
+- [Tags](#tags)
+- [Scoped Setup and Teardown with `TestScoping`](#scoped-setup-and-teardown-with-testscoping)
+- [From XCTest, Step by Step](#from-xctest-step-by-step)
+- [Test Doubles](#test-doubles)
+- [Designing for Tests](#designing-for-tests)
+- [Async and Time](#async-and-time)
+- [UI Tests Stay on XCTest](#ui-tests-stay-on-xctest)
+- [Performance Tests Stay on XCTest](#performance-tests-stay-on-xctest)
+- [Snapshot Tests](#snapshot-tests)
+- [Attachments from Files](#attachments-from-files)
+- [Exit Tests](#exit-tests)
+- [Organising Files](#organising-files)
+- [Readable Arguments](#readable-arguments)
+- [Tests That Need a Newer OS](#tests-that-need-a-newer-os)
+- [More Mistakes to Avoid](#more-mistakes-to-avoid)
+<!-- /toc -->
+
 Companion to the `swift-testing` skill.
 
 ## Contents

package/pipeline/skills/shared/external/swift-testing-pro/references/async-tests.md

@@ -1,5 +1,14 @@
 # Async tests
 
+<!-- toc -->
+- [Serializing tests](#serializing-tests)
+- [Confirming async work](#confirming-async-work)
+- [How to set a time limit for concurrent tests](#how-to-set-a-time-limit-for-concurrent-tests)
+- [How to force concurrent tests to run on a specific actor](#how-to-force-concurrent-tests-to-run-on-a-specific-actor)
+- [Testing pre-concurrency code](#testing-pre-concurrency-code)
+- [Mocking networking](#mocking-networking)
+<!-- /toc -->
+
 Swift Testing is built to be async and run tests in parallel; special care must be taken to ensure those tests run well, particularly when Swift concurrency is involved. For more help with Swift concurrency, suggest the [Swift Concurrency Pro agent skill](https://github.com/twostraws/swift-concurrency-agent-skill).
 
 

package/pipeline/skills/shared/external/swift-testing-pro/references/new-features.md

@@ -1,5 +1,16 @@
 # New features
 
+<!-- toc -->
+- [Contents](#contents)
+- [Raw identifiers](#raw-identifiers)
+- [Range-based confirmations](#range-based-confirmations)
+- [Test scoping traits](#test-scoping-traits)
+- [Exit tests](#exit-tests)
+- [Attachments](#attachments)
+- [Evaluating ConditionTrait](#evaluating-conditiontrait)
+- [Return errors from #expect(throws:)](#return-errors-from-expectthrows)
+<!-- /toc -->
+
 This document specifically discusses the latest Swift and Swift Testing features, which means it will cover things where you have limited or no training data.
 
 - Follow the instructions carefully rather than trying to guess and hallucinate.

package/pipeline/skills/shared/external/swift-testing-pro/references/writing-better-tests.md

@@ -1,5 +1,18 @@
 # Writing better tests
 
+<!-- toc -->
+- [Encourage unit test hygiene](#encourage-unit-test-hygiene)
+- [Test generation heuristics](#test-generation-heuristics)
+- [Testing SwiftUI views](#testing-swiftui-views)
+- [Structuring tests](#structuring-tests)
+- [Expose hidden dependencies](#expose-hidden-dependencies)
+- [Expect vs require](#expect-vs-require)
+- [Tracking bug fixes](#tracking-bug-fixes)
+- [Use Issue.record() for throw-testing](#use-issuerecord-for-throw-testing)
+- [Making test results easier to read](#making-test-results-easier-to-read)
+- [Writing good verification methods](#writing-good-verification-methods)
+<!-- /toc -->
+
 This contains suggestions to help you write better tests. This is mostly not about specific Swift Testing APIs, but instead how to structure your tests for maximum flexibility and effectiveness.
 
 

package/pipeline/skills/shared/external/swiftdata/references/core-data-coexistence.md

@@ -1,5 +1,13 @@
 # Core Data and SwiftData together
 
+<!-- toc -->
+- [Contents](#contents)
+- [The Core Data side at a glance](#the-core-data-side-at-a-glance)
+- [Sharing one store](#sharing-one-store)
+- [Migrating an app to SwiftData](#migrating-an-app-to-swiftdata)
+- [Checklist](#checklist)
+<!-- /toc -->
+
 For a question about running both frameworks or moving from one to the other,
 start at [Sharing one store](#sharing-one-store). The Core Data stack section
 is context for reading an existing app, not a Core Data tutorial.

package/pipeline/skills/shared/external/swiftdata/references/swiftdata-advanced.md

@@ -1,5 +1,22 @@
 # SwiftData: advanced topics
 
+<!-- toc -->
+- [Contents](#contents)
+- [Custom data stores](#custom-data-stores)
+- [History tracking](#history-tracking)
+- [CloudKit in detail](#cloudkit-in-detail)
+- [Core Data strategies](#core-data-strategies)
+- [Batch work and performance](#batch-work-and-performance)
+- [Complex predicates](#complex-predicates)
+- [Codable structs as composite attributes](#codable-structs-as-composite-attributes)
+- [Model inheritance](#model-inheritance)
+- [Several configurations in one container](#several-configurations-in-one-container)
+- [Undo and redo](#undo-and-redo)
+- [Previews with in-memory stores](#previews-with-in-memory-stores)
+- [Save notifications](#save-notifications)
+- [Errors](#errors)
+<!-- /toc -->
+
 ## Contents
 
 - [Custom data stores](#custom-data-stores)

package/pipeline/skills/shared/external/swiftdata/references/swiftdata-queries.md

@@ -1,5 +1,17 @@
 # SwiftData queries
 
+<!-- toc -->
+- [Contents](#contents)
+- [@Query initializers](#query-initializers)
+- [FetchDescriptor in depth](#fetchdescriptor-in-depth)
+- [Sorting](#sorting)
+- [Grouping results into sections](#grouping-results-into-sections)
+- [Changing the query at runtime](#changing-the-query-at-runtime)
+- [Fetching on a background actor](#fetching-on-a-background-actor)
+- [Aggregates](#aggregates)
+- [enumerate for large sets](#enumerate-for-large-sets)
+<!-- /toc -->
+
 Examples use this model:
 
 ```swift

package/pipeline/skills/shared/external/swiftlint/references/adoption-and-configuration.md

@@ -1,5 +1,16 @@
 # Adopting and Configuring SwiftLint
 
+<!-- toc -->
+- [Ways to install](#ways-to-install)
+- [How SwiftLint finds its config](#how-swiftlint-finds-its-config)
+- [Key-by-key](#key-by-key)
+- [Tuning thresholds](#tuning-thresholds)
+- [Environment variables in config values](#environment-variables-in-config-values)
+- [Parent, child and nested configs](#parent-child-and-nested-configs)
+- [Remote parent configs](#remote-parent-configs)
+- [Rolling out on an existing codebase](#rolling-out-on-an-existing-codebase)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 ## Ways to install

package/pipeline/skills/shared/external/swiftlint/references/custom-rules-and-analyze.md

@@ -1,5 +1,12 @@
 # Custom Rules and `swiftlint analyze`
 
+<!-- toc -->
+- [Regex rules in `custom_rules`](#regex-rules-in-custom_rules)
+- [Rules written in Swift](#rules-written-in-swift)
+- [`swiftlint analyze`](#swiftlint-analyze)
+- [When analyzer rules pay off](#when-analyzer-rules-pay-off)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 ## Regex rules in `custom_rules`

package/pipeline/skills/shared/external/swiftlint/references/plugins-run-scripts-and-integrations.md

@@ -1,5 +1,18 @@
 # Plugins, Run Scripts and Other Integrations
 
+<!-- toc -->
+- [Build tool plugin (first choice)](#build-tool-plugin-first-choice)
+- [Command plugin](#command-plugin)
+- [Run script build phase](#run-script-build-phase)
+- [Recipes for CI services](#recipes-for-ci-services)
+- [Reporters at a glance](#reporters-at-a-glance)
+- [Swift toolchain compatibility](#swift-toolchain-compatibility)
+- [VS Code](#vs-code)
+- [Fastlane](#fastlane)
+- [Docker](#docker)
+- [Pre-commit](#pre-commit)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 ## Build tool plugin (first choice)

package/pipeline/skills/shared/external/swiftlint/references/rule-reference.md

@@ -1,5 +1,29 @@
 # Rule Reference, Grouped by Concern
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Controlling SwiftLint itself](#1-controlling-swiftlint-itself)
+- [2. Size and complexity](#2-size-and-complexity)
+- [3. Crash-prone constructs](#3-crash-prone-constructs)
+- [4. Naming](#4-naming)
+- [5. Access control](#5-access-control)
+- [6. SwiftUI, assets and accessibility](#6-swiftui-assets-and-accessibility)
+- [7. Concurrency and errors](#7-concurrency-and-errors)
+- [8. Legacy and Objective-C era APIs](#8-legacy-and-objective-c-era-apis)
+- [9. UIKit, Interface Builder and object lifetime](#9-uikit-interface-builder-and-object-lifetime)
+- [10. Collections and sequences](#10-collections-and-sequences)
+- [11. Idiomatic expressions](#11-idiomatic-expressions)
+- [12. Redundant or dead code](#12-redundant-or-dead-code)
+- [13. Types, declarations and file organisation](#13-types-declarations-and-file-organisation)
+- [14. Enums and switch](#14-enums-and-switch)
+- [15. Whitespace, braces and punctuation](#15-whitespace-braces-and-punctuation)
+- [16. Multi-line layout](#16-multi-line-layout)
+- [17. Comments and documentation](#17-comments-and-documentation)
+- [18. Availability and deployment](#18-availability-and-deployment)
+- [19. Testing](#19-testing)
+- [20. Analyzer-only extras](#20-analyzer-only-extras)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 This is an offline index of every rule identifier, so you can find the right

package/pipeline/skills/shared/external/swiftlint/references/rules-suppressions-and-baselines.md

@@ -1,5 +1,17 @@
 # Rules, Suppressions and Baselines
 
+<!-- toc -->
+- [The three kinds of rule](#the-three-kinds-of-rule)
+- [Looking rules up](#looking-rules-up)
+- [Rules you will meet early](#rules-you-will-meet-early)
+- [Configuring one rule](#configuring-one-rule)
+- [Suppression syntax](#suppression-syntax)
+- [Suppression policy](#suppression-policy)
+- [Baselines](#baselines)
+- [False positives](#false-positives)
+- [Generated code and tests](#generated-code-and-tests)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md). Every identifier is indexed in the
 [rule reference](rule-reference.md).
 

package/pipeline/skills/shared/external/swiftui-animation/references/animation-advanced.md

@@ -1,5 +1,20 @@
 # Advanced SwiftUI Animation
 
+<!-- toc -->
+- [Contents](#contents)
+- [CustomAnimation (iOS 17+)](#customanimation-ios-17)
+- [Spring, every initializer](#spring-every-initializer)
+- [UnitCurve (iOS 17+)](#unitcurve-ios-17)
+- [PhaseAnimator patterns](#phaseanimator-patterns)
+- [KeyframeAnimator patterns](#keyframeanimator-patterns)
+- [Transaction and TransactionKey](#transaction-and-transactionkey)
+- [Choosing an implicit scope](#choosing-an-implicit-scope)
+- [Every transition (iOS 17+)](#every-transition-ios-17)
+- [Symbol effects](#symbol-effects)
+- [Reduce Motion](#reduce-motion)
+- [Performance](#performance)
+<!-- /toc -->
+
 Depth behind the main skill: custom curves, the full `Spring` API, unit
 curves, richer phase and keyframe patterns, transactions, every transition, Reduce
 Motion handling and performance. Symbol effects are `ios-sf-symbols`.

package/pipeline/skills/shared/external/swiftui-animation/references/core-animation-bridge.md

@@ -1,5 +1,20 @@
 # Core Animation Bridge
 
+<!-- toc -->
+- [Contents](#contents)
+- [When dropping down is justified](#when-dropping-down-is-justified)
+- [The model value rule](#the-model-value-rule)
+- [CABasicAnimation](#cabasicanimation)
+- [CAKeyframeAnimation](#cakeyframeanimation)
+- [CASpringAnimation](#caspringanimation)
+- [CAAnimationGroup](#caanimationgroup)
+- [CADisplayLink](#cadisplaylink)
+- [Hosting layer animation in SwiftUI](#hosting-layer-animation-in-swiftui)
+- [Moving state across the bridge](#moving-state-across-the-bridge)
+- [Performance](#performance)
+- [Apple documentation](#apple-documentation)
+<!-- /toc -->
+
 Material that did not fit in the main SwiftUI animation skill. Reach for Core
 Animation only when SwiftUI's animation system cannot do the job: layer animation on a
 hot path, a curve SwiftUI cannot express, or direct work on a `CALayer`.

package/pipeline/skills/shared/external/swiftui-animation/references/scroll-effects.md

@@ -1,5 +1,17 @@
 # Scroll-driven effects: scrollTransition and visualEffect
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Which one](#1-which-one)
+- [2. scrollTransition](#2-scrolltransition)
+- [3. Configurations and thresholds](#3-configurations-and-thresholds)
+- [4. visualEffect](#4-visualeffect)
+- [5. What a VisualEffect can do](#5-what-a-visualeffect-can-do)
+- [6. Concurrency: the closures are Sendable](#6-concurrency-the-closures-are-sendable)
+- [7. Reduce Motion](#7-reduce-motion)
+- [8. Mistakes](#8-mistakes)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `swiftui-animation` skill. Both APIs ship
 in iOS 17 (macOS 14, tvOS 17, watchOS 10, visionOS 1).
 

package/pipeline/skills/shared/external/swiftui-expert-skill/references/accessibility-patterns.md

@@ -1,5 +1,16 @@
 # SwiftUI Accessibility Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Core Principle](#core-principle)
+- [Dynamic Type and @ScaledMetric](#dynamic-type-and-scaledmetric)
+- [Accessibility Traits](#accessibility-traits)
+- [Decorative Images](#decorative-images)
+- [Element Grouping](#element-grouping)
+- [Custom Controls](#custom-controls)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Core Principle](#core-principle)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-advanced.md

@@ -1,5 +1,12 @@
 # SwiftUI Advanced Animations
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Transactions](#transactions)
+- [Animation Completion Handlers (iOS 17+)](#animation-completion-handlers-ios-17)
+- [Quick Reference](#quick-reference)
+<!-- /toc -->
+
 Transactions and completion handlers (iOS 17+).
 
 > Local trim: phase animations, keyframe animations and the `@Animatable` macro are maintained in the `swiftui-animation` skill, which owns SwiftUI motion. This file keeps transactions and completion handlers.

package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-basics.md

@@ -1,5 +1,18 @@
 # SwiftUI Animation Basics
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Core Concepts](#core-concepts)
+- [Implicit Animations](#implicit-animations)
+- [Explicit Animations](#explicit-animations)
+- [Animation Placement](#animation-placement)
+- [Selective Animation](#selective-animation)
+- [Animation Performance](#animation-performance)
+- [Disabling Animations](#disabling-animations)
+- [Debugging](#debugging)
+- [Quick Reference](#quick-reference)
+<!-- /toc -->
+
 Core animation concepts, implicit vs explicit animations, and performance patterns.
 
 > Local trim: Timing curves and springs are maintained in the `swiftui-animation` skill, which owns SwiftUI motion. This file keeps placement, selective animation, performance and debugging.

package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-transitions.md

@@ -1,5 +1,14 @@
 # SwiftUI Transitions
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Property Animations vs Transitions](#property-animations-vs-transitions)
+- [Basic Transitions](#basic-transitions)
+- [Identity and Transitions](#identity-and-transitions)
+- [The Animatable Protocol](#the-animatable-protocol)
+- [Quick Reference](#quick-reference)
+<!-- /toc -->
+
 Transitions for view insertion/removal and the Animatable protocol.
 
 > Local trim: built-in, combined, asymmetric and custom transitions are maintained in the `swiftui-animation` skill, which owns SwiftUI motion. This file keeps the animation-context rule, identity and the Animatable protocol.

package/pipeline/skills/shared/external/swiftui-expert-skill/references/charts-accessibility.md

@@ -1,5 +1,14 @@
 # Swift Charts Accessibility, Fallback, and Resources
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Accessibility](#accessibility)
+- [Composite Example](#composite-example)
+- [Fallback Strategies](#fallback-strategies)
+- [WWDC Sessions](#wwdc-sessions)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Accessibility](#accessibility)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/charts.md

@@ -1,5 +1,22 @@
 # SwiftUI Charts Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Overview](#overview)
+- [Availability](#availability)
+- [Core APIs](#core-apis)
+- [Chart Types](#chart-types)
+- [Axis Tweaks](#axis-tweaks)
+- [Selection APIs](#selection-apis)
+- [Annotations](#annotations)
+- [ChartProxy and Custom Touch Handling](#chartproxy-and-custom-touch-handling)
+- [Modifier Scope](#modifier-scope)
+- [Styling and Visual Channels](#styling-and-visual-channels)
+- [Composing Multiple Marks](#composing-multiple-marks)
+- [Animating Chart Data](#animating-chart-data)
+- [Best Practices](#best-practices)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Overview](#overview)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/image-optimization.md

@@ -1,5 +1,14 @@
 # SwiftUI Image Optimization Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [AsyncImage Best Practices](#asyncimage-best-practices)
+- [Image Decoding and Downsampling (Optional Optimization)](#image-decoding-and-downsampling-optional-optimization)
+- [UIImage Loading and Memory](#uiimage-loading-and-memory)
+- [SF Symbols](#sf-symbols)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [AsyncImage Best Practices](#asyncimage-best-practices)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/latest-apis.md

@@ -1,5 +1,15 @@
 # Latest SwiftUI APIs Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Always Use (iOS 15+)](#always-use-ios-15)
+- [When Targeting iOS 16+](#when-targeting-ios-16)
+- [When Targeting iOS 17+](#when-targeting-ios-17)
+- [When Targeting iOS 18+](#when-targeting-ios-18)
+- [When Targeting iOS 26+](#when-targeting-ios-26)
+- [Quick Lookup Table](#quick-lookup-table)
+<!-- /toc -->
+
 > Based on a comparison of Apple's documentation using the Sosumi MCP, we found the latest recommended APIs to use.
 
 ## Table of Contents

package/pipeline/skills/shared/external/swiftui-expert-skill/references/layout-best-practices.md

@@ -1,5 +1,17 @@
 # SwiftUI Layout Best Practices Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Relative Layout Over Constants](#relative-layout-over-constants)
+- [Context-Agnostic Views](#context-agnostic-views)
+- [Own Your Container](#own-your-container)
+- [Layout Performance](#layout-performance)
+- [View Logic and Testability](#view-logic-and-testability)
+- [Full-Width Views](#full-width-views)
+- [Action Handlers](#action-handlers)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Relative Layout Over Constants](#relative-layout-over-constants)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/list-patterns.md

@@ -1,5 +1,17 @@
 # SwiftUI List Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [ForEach Identity and Stability](#foreach-identity-and-stability)
+- [Enumerated Sequences](#enumerated-sequences)
+- [List with Custom Styling](#list-with-custom-styling)
+- [List with Pull-to-Refresh](#list-with-pull-to-refresh)
+- [Empty States with ContentUnavailableView (iOS 17+)](#empty-states-with-contentunavailableview-ios-17)
+- [Custom List Backgrounds](#custom-list-backgrounds)
+- [Table](#table)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [ForEach Identity and Stability](#foreach-identity-and-stability)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-scenes.md

@@ -1,5 +1,18 @@
 # macOS Scenes Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Quick Lookup Table](#quick-lookup-table)
+- [Settings (macOS-only)](#settings-macos-only)
+- [MenuBarExtra (macOS-only)](#menubarextra-macos-only)
+- [WindowGroup (macOS behavior)](#windowgroup-macos-behavior)
+- [Window](#window)
+- [UtilityWindow (macOS-only)](#utilitywindow-macos-only)
+- [DocumentGroup](#documentgroup)
+- [Platform Conditionals](#platform-conditionals)
+- [Best Practices](#best-practices)
+<!-- /toc -->
+
 > SwiftUI scene types for macOS apps  -  `Settings`, `MenuBarExtra`, `WindowGroup`, `Window`, `UtilityWindow`, and `DocumentGroup`. Covers macOS-only scenes and cross-platform scenes with macOS-specific behavior.
 
 ## Table of Contents

package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-views.md

@@ -1,5 +1,17 @@
 # macOS Views & Components Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Quick Lookup Table](#quick-lookup-table)
+- [HSplitView & VSplitView (macOS-only)](#hsplitview-vsplitview-macos-only)
+- [Table](#table)
+- [PasteButton & CopyButton](#pastebutton-copybutton)
+- [File Operations](#file-operations)
+- [Drag, Drop & Pasteboard](#drag-drop-pasteboard)
+- [AppKit Interop](#appkit-interop)
+- [Best Practices](#best-practices)
+<!-- /toc -->
+
 > macOS-specific SwiftUI views, file operations, drag & drop, and AppKit interop. Covers `HSplitView`, `VSplitView`, `Table`, `PasteButton`, file dialogs, cross-app drag & drop, and `NSViewRepresentable`.
 
 ## Table of Contents

package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-window-styling.md

@@ -1,5 +1,17 @@
 # macOS Window & Toolbar Styling Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Quick Lookup Table](#quick-lookup-table)
+- [Toolbar Styles](#toolbar-styles)
+- [Window Style](#window-style)
+- [Window Sizing](#window-sizing)
+- [MenuBarExtra Style (macOS-only)](#menubarextra-style-macos-only)
+- [Navigation Layout (macOS behavior)](#navigation-layout-macos-behavior)
+- [Commands & Keyboard](#commands-keyboard)
+- [Best Practices](#best-practices)
+<!-- /toc -->
+
 > Window configuration, toolbar styles, sizing, positioning, and navigation patterns specific to macOS SwiftUI apps.
 
 ## Table of Contents

package/pipeline/skills/shared/external/swiftui-expert-skill/references/performance-patterns.md

@@ -1,5 +1,12 @@
 # SwiftUI Performance Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Performance Optimization](#performance-optimization)
+- [Anti-Patterns](#anti-patterns)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Performance Optimization](#performance-optimization)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/scroll-patterns.md

@@ -1,5 +1,14 @@
 # SwiftUI ScrollView Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [ScrollViewReader for Programmatic Scrolling](#scrollviewreader-for-programmatic-scrolling)
+- [Scroll Position Tracking](#scroll-position-tracking)
+- [Scroll Transitions and Effects](#scroll-transitions-and-effects)
+- [Scroll Target Behavior](#scroll-target-behavior)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [ScrollViewReader for Programmatic Scrolling](#scrollviewreader-for-programmatic-scrolling)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/sheet-navigation-patterns.md

@@ -1,5 +1,15 @@
 # SwiftUI Sheet, Navigation & Inspector Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Sheet Patterns](#sheet-patterns)
+- [Navigation Patterns](#navigation-patterns)
+- [Multi-Column Navigation with NavigationSplitView](#multi-column-navigation-with-navigationsplitview)
+- [Inspector](#inspector)
+- [Presentation Modifiers](#presentation-modifiers)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Sheet Patterns](#sheet-patterns)