// Adopt iOS 26 / iPadOS 26 / macOS 26 SwiftUI APIs: Liquid Glass, modernized toolbars and tab bars, matched transitions, scroll position. Triggers: `glassEffect`, `buttonStyle(.glass)`, `ToolbarSpacer`, `matchedTransitionSource`, `tabBarMinimizeBehavior`.
Generate a high-level weekly status report for a Basecamp project. Reader is a lead or outsider, not someone in the project's daily work. Outputs a lean 4-section markdown report (TL;DR, What happened, Blockers & decisions needed, Gaps Basecamp can't see). Last 7 days only, retrospective. Requires the basecamp CLI installed and authenticated.
Use when an AI agent is itself performing a pull request review (not coaching a human, not fetching the PR). Covers agent-specific tactics: context budget, tool escalation triggers, Explore subagent dispatch (single sidecar and parallel fan-out), when to emit "I cannot review this responsibly", auto-memory integration, and agent failure modes (confabulation, tool-call theater, delegated certainty laundering, evidence laundering, patch sycophancy, premature fan-out). Complements reviewing-pull-requests (universal doctrine) and pr-review (operational PR fetch + per-layer comparison).
Use when about to review a pull request, leave comments on a diff, approve a merge, or self-review your own changes before sending them. Applies to any PR from a typo fix to a migration, and to both human reviewers and AI sub-agents.
Adopt AppRouter (github.com/dimillian/AppRouter) for type-safe SwiftUI navigation with sheets and deep linking. Use when starting an app's nav layer or replacing ad-hoc `NavigationStack` path management. SimpleRouter or tab Router.
Add Apple's on-device Foundation Models (Apple Intelligence) to a SwiftUI app: streaming, `@Generable` structured output, `Tool` protocol, availability checks. iOS / iPadOS / macOS / visionOS 26+. Triggers on `SystemLanguageModel`, `LanguageModelSession`, `@Generable`.
Migrate legacy SwiftUI code from ObservableObject + @Published + ViewModel patterns to @Observable + @Environment + view-state enums. Use when modernizing an iOS or macOS codebase, removing ViewModel layers, or replacing Combine with async/await.
glassEffect, buttonStyle(.glass), ToolbarSpacer, matchedTransitionSource, tabBarMinimizeBehavior.UI work on a project that already targets iOS 26+, or work to upgrade an existing iOS 17 / iOS 18 codebase to feel native on iOS 26. Pure logic and Model layers are out of scope.
Deployment target must be iOS 26 / iPadOS 26 / macOS 26, with Xcode 26+. None of these APIs are back-deployable; do not wrap them in if #available to ship on older OSes. Bump the Package.swift platforms tuple (and the Xcode project minimum deployment target) before touching call sites.
glassEffect(_:in:isEnabled:) for translucent shapes, GlassEffectContainer for sibling glass shapes that morph into each other, and buttonStyle(.glass) for primary CTAs and toolbar buttons. Replaces ad-hoc .background(.ultraThinMaterial) and .borderedProminent.ToolbarSpacer as first-class ToolbarContent (not Spacer() in a ToolbarItem), tabBarMinimizeBehavior(.onScrollDown) to collapse the tab bar on scroll, and the new Tab(value:role:content:label:) initializer with role: .search for a dedicated search tab.matchedTransitionSource(id:in:) on a source view paired with .navigationTransition(.zoom(sourceID:in:)) on the destination, plus contentTransition(.numericText) for animated counters.scrollPosition(id:) with an Identifiable binding, scrollTargetBehavior(.viewAligned) and .paging, and scrollEdgeEffectStyle(_:for:) for the new top and bottom edge effects.@Entry macro for environment values (replaces the EnvironmentKey boilerplate), symbolEffect(.bounce, value:) on SF Symbols, two-detent sheets with presentationDetents([.height(...), .large]) and presentationBackgroundInteraction(.enabled), and textInputFormattingControlVisibility(.hidden, for: .all) to suppress the new default formatting strip in TextEditor..glassEffect(in:) renders as a plain background, no translucency. Cause: deployment target is still iOS 17 or 18. Fix: bump Package.swift .iOS(.v26) and the Xcode project minimum before touching the call sites; none of these APIs are back-deployable.Namespace.ID instances (each declared its own @Namespace). Fix: declare the namespace once at the parent and propagate it via the navigation value, sheet payload, or destination enum.GlassEffectContainer and animate the parent state.contentTransition(.numericText) animation jitters, digits reflow. Cause: no .monospacedDigit() on the label. Fix: add .monospacedDigit() adjacent to the contentTransition modifier; drive with .animation(.smooth, value: count)..tabBarMinimizeBehavior is attached to a child view, not the TabView. Fix: attach the modifier directly to the TabView.Package.swift and the Xcode project. Verify the project still builds and the simulator launches..glassEffect(in:) to elevated surfaces (toolbars, floating search fields, action chips). Swap primary CTAs from .borderedProminent to .buttonStyle(.glass).ToolbarSpacer to break dense toolbars into visual groups (especially keyboard toolbars).matchedTransitionSource on list cells or thumbnails, and .navigationTransition(.zoom(sourceID:in:)) on the destination view that the cell pushes or presents..tabItem usages with the new Tab(value:role:content:label:) API. Add .tabBarMinimizeBehavior(.onScrollDown) to the TabView.backgroundExtensionEffect(): niche, only useful for content that should bleed under bars.@Animatable macro: only relevant if you write custom Animatable shapes; default SwiftUI animation already covers most cases.WebView / WebPage: only when you need a full web view embedded; do not adopt for one-off links.references/glass-and-toolbar.md: glass effects, GlassEffectContainer, toolbar and tab bar adoption.references/transitions-and-scroll.md: matched transitions, scroll position and edge effects, symbol effects, @Entry.