| name | ios-app-intents |
| description | Design, implement, and verify App Intents, App Entities, App Shortcuts, widgets, Siri, Spotlight, and Apple Intelligence surfaces with stable identity and safe execution. |
iOS App Intents
Workflow
- Start from a user-visible action that is useful outside the main app.
- Define parameters, entity identity, lookup/query behavior, confirmation rules, execution mode, cancellation, and result copy before code.
- Keep identifiers stable across launches and devices when the capability requires continuity.
- Gate destructive, sensitive, shared, or public changes with the appropriate confirmation and ownership checks.
- Keep intent execution deterministic and independent from foreground-only UI state.
- Localize titles, parameter summaries, errors, shortcut phrases, and result dialogs.
- Verify discovery and execution in each claimed surface, including foreground/background behavior and locked-device constraints.
Current API caution
Apple's June 2026 App Intents updates add new execution, cancellation, undo, ownership, indexing, and Apple Intelligence integration options. Consult the exact SDK documentation and availability before using them. Do not rename those additions as an iOS version without primary-source evidence.
Read references/contract.md for the intent contract and test matrix.
