@mmerterden/multi-agent-pipeline 20.34.0 → 20.36.0

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)

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

@@ -1,5 +1,23 @@
 # SwiftUI State Management Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Property Wrapper Selection Guide](#property-wrapper-selection-guide)
+- [@State](#state)
+- [Property Wrappers Inside @Observable Classes](#property-wrappers-inside-observable-classes)
+- [@Binding](#binding)
+- [@FocusState](#focusstate)
+- [@StateObject vs @ObservedObject (Legacy - Pre-iOS 17)](#stateobject-vs-observedobject-legacy---pre-ios-17)
+- [Don't Pass Values as @State](#dont-pass-values-as-state)
+- [@Bindable (iOS 17+)](#bindable-ios-17)
+- [let vs var for Passed Values](#let-vs-var-for-passed-values)
+- [Environment and Preferences](#environment-and-preferences)
+- [Decision Flowchart](#decision-flowchart)
+- [State Privacy Rules](#state-privacy-rules)
+- [Avoid Nested ObservableObject](#avoid-nested-observableobject)
+- [Key Principles](#key-principles)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Property Wrapper Selection Guide](#property-wrapper-selection-guide)

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

@@ -1,5 +1,21 @@
 # SwiftUI View Structure Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [View Structure Principles](#view-structure-principles)
+- [Prefer Modifiers Over Conditional Views](#prefer-modifiers-over-conditional-views)
+- [Extract Subviews, Not Computed Properties](#extract-subviews-not-computed-properties)
+- [When @ViewBuilder Functions Are Acceptable](#when-viewbuilder-functions-are-acceptable)
+- [When to Extract Subviews](#when-to-extract-subviews)
+- [Container View Pattern](#container-view-pattern)
+- [ZStack vs overlay/background](#zstack-vs-overlaybackground)
+- [Compositing Group Before Clipping](#compositing-group-before-clipping)
+- [Reusable Styling with ViewModifier](#reusable-styling-with-viewmodifier)
+- [Skeleton Loading with Redacted Views](#skeleton-loading-with-redacted-views)
+- [UIViewRepresentable Essentials](#uiviewrepresentable-essentials)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [View Structure Principles](#view-structure-principles)

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

@@ -1,5 +1,16 @@
 # Gesture Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Pinch-to-zoom with MagnifyGesture](#pinch-to-zoom-with-magnifygesture)
+- [Combined rotate and scale](#combined-rotate-and-scale)
+- [Drag-to-reorder](#drag-to-reorder)
+- [Gesture velocity calculations](#gesture-velocity-calculations)
+- [Long-press then drag](#long-press-then-drag)
+- [SwiftUI and UIKit gesture interop](#swiftui-and-uikit-gesture-interop)
+- [Accessibility considerations](#accessibility-considerations)
+<!-- /toc -->
+
 Worked interactions for the `swiftui-gestures` skill. The SKILL.md explains the
 gesture types, composition and `@GestureState`; this file assumes that
 material.

package/pipeline/skills/shared/external/swiftui-layout-components/references/form.md

@@ -1,5 +1,13 @@
 # Forms
 
+<!-- toc -->
+- [When to use Form](#when-to-use-form)
+- [Settings form](#settings-form)
+- [Modal form with validation](#modal-form-with-validation)
+- [Design choices](#design-choices)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Form guidance for the `swiftui-layout-components` skill.
 
 ## When to use Form

package/pipeline/skills/shared/external/swiftui-layout-components/references/grids.md

@@ -1,5 +1,19 @@
 # Grids
 
+<!-- toc -->
+- [When a grid is the right shape](#when-a-grid-is-the-right-shape)
+- [Picking the grid type](#picking-the-grid-type)
+- [Column strategies](#column-strategies)
+- [Sizing cells](#sizing-cells)
+- [Adaptive picker with selection](#adaptive-picker-with-selection)
+- [Three-up media gallery](#three-up-media-gallery)
+- [Sections in a grid](#sections-in-a-grid)
+- [Selection and interaction](#selection-and-interaction)
+- [Performance](#performance)
+- [Accessibility](#accessibility)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Grid guidance for the `swiftui-layout-components` skill.
 
 ## When a grid is the right shape

package/pipeline/skills/shared/external/swiftui-layout-components/references/scrollview.md

@@ -1,5 +1,14 @@
 # Scroll Views
 
+<!-- toc -->
+- [When to use ScrollView](#when-to-use-scrollview)
+- [Conversation screen](#conversation-screen)
+- [ScrollPosition](#scrollposition)
+- [More shapes](#more-shapes)
+- [Scroll edge effects (iOS 26)](#scroll-edge-effects-ios-26)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Scroll view guidance for the `swiftui-layout-components` skill.
 
 ## When to use ScrollView

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: