/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 with Claude Code's native **`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

The session-start hook resolves Xcode's location and echoes the literal base directories into session context (look for "Apple for-LLM Documentation: Xcode detected at `<path>`"). Use the **`Read`** tool with `<that base>/<filename>`.

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

Xcode-beta users: the session-start hook respects `AXIOM_XCODE_PATH` and reports the resolved path in session context — use that path, not the default above.

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

46 files in the diagnostics directory. 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 version | `error-in-future-swift-version.md` | | Strict language features | `strict-language-features.md` | | Strict memory safety | `strict-memory-safety.md` | | Implementation only deprecated | `implementation-only-deprecated.md` | | Member import visibility | `member-import-visibility.md` | | Missing module on known paths | `missing-module-on-known-paths.md` | | Module not testable | `module-not-testable.md` | | Module version missing | `module-version-missing.md` | | Clang declaration import | `clang-declaration-import.md` | | Availability unrecognized name |