@mmerterden/multi-agent-pipeline 20.34.0 → 20.36.0

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

@@ -1,5 +1,20 @@
 # Compose Testing Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [ComposeTestRule Setup](#composetestrule-setup)
+- [Finding Nodes](#finding-nodes)
+- [Test Tags from a Generated Registry](#test-tags-from-a-generated-registry)
+- [Performing Actions](#performing-actions)
+- [Assertions](#assertions)
+- [Testing State Changes](#testing-state-changes)
+- [ViewModel Test Base Class](#viewmodel-test-base-class)
+- [ViewModel Testing with Turbine](#viewmodel-testing-with-turbine)
+- [TestDispatcher and runTest](#testdispatcher-and-runtest)
+- [Screenshot Testing](#screenshot-testing)
+- [Compose Preview Screenshot Testing](#compose-preview-screenshot-testing)
+<!-- /toc -->
+
 Full code examples for the Compose testing guide. Load this when you need a
 complete, copyable example for a specific area: rule setup, node selection,
 actions, assertions, state changes, ViewModel/Turbine tests, coroutine test

package/pipeline/skills/shared/external/contacts-framework/references/contacts-patterns.md

@@ -1,5 +1,14 @@
 # Contacts patterns
 
+<!-- toc -->
+- [SwiftUI integration](#swiftui-integration)
+- [Selecting several contacts](#selecting-several-contacts)
+- [Searching](#searching)
+- [vCard](#vcard)
+- [Groups](#groups)
+- [Change notifications and what Swift can do](#change-notifications-and-what-swift-can-do)
+<!-- /toc -->
+
 Longer examples for the `contacts-framework` skill ([../SKILL.md](../SKILL.md)).
 
 ## SwiftUI integration

package/pipeline/skills/shared/external/core-bluetooth/references/ble-patterns.md

@@ -1,5 +1,16 @@
 # BLE Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [A SwiftUI heart-rate monitor](#a-swiftui-heart-rate-monitor)
+- [Reconnecting](#reconnecting)
+- [Parsing bytes safely](#parsing-bytes-safely)
+- [Write flow control](#write-flow-control)
+- [Several peripherals at once](#several-peripherals-at-once)
+- [L2CAP channels](#l2cap-channels)
+- [Answering requests as a peripheral](#answering-requests-as-a-peripheral)
+<!-- /toc -->
+
 Longer recipes for the `core-bluetooth` skill.
 
 ## Contents

package/pipeline/skills/shared/external/core-motion/references/motion-patterns.md

@@ -1,5 +1,15 @@
 # Motion patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [A shared @Observable motion service for SwiftUI](#a-shared-observable-motion-service-for-swiftui)
+- [CMBatchedSensorManager for high-rate capture](#cmbatchedsensormanager-for-high-rate-capture)
+- [Head tracking with CMHeadphoneMotionManager](#head-tracking-with-cmheadphonemotionmanager)
+- [A step dashboard](#a-step-dashboard)
+- [Switching app modes from activity](#switching-app-modes-from-activity)
+- [Water submersion on watchOS](#water-submersion-on-watchos)
+<!-- /toc -->
+
 Companion material for the core-motion skill. Each section is a self-contained
 pattern that goes beyond the basics in [../SKILL.md](../SKILL.md).
 

package/pipeline/skills/shared/external/core-nfc/references/nfc-patterns.md

@@ -1,5 +1,18 @@
 # Core NFC Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Handling several tags at once](#handling-several-tags-at-once)
+- [ISO 7816 APDU commands](#iso-7816-apdu-commands)
+- [ISO 15693 tags](#iso-15693-tags)
+- [MIFARE tags](#mifare-tags)
+- [FeliCa tags](#felica-tags)
+- [Messages with several records](#messages-with-several-records)
+- [Locking a tag](#locking-a-tag)
+- [A SwiftUI scanner](#a-swiftui-scanner)
+- [Error codes](#error-codes)
+<!-- /toc -->
+
 Longer examples for the `core-nfc` skill. Each snippet assumes the session is
 already running and the tag is connected, as shown in the parent SKILL.md. Tag
 calls use their `async` forms from inside a `Task`, which avoids the Swift 6

package/pipeline/skills/shared/external/coreml/references/coreml-swift-integration.md

@@ -1,5 +1,25 @@
 # Core ML in Swift: extended patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [An actor that owns models](#an-actor-that-owns-models)
+- [Generated classes](#generated-classes)
+- [A hand-written feature provider](#a-hand-written-feature-provider)
+- [Predictions in async code](#predictions-in-async-code)
+- [Batch inference](#batch-inference)
+- [Stateful sessions with MLState (iOS 18+)](#stateful-sessions-with-mlstate-ios-18)
+- [Pixel buffers](#pixel-buffers)
+- [MLMultiArray](#mlmultiarray)
+- [MLTensor (iOS 18+)](#mltensor-ios-18)
+- [Vision and Core ML together](#vision-and-core-ml-together)
+- [NaturalLanguage models](#naturallanguage-models)
+- [MLComputePlan in detail (iOS 17.4+)](#mlcomputeplan-in-detail-ios-174)
+- [Lifecycle: warm up and release](#lifecycle-warm-up-and-release)
+- [Errors](#errors)
+- [Tests with Swift Testing](#tests-with-swift-testing)
+- [Memory practices](#memory-practices)
+<!-- /toc -->
+
 Companion to `../SKILL.md`. Baseline iOS 26 and Swift 6.3; lower floors are
 called out per API, and most of this works back to iOS 14 when the newer calls
 are left out.

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

@@ -1,5 +1,21 @@
 # CryptoKit patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Key serialization](#key-serialization)
+- [Keychain storage](#keychain-storage)
+- [AES key wrap](#aes-key-wrap)
+- [HKDF on its own](#hkdf-on-its-own)
+- [HPKE details](#hpke-details)
+- [Post-quantum usage](#post-quantum-usage)
+- [The Insecure namespace](#the-insecure-namespace)
+- [Sealed box layout](#sealed-box-layout)
+- [Signing a digest](#signing-a-digest)
+- [Export compliance](#export-compliance)
+- [Performance](#performance)
+- [Moving from CommonCrypto](#moving-from-commoncrypto)
+<!-- /toc -->
+
 Detail that sits behind the main skill: how keys are serialized and stored,
 less common primitives, sizes, compliance and migration.
 

package/pipeline/skills/shared/external/debugging-instruments/references/instruments-guide.md

@@ -1,5 +1,21 @@
 # Instruments Guide
 
+<!-- toc -->
+- [Workflow That Fits Every Template](#workflow-that-fits-every-template)
+- [Time Profiler](#time-profiler)
+- [Allocations](#allocations)
+- [Leaks](#leaks)
+- [Network](#network)
+- [SwiftUI](#swiftui)
+- [Animation Hitches and Core Animation](#animation-hitches-and-core-animation)
+- [Power Profiler](#power-profiler)
+- [File Activity](#file-activity)
+- [System Trace](#system-trace)
+- [xctrace](#xctrace)
+- [Custom Intervals with Signposts](#custom-intervals-with-signposts)
+- [Automation and CI](#automation-and-ci)
+<!-- /toc -->
+
 Companion to the `debugging-instruments` skill: what each template is for, how
 to read it, and how to drive recordings from scripts.
 

package/pipeline/skills/shared/external/debugging-instruments/references/lldb-patterns.md

@@ -1,5 +1,19 @@
 # LLDB Command Reference
 
+<!-- toc -->
+- [Printing Values: `v`, `p`, `po`](#printing-values-v-p-po)
+- [Registers and Raw Memory](#registers-and-raw-memory)
+- [Breakpoint Recipes](#breakpoint-recipes)
+- [Expressions](#expressions)
+- [Watchpoints](#watchpoints)
+- [Moving Through Threads and Frames](#moving-through-threads-and-frames)
+- [Memory Inspection](#memory-inspection)
+- [Type Summaries](#type-summaries)
+- [Python Scripting](#python-scripting)
+- [Symbolic Breakpoints Worth Keeping](#symbolic-breakpoints-worth-keeping)
+- [`.lldbinit`](#lldbinit)
+<!-- /toc -->
+
 Companion to the `debugging-instruments` skill. Commands are typed at the
 `(lldb)` prompt in Xcode's console or in a standalone `lldb` session.
 

package/pipeline/skills/shared/external/device-integrity/references/device-integrity-patterns.md

@@ -1,5 +1,18 @@
 # Device Integrity Patterns
 
+<!-- toc -->
+- [Verifying an attestation on the server](#verifying-an-attestation-on-the-server)
+- [Verifying an assertion on the server](#verifying-an-assertion-on-the-server)
+- [Server architecture](#server-architecture)
+- [Handling `DCError`](#handling-dcerror)
+- [Retry strategy](#retry-strategy)
+- [Rejected keys](#rejected-keys)
+- [Integration outline](#integration-outline)
+- [Gradual rollout](#gradual-rollout)
+- [Environment entitlement](#environment-entitlement)
+- [Apple documentation](#apple-documentation)
+<!-- /toc -->
+
 Server verification, backend layout, error recovery and rollout for DeviceCheck
 and App Attest. The client basics are in the [skill overview](../SKILL.md).
 

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

@@ -1,5 +1,15 @@
 # EnergyKit Patterns
 
+<!-- toc -->
+- [Observable guidance manager](#observable-guidance-manager)
+- [EV charging sessions](#ev-charging-sessions)
+- [HVAC stages](#hvac-stages)
+- [Dashboard view](#dashboard-view)
+- [Preparing insight charts](#preparing-insight-charts)
+- [Retrying](#retrying)
+- [Venue picker](#venue-picker)
+<!-- /toc -->
+
 Larger building blocks for an EnergyKit app. Basics live in the
 [skill overview](../SKILL.md). The API is new in iOS 26; confirm names against
 current documentation. The code assumes a 26.1 deployment target, because venue

package/pipeline/skills/shared/external/eventkit-calendar/references/eventkit-patterns.md

@@ -1,5 +1,15 @@
 # EventKit Patterns
 
+<!-- toc -->
+- [A SwiftUI week view](#a-swiftui-week-view)
+- [Queries](#queries)
+- [Batches](#batches)
+- [Managing calendars](#managing-calendars)
+- [Reminder recipes](#reminder-recipes)
+- [The event editor in SwiftUI](#the-event-editor-in-swiftui)
+- [Change notifications, old and new](#change-notifications-old-and-new)
+<!-- /toc -->
+
 Extended recipes for the `eventkit-calendar` skill.
 
 ## A SwiftUI week view

package/pipeline/skills/shared/external/fastapi-pro/references/app-structure.md

@@ -1,5 +1,15 @@
 # FastAPI app structure
 
+<!-- toc -->
+- [Contents](#contents)
+- [Settings](#settings)
+- [App factory and lifespan](#app-factory-and-lifespan)
+- [Database session per request](#database-session-per-request)
+- [Schemas: separate in from out](#schemas-separate-in-from-out)
+- [Dependencies](#dependencies)
+- [Errors](#errors)
+<!-- /toc -->
+
 Worked code for the settings, app factory, per-request session, schemas, dependencies and error handlers summarised in SKILL.md.
 
 ## Contents

package/pipeline/skills/shared/external/gradle-kotlin-dsl/references/patterns.md

@@ -1,5 +1,22 @@
 # Gradle Kotlin DSL Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Version Catalog](#version-catalog)
+- [Convention Plugins](#convention-plugins)
+- [App Module Configuration](#app-module-configuration)
+- [Library Module Configuration](#library-module-configuration)
+- [Compose Configuration](#compose-configuration)
+- [Build Variants and Flavors](#build-variants-and-flavors)
+- [Signing Config](#signing-config)
+- [R8 and ProGuard](#r8-and-proguard)
+- [Build Performance](#build-performance)
+- [Typed BuildConfig Injection](#typed-buildconfig-injection)
+- [Typed Module Paths and Flavors](#typed-module-paths-and-flavors)
+- [Convention Plugin Composition](#convention-plugin-composition)
+- [Fast-Feedback Tasks](#fast-feedback-tasks)
+<!-- /toc -->
+
 Full code examples backing the guidance in `SKILL.md`. Headings mirror the
 SKILL.md sections.
 

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

@@ -1,5 +1,17 @@
 # HealthKit patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Workout sessions in depth](#workout-sessions-in-depth)
+- [Platform and authorization edge cases](#platform-and-authorization-edge-cases)
+- [Background delivery in detail](#background-delivery-in-detail)
+- [Anchored object queries](#anchored-object-queries)
+- [Predicates](#predicates)
+- [Chart data](#chart-data)
+- [SwiftUI integration](#swiftui-integration)
+- [Characteristics](#characteristics)
+<!-- /toc -->
+
 Extended examples that go with the main skill. Swift 6.3, iOS 26 unless noted.
 
 ## Contents

package/pipeline/skills/shared/external/hig-app-icons/references/icon-workflow.md

@@ -1,5 +1,15 @@
 # Icon workflow
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Preparing artwork](#1-preparing-artwork)
+- [2. Building the icon in Icon Composer](#2-building-the-icon-in-icon-composer)
+- [3. Adding it to Xcode](#3-adding-it-to-xcode)
+- [4. The asset catalog route](#4-the-asset-catalog-route)
+- [5. Alternate icons end to end](#5-alternate-icons-end-to-end)
+- [6. Review checklist](#6-review-checklist)
+<!-- /toc -->
+
 Steps for building, wiring and checking an iOS app icon, with the asset
 catalog route for projects that cannot move to Icon Composer yet.
 

package/pipeline/skills/shared/external/hig-components-content/references/content-views.md

@@ -1,5 +1,15 @@
 # Content views in detail
 
+<!-- toc -->
+- [Lists and tables](#lists-and-tables)
+- [Collections and grids](#collections-and-grids)
+- [Charts](#charts)
+- [Images and media](#images-and-media)
+- [Text](#text)
+- [Web content](#web-content)
+- [Sharing](#sharing)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `hig-components-content` skill.
 
 ## Lists and tables

package/pipeline/skills/shared/external/hig-components-layout/references/bars-and-tabs.md

@@ -1,5 +1,16 @@
 # Bars, tabs and toolbars on iOS 26 and 27
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Content layer and navigation layer](#1-content-layer-and-navigation-layer)
+- [2. Tab bars](#2-tab-bars)
+- [3. Search in a tab bar or toolbar](#3-search-in-a-tab-bar-or-toolbar)
+- [4. Toolbars and navigation bars](#4-toolbars-and-navigation-bars)
+- [5. Overflow, priority and pinning (iOS 27)](#5-overflow-priority-and-pinning-ios-27)
+- [6. Minimizing bars on scroll](#6-minimizing-bars-on-scroll)
+- [7. Review checklist](#7-review-checklist)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `hig-components-layout` skill. Each API
 carries the iOS release it first shipped in; gate anything newer than the
 deployment target with `#available`. The glass material itself (variants,

package/pipeline/skills/shared/external/hig-foundations/references/foundations-detail.md

@@ -1,5 +1,18 @@
 # Foundations in detail
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Typography](#1-typography)
+- [2. Color](#2-color)
+- [3. Layout, margins and safe areas](#3-layout-margins-and-safe-areas)
+- [4. Icons and SF Symbols](#4-icons-and-sf-symbols)
+- [5. Materials, Liquid Glass and depth](#5-materials-liquid-glass-and-depth)
+- [6. Motion](#6-motion)
+- [7. App icon](#7-app-icon)
+- [8. Writing](#8-writing)
+- [9. Accessibility, as a foundation](#9-accessibility-as-a-foundation)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `hig-foundations` skill.
 
 ## Contents

package/pipeline/skills/shared/external/hig-foundations/references/type-color-spacing.md

@@ -1,5 +1,18 @@
 # Typography, color and spacing: numbers and code
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Text sizes and weights](#1-text-sizes-and-weights)
+- [2. iOS text styles at the default size](#2-ios-text-styles-at-the-default-size)
+- [3. Custom fonts that still scale](#3-custom-fonts-that-still-scale)
+- [4. Adapting layout at large sizes](#4-adapting-layout-at-large-sizes)
+- [5. Color roles](#5-color-roles)
+- [6. Contrast minimums](#6-contrast-minimums)
+- [7. Color on Liquid Glass](#7-color-on-liquid-glass)
+- [8. Spacing and margins](#8-spacing-and-margins)
+- [9. Touch targets](#9-touch-targets)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `hig-foundations` skill. The numbers below
 come from Apple's Human Interface Guidelines (Typography, Accessibility,
 Color, Layout); the spacing scale is a design convention, marked as such.

package/pipeline/skills/shared/external/hig-patterns/references/onboarding-and-states.md

@@ -1,5 +1,16 @@
 # Onboarding, permission requests, empty and error states
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Onboarding](#1-onboarding)
+- [2. Teaching in context with TipKit](#2-teaching-in-context-with-tipkit)
+- [3. Asking for permission](#3-asking-for-permission)
+- [4. Pre-permission screens](#4-pre-permission-screens)
+- [5. Empty states](#5-empty-states)
+- [6. Error states](#6-error-states)
+- [7. Loading before the empty state](#7-loading-before-the-empty-state)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `hig-patterns` skill. Guidance follows
 Apple's HIG pages on onboarding, launching, privacy and loading; the SwiftUI
 code is ours.

package/pipeline/skills/shared/external/hig-platforms/references/ipad-layout.md

@@ -1,5 +1,17 @@
 # iPad layout and windowing
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Windows on iPadOS 26](#1-windows-on-ipados-26)
+- [2. Size classes, not devices](#2-size-classes-not-devices)
+- [3. Choosing a layout tool](#3-choosing-a-layout-tool)
+- [4. ViewThatFits](#4-viewthatfits)
+- [5. AnyLayout](#5-anylayout)
+- [6. A custom Layout](#6-a-custom-layout)
+- [7. Scenes, multiple windows and the menu bar](#7-scenes-multiple-windows-and-the-menu-bar)
+- [8. Test matrix](#8-test-matrix)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `hig-platforms` skill: how one SwiftUI
 layout adapts from a narrow iPad window to a full external display. Hinged
 iPhone hardware (iPhone Duo) has its own skill, `ios-iphone-duo`.

package/pipeline/skills/shared/external/hig-technologies/references/technologies.md

@@ -1,5 +1,21 @@
 # Apple technologies in detail
 
+<!-- toc -->
+- [Identity: Sign in with Apple and passkeys](#identity-sign-in-with-apple-and-passkeys)
+- [Payments: Apple Pay and in-app purchase](#payments-apple-pay-and-in-app-purchase)
+- [Wallet](#wallet)
+- [Siri, Shortcuts, Spotlight and App Intents](#siri-shortcuts-spotlight-and-app-intents)
+- [Widgets, controls and Live Activities](#widgets-controls-and-live-activities)
+- [Health and fitness](#health-and-fitness)
+- [Home](#home)
+- [iCloud](#icloud)
+- [Maps and location](#maps-and-location)
+- [SharePlay](#shareplay)
+- [CarPlay](#carplay)
+- [Augmented reality](#augmented-reality)
+- [Apple Intelligence and generative features](#apple-intelligence-and-generative-features)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `hig-technologies` skill.
 
 ## Identity: Sign in with Apple and passkeys

package/pipeline/skills/shared/external/homekit-matter/references/matter-commissioning.md

@@ -1,5 +1,14 @@
 # Matter commissioning and HomeKit UI recipes
 
+<!-- toc -->
+- [Contents](#contents)
+- [SwiftUI integration](#swiftui-integration)
+- [Delegate wiring](#delegate-wiring)
+- [Finding services by type](#finding-services-by-type)
+- [A fuller MatterSupport handler](#a-fuller-mattersupport-handler)
+- [Simulated accessories for testing](#simulated-accessories-for-testing)
+<!-- /toc -->
+
 Extended material for the `homekit-matter` skill ([../SKILL.md](../SKILL.md)):
 a SwiftUI store, accessory screens, complete delegate wiring, service and
 characteristic tables, a fuller MatterSupport handler, and simulator testing.

package/pipeline/skills/shared/external/ios-accessibility/references/a11y-patterns.md

@@ -1,5 +1,23 @@
 # Accessibility Code Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Labels, values, hints](#labels-values-hints)
+- [Traits and grouping](#traits-and-grouping)
+- [Custom and adjustable controls](#custom-and-adjustable-controls)
+- [Focus patterns](#focus-patterns)
+- [Dynamic Type and layout](#dynamic-type-and-layout)
+- [Custom rotors](#custom-rotors)
+- [System preference values](#system-preference-values)
+- [UIKit](#uikit)
+- [AppKit](#appkit)
+- [Mistakes to catch in review](#mistakes-to-catch-in-review)
+- [Voice Control](#voice-control)
+- [Switch Control](#switch-control)
+- [Full Keyboard Access](#full-keyboard-access)
+- [Automated checks with XCTest](#automated-checks-with-xctest)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 ## Contents

package/pipeline/skills/shared/external/ios-accessibility/references/large-content-and-appearance.md

@@ -1,5 +1,14 @@
 # Large Content Viewer, and Liquid Glass with appearance settings
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Large Content Viewer](#1-large-content-viewer)
+- [2. SwiftUI](#2-swiftui)
+- [3. UIKit](#3-uikit)
+- [4. Liquid Glass and appearance settings](#4-liquid-glass-and-appearance-settings)
+- [5. Checks](#5-checks)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `ios-accessibility` skill.
 
 ## Contents

package/pipeline/skills/shared/external/ios-accessibility/references/media-accessibility.md

@@ -1,5 +1,14 @@
 # Media Accessibility
 
+<!-- toc -->
+- [Captions, SDH and subtitles](#captions-sdh-and-subtitles)
+- [Picking an accessible caption track](#picking-an-accessible-caption-track)
+- [Picking an audio description track](#picking-an-audio-description-track)
+- [Following the system settings](#following-the-system-settings)
+- [SwiftUI `VideoPlayer`](#swiftui-videoplayer)
+- [Custom player controls](#custom-player-controls)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 How to make audio and video accessible with AVFoundation: tagging and choosing

package/pipeline/skills/shared/external/ios-accessibility/references/nutrition-labels.md

@@ -1,5 +1,12 @@
 # App Store Accessibility Nutrition Labels
 
+<!-- toc -->
+- [The nine categories](#the-nine-categories)
+- [Rules for claiming a label](#rules-for-claiming-a-label)
+- [What passes and what fails](#what-passes-and-what-fails)
+- [Auditing a SwiftUI screen](#auditing-a-swiftui-screen)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 App Store Connect lets a developer state which accessibility features an app

package/pipeline/skills/shared/external/ios-coding-standard/references/STANDARD.md

@@ -1,5 +1,18 @@
 # iOS Coding Standard
 
+<!-- toc -->
+- [Contents](#contents)
+- [0. The ten lines](#0-the-ten-lines)
+- [1. Security](#1-security)
+- [2. Testability](#2-testability)
+- [3. Readability](#3-readability)
+- [4. Flexibility](#4-flexibility)
+- [5. Concurrency](#5-concurrency)
+- [6. Accessibility](#6-accessibility)
+- [7. Performance  -  the four that are also readability](#7-performance---the-four-that-are-also-readability)
+- [8. Exceptions](#8-exceptions)
+<!-- /toc -->
+
 The one document to read before your first PR. Rule IDs in brackets point at `rules.yml`, which
 carries severity, tooling and rationale for each; `EXAMPLES.md` carries a worked ✗/✓ pair for
 every rule a tool cannot decide  -  look one up by ID when a review cites it. Your module's own docs

package/pipeline/skills/shared/external/ios-design-review/references/appearance-matrix.md

@@ -1,5 +1,14 @@
 # Appearance matrix and simulator procedure
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Setting each appearance](#1-setting-each-appearance)
+- [2. What breaks in each appearance](#2-what-breaks-in-each-appearance)
+- [3. Sweep procedure](#3-sweep-procedure)
+- [4. Example batch](#4-example-batch)
+- [5. Limits of a simulator review](#5-limits-of-a-simulator-review)
+<!-- /toc -->
+
 How to put a simulator into each appearance, what to look for in it, and a
 toolkit procedure that sweeps the matrix for one screen. Tool names are from
 the multi-agent-toolkit MCP server (3.19.0 or later).

package/pipeline/skills/shared/external/ios-design-review/references/checklist.md

@@ -1,5 +1,20 @@
 # Design review checklist
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Layout and safe areas](#1-layout-and-safe-areas)
+- [2. Typography](#2-typography)
+- [3. Colour and contrast](#3-colour-and-contrast)
+- [4. Materials and Liquid Glass](#4-materials-and-liquid-glass)
+- [5. Iconography](#5-iconography)
+- [6. Navigation and bars](#6-navigation-and-bars)
+- [7. Controls and touch targets](#7-controls-and-touch-targets)
+- [8. Feedback and motion](#8-feedback-and-motion)
+- [9. States](#9-states)
+- [10. Content, copy and localization](#10-content-copy-and-localization)
+- [11. Report template](#11-report-template)
+<!-- /toc -->
+
 Questions per layer, with the threshold or HIG page behind each. Ask them of
 the rendered screen; when a question can only be answered from code or a
 device, note that under Not proven instead of guessing.

package/pipeline/skills/shared/external/ios-haptics/references/core-haptics.md

@@ -1,5 +1,16 @@
 # Core Haptics
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Engine lifecycle](#1-engine-lifecycle)
+- [2. Events and parameters](#2-events-and-parameters)
+- [3. Playing a pattern](#3-playing-a-pattern)
+- [4. Parameter curves and dynamic parameters](#4-parameter-curves-and-dynamic-parameters)
+- [5. Advanced players](#5-advanced-players)
+- [6. AHAP files](#6-ahap-files)
+- [7. Pitfalls](#7-pitfalls)
+<!-- /toc -->
+
 For patterns the feedback generators cannot express: shaped intensity and
 sharpness, several events in sequence, haptics synchronised with audio, or a
 pattern that changes while it plays (a drag that strengthens with distance).

package/pipeline/skills/shared/external/ios-iphone-duo/references/api-map.md

@@ -1,5 +1,16 @@
 # iPhone Duo API map
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Size, screen and shape](#1-size-screen-and-shape)
+- [2. Reserved regions](#2-reserved-regions)
+- [3. Arrangements](#3-arrangements)
+- [4. Vertical bars](#4-vertical-bars)
+- [5. Sheets](#5-sheets)
+- [6. Hinge](#6-hinge)
+- [7. Scenes and accessories](#7-scenes-and-accessories)
+<!-- /toc -->
+
 Every API this skill relies on, grouped by job, with the iOS version that
 introduced it. *(27.1 beta)* marks symbols documented as beta in the iOS 27.1
 SDK; their names and behaviour may change before release.

package/pipeline/skills/shared/external/ios-iphone-duo/references/fixed-assumptions.md

@@ -1,5 +1,20 @@
 # Fixed assumptions: grep list and replacements
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. The search](#1-the-search)
+- [2. Orientation](#2-orientation)
+- [3. The screen](#3-the-screen)
+- [4. Cached sizes](#4-cached-sizes)
+- [5. Idiom and size class](#5-idiom-and-size-class)
+- [6. Device sizes and thresholds](#6-device-sizes-and-thresholds)
+- [7. Insets](#7-insets)
+- [8. Bars](#8-bars)
+- [9. Media](#9-media)
+- [10. Life cycle, legacy guides and the keyboard](#10-life-cycle-legacy-guides-and-the-keyboard)
+- [11. Recording the result](#11-recording-the-result)
+<!-- /toc -->
+
 Run these from the repository root. Every hit is a candidate, not a verdict:
 read the surrounding code, decide whether it affects layout, and confirm on
 the iPhone Duo simulator. Exclude vendored and generated code from the count.