axiom-ownership-conventions

#### Latest

• Apple Documentation Access — Direct access to 20 official Apple guides + 32 Swift compiler diagnostics bundled in Xcode, read at runtime via MCP server

#### WWDC 2025 Updates

• SwiftUI 26 Features — Comprehensive guide to iOS 26 SwiftUI: Liquid Glass, WebView, AttributedString rich text, @Animatable macro, 3D charts, scene bridging, and more
• SwiftUI Performance Enhancements — iOS 26 framework improvements: 6x/16x faster lists, improved scrolling, nested ScrollView optimization
• Liquid Glass APIs — New iOS 26 APIs: .glassBackgroundEffect(), toolbar spacers, bottom-aligned search, search tab role
• App Intents Integration — Siri, Apple Intelligence, Shortcuts, Spotlight integration with WWDC 2025-260 guidance

#### Recent Skills

• Energy Optimization — Power Profiler workflows, subsystem diagnosis (CPU/GPU/Network/Location/Display), anti-pattern fixes for battery drain
• Accessibility Audit & Debugging — Comprehensive WCAG compliance scanning, VoiceOver testing, Dynamic Type support, color contrast validation
• Realm to SwiftData Migration — Migrate before Device Sync sunset (Sept 30, 2025) without losing user data or breaking threading patterns
• SwiftUI Debugging — Solve intermittent view updates and preview crashes with diagnostic decision trees

• plugins/ - Claude Code plugins for iOS development workflows
• docs/ - VitePress documentation site
• scratch/ - Local development files (not tracked in git)
• notes/ - Personal notes (not tracked in git)

Prerequisites

• macOS 15+ (Sequoia or later)
• Claude Code ([download here](https://claude.ai/download))
• Xcode 26+ (for Liquid Glass, Recording UI Automation, and latest iOS features)
• iOS 26 SDK (comes with Xcode 26)

Installation

In Claude Code, run:

```

/plugin marketplace add CharlesWiltgen/Axiom

```

Then search for "axiom" in the /plugin menu and install.

Verify Installation

Use /plugin and select "Manage and install" to see installed plugins. Axiom should be listed.

Using Skills

Skills are automatically suggested by Claude Code based on your questions and context. Simply ask questions that match the skill's purpose:

#### Examples

• "I'm getting BUILD FAILED in Xcode" → activates axiom-xcode-debugging
• "How do I fix Swift 6 concurrency errors?" → activates axiom-swift-concurrency
• "I need to add a database column safely" → activates axiom-database-migration
• "My app has memory leaks" → activates axiom-memory-debugging
• "My app drains battery quickly" → activates axiom-energy
• "Help me migrate from Realm to SwiftData" → activates realm-to-swiftdata-migration

UI & Design

#### axiom-liquid-glass

Apple's new material design system for iOS 26+. Comprehensive coverage of Liquid Glass visual properties, implementation patterns, and design principles.

#### Key Features

• Expert Review Checklist — 7-section validation checklist for reviewing Liquid Glass implementations (material appropriateness, variant selection, legibility, layering, accessibility, performance)
• Regular vs Clear variant decision criteria
• Layered system architecture (highlights, shadows, glow, tinting)
• Troubleshooting visual artifacts, dark mode issues, performance
• Migration from UIBlurEffect/NSVisualEffectView
• Complete API reference with code examples

When to use Implementing Liquid Glass effects, reviewing UI for adoption, debugging visual artifacts, requesting expert review of implementations

Requirements iOS 26+, Xcode 26+

Command /audit-liquid-glass for quick automated codebase scanning

---

#### axiom-swiftui-performance

Master SwiftUI performance optimization using the new SwiftUI Instrument in Instruments 26.

#### Key Features

• New SwiftUI Instrument walkthrough (4 track lanes, color-coding, integration with Time Profiler)
• Cause & Effect Graph — Visualize data flow and dependencies to eliminate unnecessary updates
• Problem 1: Long View Body Updates (formatter caching, expensive operations)
• Problem 2: Unnecessary View Updates (granular dependencies, AttributeGraph)
• Performance optimization checklist
• Real-world impact examples from WWDC's Landmarks app

When to use App feels less responsive, animations stutter, scrolling performance issues, profiling reveals SwiftUI bottlenecks

Requirements Xcode 26+, iOS 26+ SDK

---

#### axiom-swiftui-26-ref

Comprehensive reference guide to all iOS 26 SwiftUI features from WWDC 2025-256.

#### Key Features

• Liquid Glass Design System — Toolbar spacers, tinted prominent buttons, glass effect for custom views, bottom-aligned search, search tab role
• Performance Improvements — 6x/16x faster lists (macOS), improved scrolling, nested ScrollView optimization
• @Animatable Macro — Automatic animatableData synthesis with @AnimatableIgnored
• WebView & WebPage — Native web content, observable model for rich interaction
• TextEditor with AttributedString — Rich text editing with built-in formatting controls
• Drag and Drop Enhancements — Multi-item dragging, DragConfiguration, preview formations
• 3D Charts — Chart3D for three-dimensional plotting
• 3D Spatial Layout — Alignment3D, .spatialOverlay, .manipulable (visionOS)
• Scene Bridging — UIKit/AppKit → SwiftUI scenes, RemoteImmersiveSpace
• Widgets & Controls — visionOS widgets, CarPlay widgets, macOS/watchOS controls

When to use Implementing iOS 26 SwiftUI features, adopting Liquid Glass design, embedding web content, rich text editing, 3D charts/layouts

Requirements iOS 26+, iPadOS 26+, macOS Tahoe+, watchOS 26+, visionOS 26+

---

#### axiom-ui-testing

Reliable UI testing with condition-based waiting patterns and new Recording UI Automation features from Xcode 26.

#### Key Features

• Recording UI Automation — Record interactions as Swift code, replay across devices/languages/configurations, review video recordings
• Three phases: Record → Replay → Review
• Condition-based waiting (eliminates flaky tests from sleep() timeouts)
• Accessibility-first testing patterns
• SwiftUI and UIKit testing strategies
• Test plans and configurations

When to use Writing UI tests, recording interactions, tests have race conditions or timing dependencies, flaky tests

Requirements Xcode 26+ for Recording UI Automation, original patterns work with earlier versions

---

#### axiom-swiftui-debugging

Diagnostic decision trees for SwiftUI view updates, preview crashes, and layout issues. Includes 3 real-world examples.

#### Key Features

• View Not Updating Decision Tree — Diagnose struct mutation, binding identity, view recreation, missing observers
• Preview Crashes Decision Tree — Identify missing dependencies, state init failures, cache corruption
• Layout Issues Quick Reference — ZStack ordering, GeometryReader sizing, SafeArea, frame/fixedSize
• Real-World Examples — List items, preview dependencies, text field bindings with complete diagnosis workflows
• Pressure scenarios for intermittent bugs, App Store Review deadlines, authority pressure resistance

When to use View doesn't update, preview crashes, layout looks wrong, intermittent rendering issues

Requirements Xcode 15+, iOS 14+

---

#### axiom-performance-profiling

Instruments decision trees and profiling workflows for CPU, memory, and battery optimization. Includes 3 real-world examples.

#### Key Features

• Performance Decision Tree — Choose the right tool (Time Profiler, Allocations, Core Data, Energy Impact)
• Time Profiler Deep Dive — CPU analysis, hot spots, Self Time vs Total Time distinction
• Allocations Deep Dive — Memory growth diagnos