Axiom Integration

iOS System Integration

You MUST use this skill for ANY iOS system integration including Siri, Shortcuts, widgets, in-app purchases, background tasks, push notifications, and more.

Quick Reference

Decision Tree

digraph integration {
    start [label="Integration task" shape=ellipse];
    what [label="Which system feature?" shape=diamond];

    start -> what;
    what -> "skills/app-intents-ref.md" [label="Siri / App Intents"];
    what -> "skills/app-shortcuts-ref.md" [label="Shortcuts / phrases"];
    what -> "skills/app-discoverability.md" [label="discoverability\nstrategy"];
    what -> "skills/extensions-widgets.md" [label="widgets / Live Activities\n/ Control Center"];
    what -> "skills/in-app-purchases.md" [label="IAP / subscriptions"];
    what -> "skills/eventkit.md" [label="calendar / reminders"];
    what -> "skills/contacts.md" [label="contacts"];
    what -> "skills/localization.md" [label="localization"];
    what -> "skills/privacy-ux.md" [label="privacy / permissions"];
    what -> "skills/alarmkit-ref.md" [label="alarms (iOS 26+)"];
    what -> "skills/timer-patterns.md" [label="timers"];
    what -> "skills/background-processing.md" [label="background tasks"];
    what -> "skills/push-notifications.md" [label="push notifications"];
}

1. Siri / App Intents / entity queries? → skills/app-intents-ref.md
2. App Shortcuts / phrases? → skills/app-shortcuts-ref.md
3. App discoverability / Spotlight strategy? → skills/app-discoverability.md, skills/core-spotlight-ref.md
4. Widgets / Live Activities / Control Center? → skills/extensions-widgets.md, skills/extensions-widgets-ref.md
5. In-app purchases / StoreKit? → skills/in-app-purchases.md, skills/storekit-ref.md
6. Calendar / reminders / EventKit? → skills/eventkit.md, skills/eventkit-ref.md
7. Contacts / contact picker? → skills/contacts.md, skills/contacts-ref.md
8. Localization mechanics (String Catalogs, plurals, RTL)? → skills/localization.md 8a. Localization research (Apple terminology, glossary, pseudolocalization, TMS)? → skills/localization-research-ref.md
9. Privacy / permissions? → skills/privacy-ux.md
10. Alarms (iOS 26+)? → skills/alarmkit-ref.md
11. Timers? → skills/timer-patterns.md, skills/timer-patterns-ref.md
12. Background tasks / BGTaskScheduler? → skills/background-processing.md, skills/background-processing-diag.md, skills/background-processing-ref.md
13. Push notifications? → skills/push-notifications.md, skills/push-notifications-diag.md, skills/push-notifications-ref.md
14. Want IAP audit? → Launch iap-auditor agent
15. Want full IAP implementation? → Launch iap-implementation agent
16. Camera / photos / audio / haptics / ShazamKit? → Use axiom-media instead

Cross-Domain Routing

Widget + data sync (widget not showing updated data):

• Widget timeline not refreshing → stay here (extensions-widgets)
• SwiftData/Core Data not shared with extension → also invoke axiom-data (App Groups)

Live Activity + push notification:

• ActivityKit push token setup → stay here (extensions-widgets)
• Push delivery failures → also invoke axiom-networking (networking-diag)
• Entitlements/certificates → also invoke axiom-build

Push + background processing (silent push not triggering background work):

• Push payload and delivery → stay here (push-notifications-diag)
• BGTaskScheduler execution → stay here (background-processing)

Calendar/Contacts + data sync:

• EventKit/Contacts data issues → stay here
• Shared data with widget via App Groups → also invoke axiom-data

watchOS surfaces

• Complications + Smart Stack widgets → See axiom-watchos (skills/smart-stack-and-complications.md)
• Live Activities on Apple Watch → See axiom-watchos (skills/controls-and-live-activities.md)

Conflict Resolution

integration vs axiom-build: When system features fail with entitlement/certificate errors:

• Use axiom-build for signing and provisioning issues
• Use integration for API usage and permission patterns

integration vs axiom-data: When widgets or extensions can't access shared data:

• App Groups and shared containers → axiom-data
• Widget timeline, Live Activity updates → integration

integration vs axiom-media: When media features overlap with system features:

• Camera/photo/audio/haptics code → axiom-media
• Privacy manifests for camera/microphone → stay here (privacy-ux)
• Background audio mode → stay here (background-processing)

Anti-Rationalization

Example Invocations

User: "How do I add Siri support?" → Read: skills/app-intents-ref.md

User: "My widget isn't updating" → Read: skills/extensions-widgets.md

User: "Implement in-app purchases with StoreKit 2" → Read: skills/in-app-purchases.md

User: "How do I implement push notifications?" → Read: skills/push-notifications.md

User: "Push notifications work in dev but not production" → Read: skills/push-notifications-diag.md

User: "My background task never runs" → Read: skills/background-processing-diag.md

User: "How do I add an event to the user's calendar?" → Read: skills/eventkit.md

User: "How do I let users pick a contact?" → Read: skills/contacts.md

User: "Review my in-app purchase implementation" → Launch: iap-auditor agent