/axiom-apple-docs

name: axiom-apple-docs
description: Use when you need Apple's own documentation or a Swift compiler diagnostic explained rather than recalled.
license: MIT

Apple Documentation Router

Apple bundles for-LLM markdown documentation inside Xcode. These are authoritative, up-to-date guides and diagnostics written by Apple engineers. Read them directly as files (in Claude Code, with the **`Read`** tool) — no MCP server or special tool required.

When to Use

• You need the exact API signature or behavior from Apple
• An Axiom skill references an Apple framework and you want the official source
• A Swift compiler diagnostic needs explanation
• The user asks about a specific Apple framework feature

**Priority**: Axiom skills provide opinionated guidance (decision trees, anti-patterns, pressure scenarios). Apple docs provide authoritative API details. Use both together.

How to Read These Docs

Axiom's session context names the Xcode the user has switched to. In Claude Code it lists the literal base directories ("Apple for-LLM Documentation: Xcode detected at `<path>`"); other harnesses name the app ("Installed on this machine: Xcode … (`<path>`)") — substitute that `.app` for `/Applications/Xcode.app` in the table below. Read `<base>/<filename>` as a file (the **`Read`** tool in Claude Code).

Default Xcode location (`/Applications/Xcode.app`) base directories:

| Content | Base directory | |---|---| | AdditionalDocumentation guides | `/Applications/Xcode.app/Contents/PlugIns/IDEIntelligenceChat.framework/Versions/A/Resources/AdditionalDocumentation/` | | Swift compiler diagnostics | `/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/share/doc/swift/diagnostics/` |

Example invocation Claude should produce:

Read /Applications/Xcode.app/Contents/PlugIns/IDEIntelligenceChat.framework/Versions/A/Resources/AdditionalDocumentation/SwiftUI-Implementing-Liquid-Glass-Design.md

These paths assume the default install; use the path from session context instead. Without session context: use `AXIOM_XCODE_PATH` if it is set; otherwise run `xcode-select -p` (it honors `DEVELOPER_DIR`), which prints `<Xcode>.app/Contents/Developer` — drop `/Contents/Developer` and put that `.app` in place of `/Applications/Xcode.app` above. If it prints `/Library/Developer/CommandLineTools`, no Xcode is selected; try `/Applications/Xcode.app`.

Guide Files (AdditionalDocumentation)

20 files. Read with the path pattern `{guides base}/{filename}`.

UI & Design

| Topic | Filename | |---|---| | Liquid Glass in SwiftUI | `SwiftUI-Implementing-Liquid-Glass-Design.md` | | Liquid Glass in UIKit | `UIKit-Implementing-Liquid-Glass-Design.md` | | Liquid Glass in AppKit | `AppKit-Implementing-Liquid-Glass-Design.md` | | Liquid Glass in WidgetKit | `WidgetKit-Implementing-Liquid-Glass-Design.md` | | SwiftUI new toolbar features | `SwiftUI-New-Toolbar-Features.md` | | SwiftUI styled text editing | `SwiftUI-Styled-Text-Editing.md` | | SwiftUI WebKit integration | `SwiftUI-WebKit-Integration.md` | | SwiftUI AlarmKit integration | `SwiftUI-AlarmKit-Integration.md` | | Swift Charts 3D visualization | `Swift-Charts-3D-Visualization.md` | | Foundation AttributedString updates | `Foundation-AttributedString-Updates.md` |

Data & Persistence

| Topic | Filename | |---|---| | SwiftData class inheritance | `SwiftData-Class-Inheritance.md` |

Concurrency & Performance

| Topic | Filename | |---|---| | Swift concurrency updates | `Swift-Concurrency-Updates.md` | | InlineArray and Span | `Swift-InlineArray-Span.md` |

Apple Intelligence

| Topic | Filename | |---|---| | Foundation Models (on-device LLM) | `FoundationModels-Using-on-device-LLM-in-your-app.md` |

System Integration

| Topic | Filename | |---|---| | App Intents updates | `AppIntents-Updates.md` | | StoreKit updates | `StoreKit-Updates.md` | | MapKit GeoToolbox PlaceDescriptors | `MapKit-GeoToolbox-PlaceDescriptors.md` | | Widgets for visionOS | `Widgets-for-visionOS.md` |

Accessibility

| Topic | Filename | |---|---| | Assistive Access in iOS | `Implementing-Assistive-Access-in-iOS.md` |

Computer Vision

| Topic | Filename | |---|---| | Visual Intelligence in iOS | `Implementing-Visual-Intelligence-in-iOS.md` |

Swift Compiler Diagnostics

The diagnostics directory ships more files than are listed here (the count varies by Xcode version); the most relevant are below. Read with the path pattern `{diagnostics base}/{filename}`.

Concurrency Diagnostics

| Diagnostic | Filename | |---|---| | Actor-isolated call from nonisolated context | `actor-isolated-call.md` | | Conformance isolation | `conformance-isolation.md` | | Isolated conformances | `isolated-conformances.md` | | Nonisolated nonsending by default | `nonisolated-nonsending-by-default.md` | | Sendable closure captures | `sendable-closure-captures.md` | | Sendable metatypes | `sendable-metatypes.md` | | Explicit Sendable annotations | `explicit-sendable-annotations.md` | | Sending closure risks data race | `sending-closure-risks-data-race.md` | | Sending risks data race | `sending-risks-data-race.md` | | Mutable global variable | `mutable-global-variable.md` | | Preconcurrency import | `preconcurrency-import.md` | | Dynamic exclusivity | `dynamic-exclusivity.md` | | Exclusivity violation | `exclusivity-violation.md` |

Type System Diagnostics

| Diagnostic | Filename | |---|---| | Existential any | `existential-any.md` | | Existential member access limitations | `existential-member-access-limitations.md` | | Nominal types | `nominal-types.md` | | Multiple inheritance | `multiple-inheritance.md` | | Protocol type non-conformance | `protocol-type-non-conformance.md` | | Opaque type inference | `opaque-type-inference.md` | | Foreign reference type | `foreign-reference-type.md` |

Build & Migration Diagnostics

| Diagnostic | Filename | |---|---| | Deprecated declaration | `deprecated-declaration.md` | | Error in future Swift vers