Apple HIG: Technologies
Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.
Key Principles
General
Apple technologies extend app capabilities through system integration. Each technology has established user-facing patterns; deviating creates confusion and erodes trust.
Privacy and user control are paramount. Especially for health, payment, and identity technologies. Request only needed data, explain why, respect choices.
Siri and Voice
- Natural, predictable, recoverable. Clear conversational intent phrases that complete quickly and confirm results. Support App Shortcuts for proactive suggestions. Handle errors with clear fallbacks.
Payments and Commerce
- Transparent and frictionless. Standard Apple Pay button styles. Never ask for card details when Apple Pay is available. Clearly describe what the user is buying, the price, and whether it's one-time or subscription.
Health and Fitness
- Health data is deeply personal. Explain the health benefit before requesting access. CareKit tasks should be encouraging. ResearchKit consent flows must be thorough, readable, and respect autonomy.
Smart Home
- Simple and reliable. Immediate response when controlling devices. Clear device state. Graceful handling of connectivity issues.
Augmented Reality
- Genuine value, not gimmicks. Use AR when spatial context improves understanding. Guide setup (surface, lighting, space). Provide clear exit back to standard interaction.
Machine Learning and Generative AI
- Enhance without surprising. Smart suggestions, image recognition, text prediction. Clearly attribute AI-generated content. Controls to edit, regenerate, or dismiss. Let users correct mistakes.
Identity and Authentication
- Sign in with Apple as top option. Standard button styles. Respect email hiding preference. ID Verifier: guided flows, don't store sensitive data beyond what verification requires.
Cloud and Data
- Invisible and reliable sync. Data appears on all devices without manual intervention. Handle conflicts gracefully. Never lose data.
Shared Experiences
- Real-time participation. SharePlay: support multiple participants, show presence, handle latency. AirPlay: appropriate Now Playing metadata.
Automotive
- Driver safety first. Minimize interaction complexity, large touch targets, no distracting content. Only permitted app types: audio, messaging, EV charging, navigation, parking, quick food ordering.
Accessibility
- Baseline requirement. Every element has a meaningful VoiceOver label, trait, and action. Support Dynamic Type, Switch Control, and other assistive technologies. Test entirely with VoiceOver enabled.
Reference Index
| Reference |
Topic |
Key content |
| siri.md |
Siri |
Intents, shortcuts, voice interaction, App Shortcuts |
| apple-pay.md |
Apple Pay |
Payment buttons, checkout flow, security |
| tap-to-pay-on-iphone.md |
Tap to Pay |
Merchant flows, contactless payment |
| in-app-purchase.md |
In-app purchase |
Subscriptions, one-time purchases, transparency |
| healthkit.md |
HealthKit |
Health data access, privacy, permissions |
| carekit.md |
CareKit |
Care plans, tasks, health management |
| researchkit.md |
ResearchKit |
Studies, informed consent, data collection |
| homekit.md |
HomeKit |
Smart home control, device state, scenes |
| augmented-reality.md |
ARKit |
Spatial context, surface detection, setup |
| machine-learning.md |
Core ML |
Predictions, smart features, confidence handling |
| generative-ai.md |
Generative AI |
Attribution, editing, responsible AI, uncertainty |
| icloud.md |
iCloud |
CloudKit, cross-device sync, conflict resolution |
| sign-in-with-apple.md |
Sign in with Apple |
Authentication, privacy, button styles |
| id-verifier.md |
ID Verifier |
Identity verification, document scanning |
| shareplay.md |
SharePlay |
Shared experiences, participant presence |
| airplay.md |
AirPlay |
Media streaming, Now Playing, wireless display |
| carplay.md |
CarPlay |
Driver safety, permitted app types, large targets |
| game-center.md |
Game Center |
Achievements, leaderboards, multiplayer |
| voiceover.md |
VoiceOver |
Screen reader, labels, traits, accessibility |
| wallet.md |
Wallet |
Passes, tickets, loyalty cards |
| nfc.md |
NFC |
Tag reading, quick interactions, App Clips |
| maps.md |
Maps |
Location display, annotations, directions |
| mac-catalyst.md |
Mac Catalyst |
iPad to Mac, menu bar, keyboard, pointer |
| live-photos.md |
Live Photos |
Motion capture, playback, editing |
| imessage-apps-and-stickers.md |
iMessage apps |
Messages extension, stickers, compact UI |
| shazamkit.md |
ShazamKit |
Audio recognition, music identification |
| always-on.md |
Always-on display |
Dimmed state, power efficiency, reduced updates |
| photo-editing.md |
Photo editing |
System photo editor, filters, adjustments |
Output Format
- Implementation checklist -- step-by-step requirements per Apple's guidelines.
- Required vs optional features for approval.
- Privacy and permission requirements -- data access, usage descriptions.
- User-facing flow from permission prompt through task completion.
- Testing guidance -- key scenarios including edge cases.
Questions to Ask
- Which Apple technology?
- Core use case?
- Which platforms?
- API requirements and entitlements reviewed?
- What data or permissions needed?
Related Skills
- hig-inputs -- Input methods interacting with technologies (voice for Siri, Pencil for AR, gestures for Maps)
- hig-components-system -- Widgets, complications, Live Activities surfacing technology data
- hig-components-status -- Progress indicators for technology operations (sync, payment, AR loading)
Built by Raintree Technology · More developer tools
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
AGI Framework Integration
Adapted for @techwavedev/agi-agent-kit
Original source: antigravity-awesome-skills
Memory-First Protocol
Retrieve prior design decisions (color palettes, typography, spacing scales) to maintain visual consistency across sessions. Cache generated design tokens.
# Check for prior frontend/design context before starting
python3 execution/memory_manager.py auto --query "design system decisions and component patterns for Hig Technologies"
Storing Results
After completing work, store frontend/design decisions for future sessions:
python3 execution/memory_manager.py store \
--content "Design system: adopted 8px grid, Inter font family, HSL color tokens with dark mode support" \
--type decision --project <project> \
--tags hig-technologies frontend
Multi-Agent Collaboration
Share design decisions with backend agents (API contract changes) and QA agents (visual regression baselines).
python3 execution/cross_agent_context.py store \
--agent "<your-agent>" \
--action "Implemented UI components — new design system with accessibility compliance (WCAG 2.1 AA)" \
--project <project>
Design Memory Persistence
Store design system tokens and component decisions in Qdrant so any agent on any platform (Claude, Gemini, Cursor) can retrieve and apply consistent styling.
1---2name: hig-technologies3description: Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.4---56# Apple HIG: Technologies78Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.910## Key Principles1112### General13141. **Apple technologies extend app capabilities through system integration.** Each technology has established user-facing patterns; deviating creates confusion and erodes trust.15162. **Privacy and user control are paramount.** Especially for health, payment, and identity technologies. Request only needed data, explain why, respect choices.1718### Siri and Voice19203. **Natural, predictable, recoverable.** Clear conversational intent phrases that complete quickly and confirm results. Support App Shortcuts for proactive suggestions. Handle errors with clear fallbacks.2122### Payments and Commerce23244. **Transparent and frictionless.** Standard Apple Pay button styles. Never ask for card details when Apple Pay is available. Clearly describe what the user is buying, the price, and whether it's one-time or subscription.2526### Health and Fitness27285. **Health data is deeply personal.** Explain the health benefit before requesting access. CareKit tasks should be encouraging. ResearchKit consent flows must be thorough, readable, and respect autonomy.2930### Smart Home31326. **Simple and reliable.** Immediate response when controlling devices. Clear device state. Graceful handling of connectivity issues.3334### Augmented Reality35367. **Genuine value, not gimmicks.** Use AR when spatial context improves understanding. Guide setup (surface, lighting, space). Provide clear exit back to standard interaction.3738### Machine Learning and Generative AI39408. **Enhance without surprising.** Smart suggestions, image recognition, text prediction. Clearly attribute AI-generated content. Controls to edit, regenerate, or dismiss. Let users correct mistakes.4142### Identity and Authentication43449. **Sign in with Apple as top option.** Standard button styles. Respect email hiding preference. ID Verifier: guided flows, don't store sensitive data beyond what verification requires.4546### Cloud and Data474810. **Invisible and reliable sync.** Data appears on all devices without manual intervention. Handle conflicts gracefully. Never lose data.4950### Shared Experiences515211. **Real-time participation.** SharePlay: support multiple participants, show presence, handle latency. AirPlay: appropriate Now Playing metadata.5354### Automotive555612. **Driver safety first.** Minimize interaction complexity, large touch targets, no distracting content. Only permitted app types: audio, messaging, EV charging, navigation, parking, quick food ordering.5758### Accessibility596013. **Baseline requirement.** Every element has a meaningful VoiceOver label, trait, and action. Support Dynamic Type, Switch Control, and other assistive technologies. Test entirely with VoiceOver enabled.6162## Reference Index6364| Reference | Topic | Key content |65|---|---|---|66| [siri.md](references/siri.md) | Siri | Intents, shortcuts, voice interaction, App Shortcuts |67| [apple-pay.md](references/apple-pay.md) | Apple Pay | Payment buttons, checkout flow, security |68| [tap-to-pay-on-iphone.md](references/tap-to-pay-on-iphone.md) | Tap to Pay | Merchant flows, contactless payment |69| [in-app-purchase.md](references/in-app-purchase.md) | In-app purchase | Subscriptions, one-time purchases, transparency |70| [healthkit.md](references/healthkit.md) | HealthKit | Health data access, privacy, permissions |71| [carekit.md](references/carekit.md) | CareKit | Care plans, tasks, health management |72| [researchkit.md](references/researchkit.md) | ResearchKit | Studies, informed consent, data collection |73| [homekit.md](references/homekit.md) | HomeKit | Smart home control, device state, scenes |74| [augmented-reality.md](references/augmented-reality.md) | ARKit | Spatial context, surface detection, setup |75| [machine-learning.md](references/machine-learning.md) | Core ML | Predictions, smart features, confidence handling |76| [generative-ai.md](references/generative-ai.md) | Generative AI | Attribution, editing, responsible AI, uncertainty |77| [icloud.md](references/icloud.md) | iCloud | CloudKit, cross-device sync, conflict resolution |78| [sign-in-with-apple.md](references/sign-in-with-apple.md) | Sign in with Apple | Authentication, privacy, button styles |79| [id-verifier.md](references/id-verifier.md) | ID Verifier | Identity verification, document scanning |80| [shareplay.md](references/shareplay.md) | SharePlay | Shared experiences, participant presence |81| [airplay.md](references/airplay.md) | AirPlay | Media streaming, Now Playing, wireless display |82| [carplay.md](references/carplay.md) | CarPlay | Driver safety, permitted app types, large targets |83| [game-center.md](references/game-center.md) | Game Center | Achievements, leaderboards, multiplayer |84| [voiceover.md](references/voiceover.md) | VoiceOver | Screen reader, labels, traits, accessibility |85| [wallet.md](references/wallet.md) | Wallet | Passes, tickets, loyalty cards |86| [nfc.md](references/nfc.md) | NFC | Tag reading, quick interactions, App Clips |87| [maps.md](references/maps.md) | Maps | Location display, annotations, directions |88| [mac-catalyst.md](references/mac-catalyst.md) | Mac Catalyst | iPad to Mac, menu bar, keyboard, pointer |89| [live-photos.md](references/live-photos.md) | Live Photos | Motion capture, playback, editing |90| [imessage-apps-and-stickers.md](references/imessage-apps-and-stickers.md) | iMessage apps | Messages extension, stickers, compact UI |91| [shazamkit.md](references/shazamkit.md) | ShazamKit | Audio recognition, music identification |92| [always-on.md](references/always-on.md) | Always-on display | Dimmed state, power efficiency, reduced updates |93| [photo-editing.md](references/photo-editing.md) | Photo editing | System photo editor, filters, adjustments |9495## Output Format96971. **Implementation checklist** -- step-by-step requirements per Apple's guidelines.982. **Required vs optional features** for approval.993. **Privacy and permission requirements** -- data access, usage descriptions.1004. **User-facing flow** from permission prompt through task completion.1015. **Testing guidance** -- key scenarios including edge cases.102103## Questions to Ask1041051. Which Apple technology?1062. Core use case?1073. Which platforms?1084. API requirements and entitlements reviewed?1095. What data or permissions needed?110111## Related Skills112113- **hig-inputs** -- Input methods interacting with technologies (voice for Siri, Pencil for AR, gestures for Maps)114- **hig-components-system** -- Widgets, complications, Live Activities surfacing technology data115- **hig-components-status** -- Progress indicators for technology operations (sync, payment, AR loading)116117---118119*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*120121## When to Use122This skill is applicable to execute the workflow or actions described in the overview.123124---125126<!-- AGI-INTEGRATION-START -->127128## AGI Framework Integration129130> **Adapted for [@techwavedev/agi-agent-kit](https://www.npmjs.com/package/@techwavedev/agi-agent-kit)**131> Original source: [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills)132133### Memory-First Protocol134135Retrieve prior design decisions (color palettes, typography, spacing scales) to maintain visual consistency across sessions. Cache generated design tokens.136137```bash138# Check for prior frontend/design context before starting139python3 execution/memory_manager.py auto --query "design system decisions and component patterns for Hig Technologies"140```141142### Storing Results143144After completing work, store frontend/design decisions for future sessions:145146```bash147python3 execution/memory_manager.py store \148 --content "Design system: adopted 8px grid, Inter font family, HSL color tokens with dark mode support" \149 --type decision --project <project> \150 --tags hig-technologies frontend151```152153### Multi-Agent Collaboration154155Share design decisions with backend agents (API contract changes) and QA agents (visual regression baselines).156157```bash158python3 execution/cross_agent_context.py store \159 --agent "<your-agent>" \160 --action "Implemented UI components — new design system with accessibility compliance (WCAG 2.1 AA)" \161 --project <project>162```163164### Design Memory Persistence165166Store design system tokens and component decisions in Qdrant so any agent on any platform (Claude, Gemini, Cursor) can retrieve and apply consistent styling.167168<!-- AGI-INTEGRATION-END -->
techwavedev