@mmerterden/multi-agent-pipeline 20.33.0 → 20.35.0

package/pipeline/skills/shared/external/swiftui-liquid-glass/references/liquid-glass.md

@@ -1,5 +1,27 @@
 # Liquid Glass API Reference
 
+<!-- toc -->
+- [Contents](#contents)
+- [Overview](#overview)
+- [glassEffect(_:in:)](#glasseffect_in)
+- [Glass](#glass)
+- [Clear glass and the dimming layer](#clear-glass-and-the-dimming-layer)
+- [GlassEffectContainer](#glasseffectcontainer)
+- [glassEffectID(_:in:)](#glasseffectid_in)
+- [glassEffectUnion(id:namespace:)](#glasseffectunionidnamespace)
+- [glassEffectTransition(_:) and GlassEffectTransition](#glasseffecttransition_-and-glasseffecttransition)
+- [Button styles](#button-styles)
+- [DefaultGlassEffectShape](#defaultglasseffectshape)
+- [Concentric shapes](#concentric-shapes)
+- [Custom bars: safeAreaBar](#custom-bars-safeareabar)
+- [Scroll edge effect](#scroll-edge-effect)
+- [Background extension (split views)](#background-extension-split-views)
+- [Availability gating](#availability-gating)
+- [Performance guidelines](#performance-guidelines)
+- [Examples](#examples)
+- [Apple documentation links](#apple-documentation-links)
+<!-- /toc -->
+
 Signatures and behaviour behind the `swiftui-liquid-glass` skill. Read its
 SKILL.md first for where glass belongs and the workflow; this file is the
 SwiftUI detail. UIKit is in [uikit-glass.md](uikit-glass.md).

package/pipeline/skills/shared/external/swiftui-liquid-glass/references/uikit-glass.md

@@ -1,5 +1,19 @@
 # Liquid Glass in UIKit
 
+<!-- toc -->
+- [Contents](#contents)
+- [Standard components first](#standard-components-first)
+- [UIGlassEffect](#uiglasseffect)
+- [UIGlassContainerEffect](#uiglasscontainereffect)
+- [Glass buttons](#glass-buttons)
+- [Corners: UICornerConfiguration](#corners-uicornerconfiguration)
+- [Scroll edge effects](#scroll-edge-effects)
+- [UIBackgroundExtensionView](#uibackgroundextensionview)
+- [Fallback and accessibility](#fallback-and-accessibility)
+- [Opting out for one release](#opting-out-for-one-release)
+- [Links](#links)
+<!-- /toc -->
+
 UIKit side of the `swiftui-liquid-glass` skill. Where glass belongs, regular
 versus clear, and the accessibility rules are in `../SKILL.md` and apply
 unchanged here. Every API in this file is iOS, iPadOS, Mac Catalyst and tvOS

package/pipeline/skills/shared/external/swiftui-navigation/references/deeplinks.md

@@ -1,5 +1,15 @@
 # Incoming Links and Handoff
 
+<!-- toc -->
+- [Shape of the solution](#shape-of-the-solution)
+- [Router entry points](#router-entry-points)
+- [Installing it once at the top](#installing-it-once-at-the-top)
+- [Rules and pitfalls](#rules-and-pitfalls)
+- [Universal links](#universal-links)
+- [Custom URL schemes](#custom-url-schemes)
+- [Handoff with NSUserActivity](#handoff-with-nsuseractivity)
+<!-- /toc -->
+
 Part of the `swiftui-navigation` skill. The aim is to send external URLs to
 the right screen inside the app, and to let the system handle anything the app
 does not own.

package/pipeline/skills/shared/external/swiftui-navigation/references/navigationstack.md

@@ -1,5 +1,15 @@
 # NavigationStack and Routers
 
+<!-- toc -->
+- [Building blocks](#building-blocks)
+- [A router with a per-tab stack](#a-router-with-a-per-tab-stack)
+- [Mapping destinations once](#mapping-destinations-once)
+- [One router per tab](#one-router-per-tab)
+- [Data-driven tabs, each with its own stack](#data-driven-tabs-each-with-its-own-stack)
+- [Rules worth keeping](#rules-worth-keeping)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Part of the `swiftui-navigation` skill. Use this when navigation is driven from
 code or from deep links and every tab needs a history of its own: one
 `NavigationStack` per tab, each bound to its own path and router.

package/pipeline/skills/shared/external/swiftui-navigation/references/sheets.md

@@ -1,5 +1,18 @@
 # Sheet Routing
 
+<!-- toc -->
+- [Building blocks](#building-blocks)
+- [The destination enum](#the-destination-enum)
+- [The mapping modifier](#the-mapping-modifier)
+- [Opening a sheet from deep in the tree](#opening-a-sheet-from-deep-in-the-tree)
+- [Wiring at the root](#wiring-at-the-root)
+- [Sheets that push their own screens](#sheets-that-push-their-own-screens)
+- [Rules worth keeping](#rules-worth-keeping)
+- [Presentation sizing](#presentation-sizing)
+- [Confirming dismissal](#confirming-dismissal)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Part of the `swiftui-navigation` skill. Routing every modal through one place
 lets any view open a sheet without threading bindings through its parents, and
 it keeps working as screens are added.

package/pipeline/skills/shared/external/swiftui-navigation/references/tabview.md

@@ -1,5 +1,15 @@
 # TabView Architecture
 
+<!-- toc -->
+- [Building blocks](#building-blocks)
+- [Selection with side effects](#selection-with-side-effects)
+- [Selection without side effects](#selection-without-side-effects)
+- [Rules worth keeping](#rules-worth-keeping)
+- [Tabs generated from data](#tabs-generated-from-data)
+- [Tab APIs from iOS 18 and iOS 26](#tab-apis-from-ios-18-and-ios-26)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Part of the `swiftui-navigation` skill. Goal: tabs that scale across platforms,
 with one source of truth for what each tab is and shows, different tab sets and
 sidebar groupings per platform, tabs generated from data, and a hook that can

package/pipeline/skills/shared/external/swiftui-patterns/references/architecture-patterns.md

@@ -1,5 +1,19 @@
 # Architecture Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. MV Principles](#1-mv-principles)
+- [2. Why Not MVVM](#2-why-not-mvvm)
+- [3. MV in Practice](#3-mv-in-practice)
+- [4. Working With an Existing View Model](#4-working-with-an-existing-view-model)
+- [5. When a New View Model Is Justified](#5-when-a-new-view-model-is-justified)
+- [6. Environment or Initializer Injection](#6-environment-or-initializer-injection)
+- [7. Testing Strategy](#7-testing-strategy)
+- [8. App Shell and Dependency Graph](#8-app-shell-and-dependency-graph)
+- [9. Lightweight Clients](#9-lightweight-clients)
+- [10. Further Reading](#10-further-reading)
+<!-- /toc -->
+
 The reasoning behind the Model-View default, the cases where a view model still
 earns its place, and a reference wiring for the app shell.
 

package/pipeline/skills/shared/external/swiftui-patterns/references/deprecated-migration.md

@@ -1,5 +1,35 @@
 # Deprecated API Migration
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. NavigationView to NavigationStack](#1-navigationview-to-navigationstack)
+- [2. NavigationView Sidebar to NavigationSplitView](#2-navigationview-sidebar-to-navigationsplitview)
+- [3. ObservableObject and @StateObject to @Observable and @State](#3-observableobject-and-stateobject-to-observable-and-state)
+- [4. @ObservedObject to let or @Bindable](#4-observedobject-to-let-or-bindable)
+- [5. @EnvironmentObject to @Environment](#5-environmentobject-to-environment)
+- [6. foregroundColor to foregroundStyle](#6-foregroundcolor-to-foregroundstyle)
+- [7. Single-Value onChange to Two-Value onChange](#7-single-value-onchange-to-two-value-onchange)
+- [8. ActionSheet to confirmationDialog](#8-actionsheet-to-confirmationdialog)
+- [9. Legacy Alert to alert with Actions](#9-legacy-alert-to-alert-with-actions)
+- [10. AnyView to @ViewBuilder and Concrete Types](#10-anyview-to-viewbuilder-and-concrete-types)
+- [11. onAppear with Task to .task](#11-onappear-with-task-to-task)
+- [12. presentationMode to dismiss](#12-presentationmode-to-dismiss)
+- [13. GeometryReader Overuse to containerRelativeFrame and Layout](#13-geometryreader-overuse-to-containerrelativeframe-and-layout)
+- [14. PreviewProvider to the #Preview Macro](#14-previewprovider-to-the-preview-macro)
+- [15. XCTest to Swift Testing](#15-xctest-to-swift-testing)
+- [16. onDelete and EditButton to swipeActions](#16-ondelete-and-editbutton-to-swipeactions)
+- [17. UIApplication.shared.open to openURL](#17-uiapplicationsharedopen-to-openurl)
+- [18. @FetchRequest to @Query](#18-fetchrequest-to-query)
+- [19. Type-Erased Returns to some and any](#19-type-erased-returns-to-some-and-any)
+- [20. sheet(isPresented:) with an Optional to sheet(item:)](#20-sheetispresented-with-an-optional-to-sheetitem)
+- [21. UIColor Interop to Asset Colors and Color.resolve](#21-uicolor-interop-to-asset-colors-and-colorresolve)
+- [22. ForEach over a Range to Identifiable Data](#22-foreach-over-a-range-to-identifiable-data)
+- [23. Toolbar Placements navigationBar to topBar](#23-toolbar-placements-navigationbar-to-topbar)
+- [24. cornerRadius to clipShape](#24-cornerradius-to-clipshape)
+- [25. tabItem to Tab (iOS 18)](#25-tabitem-to-tab-ios-18)
+- [26. showsIndicators to scrollIndicators](#26-showsindicators-to-scrollindicators)
+<!-- /toc -->
+
 A map from older SwiftUI and iOS patterns (iOS 15 era through iOS 26) to their
 current replacements. Each entry shows the old form, the new form, and notes.
 Code is written for iOS 26 and Swift 6.3. Every entry names the release its

package/pipeline/skills/shared/external/swiftui-patterns/references/platform-and-sharing.md

@@ -1,5 +1,21 @@
 # Platform and Sharing
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Transferable](#1-transferable)
+- [2. ShareLink](#2-sharelink)
+- [3. Drag and Drop](#3-drag-and-drop)
+- [4. Pasteboard](#4-pasteboard)
+- [5. Transferable Recipes](#5-transferable-recipes)
+- [6. Transferable Pitfalls](#6-transferable-pitfalls)
+- [7. Media Previews and Viewer](#7-media-previews-and-viewer)
+- [8. Top Bar Overlays](#8-top-bar-overlays)
+- [9. Title Menus](#9-title-menus)
+- [10. Input Toolbar](#10-input-toolbar)
+- [11. Menu Bar Commands](#11-menu-bar-commands)
+- [12. macOS Settings](#12-macos-settings)
+<!-- /toc -->
+
 Moving data in and out of the app (`Transferable`, `ShareLink`, drag and drop,
 the pasteboard), media previews, top bar overlays, title menus, input bars,
 menu bar commands and the macOS Settings window.

package/pipeline/skills/shared/external/swiftui-performance/references/demystify-swiftui-performance-wwdc23.md

@@ -1,5 +1,16 @@
 # Mental Model: Dependencies, Identity and Lifecycle
 
+<!-- toc -->
+- [The Model](#the-model)
+- [Dependencies Decide What Updates](#dependencies-decide-what-updates)
+- [Work That Does Not Belong in `body`](#work-that-does-not-belong-in-body)
+- [Identity for Lists and Tables](#identity-for-lists-and-tables)
+- [Initialisation and Lifecycle](#initialisation-and-lifecycle)
+- [Tools](#tools)
+- [Fix Patterns](#fix-patterns)
+- [Checking a Fix](#checking-a-fix)
+<!-- /toc -->
+
 Notes drawn from the WWDC23 session "Demystify SwiftUI performance". Use them
 to explain why a SwiftUI screen does more work than it should.
 

package/pipeline/skills/shared/external/swiftui-performance/references/optimizing-swiftui-performance-instruments.md

@@ -1,5 +1,16 @@
 # Profiling with the SwiftUI Instrument
 
+<!-- toc -->
+- [When It Is the Right Tool](#when-it-is-the-right-tool)
+- [Capture Setup](#capture-setup)
+- [The SwiftUI Lanes](#the-swiftui-lanes)
+- [Workflow: One Update Is Too Slow](#workflow-one-update-is-too-slow)
+- [Workflow: Too Many Updates](#workflow-too-many-updates)
+- [Cause and Effect Graph](#cause-and-effect-graph)
+- [Hot Spots and How to Fix Them](#hot-spots-and-how-to-fix-them)
+- [Measuring Again](#measuring-again)
+<!-- /toc -->
+
 Based on the WWDC25 session "Optimize SwiftUI performance with Instruments".
 The SwiftUI Instrument described here ships with Instruments 26.
 

package/pipeline/skills/shared/external/swiftui-performance/references/understanding-hangs-in-your-app.md

@@ -1,5 +1,15 @@
 # Hangs and the Main Run Loop
 
+<!-- toc -->
+- [What Counts as a Hang](#what-counts-as-a-hang)
+- [How the Main Thread Spends a Frame](#how-the-main-thread-spends-a-frame)
+- [Triage](#triage)
+- [Common Causes](#common-causes)
+- [Fix Patterns](#fix-patterns)
+- [Verification](#verification)
+- [What This Means for SwiftUI](#what-this-means-for-swiftui)
+<!-- /toc -->
+
 Based on Apple's article "Understanding hangs in your app" and the WWDC23
 session "Analyze hangs with Instruments".
 

package/pipeline/skills/shared/external/swiftui-performance-audit/references/code-smells.md

@@ -1,5 +1,13 @@
 # Common code smells and remediation patterns
 
+<!-- toc -->
+- [Intent](#intent)
+- [High-priority smells](#high-priority-smells)
+- [Observation fan-out](#observation-fan-out)
+- [Remediation notes](#remediation-notes)
+- [Triage order](#triage-order)
+<!-- /toc -->
+
 ## Intent
 
 Use this reference during code-first review to map visible SwiftUI patterns to likely runtime costs and safer remediation guidance.

package/pipeline/skills/shared/external/swiftui-ui-patterns/references/app-wiring.md

@@ -1,5 +1,17 @@
 # App wiring and dependency graph
 
+<!-- toc -->
+- [Intent](#intent)
+- [Recommended structure](#recommended-structure)
+- [Dependency selection](#dependency-selection)
+- [Root shell example (generic)](#root-shell-example-generic)
+- [Dependency graph modifier (generic)](#dependency-graph-modifier-generic)
+- [SwiftData / ModelContainer](#swiftdata-modelcontainer)
+- [Sheet routing (enum-driven)](#sheet-routing-enum-driven)
+- [When to use](#when-to-use)
+- [Caveats](#caveats)
+<!-- /toc -->
+
 ## Intent
 
 Show how to wire the app shell (TabView + NavigationStack + sheets) and install a global dependency graph (environment objects, services, streaming clients, SwiftData ModelContainer) in one place.

package/pipeline/skills/shared/external/swiftui-ui-patterns/references/menu-bar.md

@@ -1,5 +1,15 @@
 # Menu Bar
 
+<!-- toc -->
+- [Intent](#intent)
+- [Core patterns](#core-patterns)
+- [Example: basic command menu](#example-basic-command-menu)
+- [Example: insert and replace groups](#example-insert-and-replace-groups)
+- [Example: focused menu state](#example-focused-menu-state)
+- [Menu bar and Settings](#menu-bar-and-settings)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 ## Intent
 
 Use this when adding or customizing the macOS/iPadOS menu bar with SwiftUI commands.

package/pipeline/skills/shared/external/swiftui-ui-patterns/references/navigationstack.md

@@ -1,5 +1,16 @@
 # NavigationStack
 
+<!-- toc -->
+- [Intent](#intent)
+- [Core architecture](#core-architecture)
+- [Example: custom router with per-tab stack](#example-custom-router-with-per-tab-stack)
+- [Example: centralized destination mapping](#example-centralized-destination-mapping)
+- [Example: binding per tab (tabs with independent history)](#example-binding-per-tab-tabs-with-independent-history)
+- [Example: generic tabs with per-tab NavigationStack](#example-generic-tabs-with-per-tab-navigationstack)
+- [Design choices to keep](#design-choices-to-keep)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 ## Intent
 
 Use this pattern for programmatic navigation and deep links, especially when each tab needs an independent navigation history. The key idea is one `NavigationStack` per tab, each with its own path binding and router object.

package/pipeline/skills/shared/external/swiftui-ui-patterns/references/scroll-reveal.md

@@ -1,5 +1,17 @@
 # Scroll-reveal detail surfaces
 
+<!-- toc -->
+- [Intent](#intent)
+- [Core pattern](#core-pattern)
+- [Minimal structure](#minimal-structure)
+- [Design choices to keep](#design-choices-to-keep)
+- [Morphing a shared control](#morphing-a-shared-control)
+- [Haptics and affordances](#haptics-and-affordances)
+- [Interaction guards](#interaction-guards)
+- [Pitfalls](#pitfalls)
+- [Concrete example](#concrete-example)
+<!-- /toc -->
+
 ## Intent
 
 Use this pattern when a detail screen has a primary surface first and secondary content behind it, and you want the user to reveal that secondary layer by scrolling or swiping instead of tapping a separate button.

package/pipeline/skills/shared/external/swiftui-ui-patterns/references/sheets.md

@@ -1,5 +1,19 @@
 # Sheets
 
+<!-- toc -->
+- [Intent](#intent)
+- [Core architecture](#core-architecture)
+- [Example: item-driven local sheet](#example-item-driven-local-sheet)
+- [Example: SheetDestination enum](#example-sheetdestination-enum)
+- [Example: withSheetDestinations modifier](#example-withsheetdestinations-modifier)
+- [Example: presenting from a child view](#example-presenting-from-a-child-view)
+- [Required wiring](#required-wiring)
+- [Example: sheets that need their own navigation](#example-sheets-that-need-their-own-navigation)
+- [Example: sheet owns its actions](#example-sheet-owns-its-actions)
+- [Design choices to keep](#design-choices-to-keep)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 ## Intent
 
 Use a centralized sheet routing pattern so any view can present modals without prop-drilling. This keeps sheet state in one place and scales as the app grows.

package/pipeline/skills/shared/external/swiftui-ui-patterns/references/tabview.md

@@ -1,5 +1,15 @@
 # TabView
 
+<!-- toc -->
+- [Intent](#intent)
+- [Core architecture](#core-architecture)
+- [Example: custom binding with side effects](#example-custom-binding-with-side-effects)
+- [Example: direct binding without side effects](#example-direct-binding-without-side-effects)
+- [Design choices to keep](#design-choices-to-keep)
+- [Dynamic tabs pattern](#dynamic-tabs-pattern)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 ## Intent
 
 Use this pattern for a scalable, multi-platform tab architecture with:

package/pipeline/skills/shared/external/swiftui-uikit-interop/references/hosting-migration.md

@@ -1,5 +1,15 @@
 # Hosting and Incremental Migration
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Screen-by-Screen Migration](#1-screen-by-screen-migration)
+- [2. UIHostingController as Child](#2-uihostingcontroller-as-child)
+- [3. Navigation Bridging](#3-navigation-bridging)
+- [4. Data Sharing Between UIKit and SwiftUI](#4-data-sharing-between-uikit-and-swiftui)
+- [5. UIHostingConfiguration (iOS 16+)](#5-uihostingconfiguration-ios-16)
+- [6. Environment Bridging](#6-environment-bridging)
+<!-- /toc -->
+
 A UIKit app does not have to switch to SwiftUI in one release. These six
 patterns move it over piece by piece while both frameworks share the same
 navigation stack, the same models and the same traits.

package/pipeline/skills/shared/external/swiftui-uikit-interop/references/representable-recipes.md

@@ -1,5 +1,18 @@
 # Representable Recipes
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. MKMapView Wrapper](#1-mkmapview-wrapper)
+- [2. UITextView Wrapper (Attributed Text)](#2-uitextview-wrapper-attributed-text)
+- [3. AVCaptureVideoPreviewLayer Wrapper](#3-avcapturevideopreviewlayer-wrapper)
+- [4. PHPickerViewController Wrapper](#4-phpickerviewcontroller-wrapper)
+- [5. MFMailComposeViewController Wrapper](#5-mfmailcomposeviewcontroller-wrapper)
+- [6. UIActivityViewController Wrapper (Share Sheet)](#6-uiactivityviewcontroller-wrapper-share-sheet)
+- [7. UISearchBar Wrapper](#7-uisearchbar-wrapper)
+- [8. PDFView Wrapper (PDFKit)](#8-pdfview-wrapper-pdfkit)
+- [9. MFMessageComposeViewController Wrapper](#9-mfmessagecomposeviewcontroller-wrapper)
+<!-- /toc -->
+
 Nine wrappers for UIKit surfaces that SwiftUI apps still reach for. Every recipe
 gives the representable itself, its Coordinator and the delegate methods that
 matter, a short SwiftUI call site, and the traps specific to that wrapper. Many

package/pipeline/skills/shared/external/swiftui-view-refactor/references/mv-patterns.md

@@ -1,5 +1,17 @@
 # MV Patterns Reference
 
+<!-- toc -->
+- [Default stance](#default-stance)
+- [When to avoid a view model](#when-to-avoid-a-view-model)
+- [When a view model may be justified](#when-a-view-model-may-be-justified)
+- [Preferred pattern: local state plus environment](#preferred-pattern-local-state-plus-environment)
+- [Preferred pattern: use modifiers as lightweight orchestration](#preferred-pattern-use-modifiers-as-lightweight-orchestration)
+- [SwiftData note](#swiftdata-note)
+- [Testing guidance](#testing-guidance)
+- [Refactor checklist](#refactor-checklist)
+- [Bottom line](#bottom-line)
+<!-- /toc -->
+
 Distilled guidance for deciding whether a SwiftUI feature should stay as plain MV or introduce a view model.
 
 Inspired by the user's provided source, "SwiftUI in 2025: Forget MVVM" (Thomas Ricouard), but rewritten here as a practical refactoring reference.

package/pipeline/skills/shared/external/swiftui-webkit/references/loading-and-observation.md

@@ -1,5 +1,13 @@
 # Loading and observing pages
 
+<!-- toc -->
+- [The URL-only view](#the-url-only-view)
+- [Loading through a WebPage](#loading-through-a-webpage)
+- [Progress, title and other state](#progress-title-and-other-state)
+- [Following navigation events](#following-navigation-events)
+- [Throwaway pages and custom user agents](#throwaway-pages-and-custom-user-agents)
+<!-- /toc -->
+
 Part of the `swiftui-webkit` skill ([../SKILL.md](../SKILL.md)). All code
 needs iOS 26, iPadOS 26, macOS 26 or visionOS 26 and `import WebKit`.
 

package/pipeline/skills/shared/external/swiftui-webkit/references/navigation-and-javascript.md

@@ -1,5 +1,13 @@
 # Navigation and JavaScript
 
+<!-- toc -->
+- [An observable navigation decider](#an-observable-navigation-decider)
+- [Sending outside links to the system](#sending-outside-links-to-the-system)
+- [Running JavaScript](#running-javascript)
+- [Handing values to the script](#handing-values-to-the-script)
+- [Simple signals from the page to the app](#simple-signals-from-the-page-to-the-app)
+<!-- /toc -->
+
 Part of the `swiftui-webkit` skill ([../SKILL.md](../SKILL.md)).
 
 ## An observable navigation decider

package/pipeline/skills/shared/external/tipkit/references/tipkit-patterns.md

@@ -1,5 +1,19 @@
 # TipKit Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [A tip with both a parameter and an event rule](#a-tip-with-both-a-parameter-and-an-event-rule)
+- [Placing TipView and popoverTip](#placing-tipview-and-popovertip)
+- [Counting a manual action to suggest a shortcut](#counting-a-manual-action-to-suggest-a-shortcut)
+- [Events that carry a value](#events-that-carry-a-value)
+- [Custom TipViewStyle](#custom-tipviewstyle)
+- [Sequencing with TipGroup (iOS 18)](#sequencing-with-tipgroup-ios-18)
+- [Testing](#testing)
+- [Actions that open a feature](#actions-that-open-a-feature)
+- [Working alongside an onboarding flow](#working-alongside-an-onboarding-flow)
+- [A full app](#a-full-app)
+<!-- /toc -->
+
 Longer worked patterns for the `tipkit` skill. Every example targets iOS 17 or
 later and follows Swift 6.3 conventions; a heading says so when a newer
 release is needed.

package/pipeline/skills/shared/external/vision-framework/references/vision-requests.md

@@ -1,5 +1,22 @@
 # Vision request recipes
 
+<!-- toc -->
+- [Contents](#contents)
+- [Text recognition pipeline](#text-recognition-pipeline)
+- [Faces with landmarks and quality](#faces-with-landmarks-and-quality)
+- [Barcodes](#barcodes)
+- [Person segmentation and background blur](#person-segmentation-and-background-blur)
+- [Classification](#classification)
+- [Saliency](#saliency)
+- [Rectangles](#rectangles)
+- [Horizon](#horizon)
+- [Several requests on one image](#several-requests-on-one-image)
+- [Camera frames from AVFoundation](#camera-frames-from-avfoundation)
+- [Tracking across frames](#tracking-across-frames)
+- [Coordinate helpers](#coordinate-helpers)
+- [Performance](#performance)
+<!-- /toc -->
+
 Longer examples for the requests summarized in `../SKILL.md`. Swift-native
 examples need iOS 18 or later unless marked otherwise; legacy examples are
 labelled.

package/pipeline/skills/shared/external/vision-framework/references/visionkit-scanner.md

@@ -1,5 +1,16 @@
 # VisionKit scanners
 
+<!-- toc -->
+- [Contents](#contents)
+- [Camera permission](#camera-permission)
+- [DataScannerViewController](#datascannerviewcontroller)
+- [Delegate callbacks](#delegate-callbacks)
+- [SwiftUI](#swiftui)
+- [Custom overlay](#custom-overlay)
+- [VNDocumentCameraViewController](#vndocumentcameraviewcontroller)
+- [Performance](#performance)
+<!-- /toc -->
+
 Camera UI that VisionKit provides on top of Vision: the live
 `DataScannerViewController` and the paper-oriented
 `VNDocumentCameraViewController`. Summary in `../SKILL.md`.

package/pipeline/skills/shared/external/weatherkit/references/weatherkit-patterns.md

@@ -1,5 +1,16 @@
 # WeatherKit Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [WeatherKit SwiftUI integration](#weatherkit-swiftui-integration)
+- [Attribution view](#attribution-view)
+- [Charts integration](#charts-integration)
+- [Historical weather statistics](#historical-weather-statistics)
+- [Weather condition mapping](#weather-condition-mapping)
+- [Caching strategy](#caching-strategy)
+- [Location-based weather](#location-based-weather)
+<!-- /toc -->
+
 Larger building blocks for the `weatherkit` skill. Its SKILL.md covers setup,
 queries, alerts, availability and the attribution rules; this file puts them
 together.

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

@@ -1,5 +1,32 @@
 # WidgetKit: extended patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Timeline Strategies](#timeline-strategies)
+- [Reloading timelines by push](#reloading-timelines-by-push)
+- [Deep Links and Widget URLs](#deep-links-and-widget-urls)
+- [User-configurable widgets through App Intents](#user-configurable-widgets-through-app-intents)
+- [Multiple Widget Support](#multiple-widget-support)
+- [Previewing widgets and their snapshot state](#previewing-widgets-and-their-snapshot-state)
+- [AccessoryWidgetBackground](#accessorywidgetbackground)
+- [Lock Screen Accessory Widget Example](#lock-screen-accessory-widget-example)
+- [Live Activity Full ActivityConfiguration Example](#live-activity-full-activityconfiguration-example)
+- [Control Center Control Examples](#control-center-control-examples)
+- [Laying out the expanded Dynamic Island](#laying-out-the-expanded-dynamic-island)
+- [Live Activity alerts](#live-activity-alerts)
+- [Live Activity Push Updates](#live-activity-push-updates)
+- [ActivityAuthorizationInfo](#activityauthorizationinfo)
+- [Keeping widgets fast](#keeping-widgets-fast)
+- [Xcode Setup](#xcode-setup)
+- [Smart Stack relevance](#smart-stack-relevance)
+- [ActivityState Lifecycle](#activitystate-lifecycle)
+- [ActivityStyle](#activitystyle)
+- [Dismissal Policies](#dismissal-policies)
+- [Finding which widgets and activities are live](#finding-which-widgets-and-activities-are-live)
+- [Design Patterns](#design-patterns)
+- [Further reading from Apple](#further-reading-from-apple)
+<!-- /toc -->
+
 Companion to the `widgetkit` skill. Everything here assumes iOS 26 SDKs unless a
 heading says otherwise.
 

package/pipeline/skills/shared/external/xcode-build-fixer/references/build-settings-best-practices.md

@@ -1,5 +1,14 @@
 # Build Settings Best Practices
 
+<!-- toc -->
+- [How To Read This Reference](#how-to-read-this-reference)
+- [Debug Configuration](#debug-configuration)
+- [Release Configuration](#release-configuration)
+- [General (All Configurations)](#general-all-configurations)
+- [Cross-Target Consistency](#cross-target-consistency)
+- [Checklist Output Format](#checklist-output-format)
+<!-- /toc -->
+
 This reference lists Xcode build settings that affect build performance. Use it to audit a project and produce a pass/fail checklist.
 
 The scope is strictly **build performance**. Do not flag language-migration settings like `SWIFT_STRICT_CONCURRENCY` or `SWIFT_UPCOMING_FEATURE_*` -- those are developer adoption choices unrelated to build speed.

package/pipeline/skills/shared/external/xcode-build-fixer/references/fix-patterns.md

@@ -1,5 +1,12 @@
 # Fix Patterns
 
+<!-- toc -->
+- [Build Settings Fixes](#build-settings-fixes)
+- [Script Phase Fixes](#script-phase-fixes)
+- [Source-Level Fixes](#source-level-fixes)
+- [SPM Restructuring Fixes](#spm-restructuring-fixes)
+<!-- /toc -->
+
 Concrete before/after examples for each fix category. Reference this when applying approved changes to ensure consistency.
 
 ## Build Settings Fixes

package/pipeline/skills/shared/external/xcode-build-orchestrator/references/build-settings-best-practices.md

@@ -1,5 +1,14 @@
 # Build Settings Best Practices
 
+<!-- toc -->
+- [How To Read This Reference](#how-to-read-this-reference)
+- [Debug Configuration](#debug-configuration)
+- [Release Configuration](#release-configuration)
+- [General (All Configurations)](#general-all-configurations)
+- [Cross-Target Consistency](#cross-target-consistency)
+- [Checklist Output Format](#checklist-output-format)
+<!-- /toc -->
+
 This reference lists Xcode build settings that affect build performance. Use it to audit a project and produce a pass/fail checklist.
 
 The scope is strictly **build performance**. Do not flag language-migration settings like `SWIFT_STRICT_CONCURRENCY` or `SWIFT_UPCOMING_FEATURE_*` -- those are developer adoption choices unrelated to build speed.

package/pipeline/skills/shared/external/xcode-compilation-analyzer/references/build-optimization-sources.md

@@ -1,5 +1,19 @@
 # Build Optimization Sources
 
+<!-- toc -->
+- [Apple: Improving the speed of incremental builds](#apple-improving-the-speed-of-incremental-builds)
+- [Apple: Improving build efficiency with good coding practices](#apple-improving-build-efficiency-with-good-coding-practices)
+- [Apple: Building your project with explicit module dependencies](#apple-building-your-project-with-explicit-module-dependencies)
+- [SwiftLee: Build performance analysis for speeding up Xcode builds](#swiftlee-build-performance-analysis-for-speeding-up-xcode-builds)
+- [Apple: Xcode Release Notes -- Compilation Caching](#apple-xcode-release-notes----compilation-caching)
+- [Apple: Demystify explicitly built modules (WWDC24)](#apple-demystify-explicitly-built-modules-wwdc24)
+- [Swift Compile-Time Best Practices](#swift-compile-time-best-practices)
+- [Bitrise: Demystifying Explicitly Built Modules for Xcode](#bitrise-demystifying-explicitly-built-modules-for-xcode)
+- [Bitrise: Xcode Compilation Cache FAQ](#bitrise-xcode-compilation-cache-faq)
+- [RocketSim Docs: Build Insights](#rocketsim-docs-build-insights)
+- [Swift Forums: Slow incremental builds because of planning swift module](#swift-forums-slow-incremental-builds-because-of-planning-swift-module)
+<!-- /toc -->
+
 This file stores the external sources that the README and skill docs should cite consistently.
 
 ## Apple: Improving the speed of incremental builds