fix(skills): improve iOS integration with complete push notification setup

[pmTouchedTheCode]

Summary

• Add complete AppDelegate pattern with all delegate methods for push notifications
• Add SwiftUI + AppDelegate hybrid pattern for SwiftUI apps
• Make interactive mode more proactive about file automation
• Add automated NSE file creation to install and ios-setup skills
• Clearly distinguish CAN vs CANNOT automate in skill documentation

Problem

The /integrate skill had three issues when performing iOS integration:

1. NSE not installed: The Notification Service Extension setup was marked as "IDE-Only Manual Steps" but many parts CAN be automated
2. Initialize code and delegate methods not added: The skill didn't add proper AppDelegate delegate methods for push notification handling
3. Asking users to do manually when it can automate: The skill was too conservative, asking users to do things manually that could be automated

Changes

1. Updated integration skill iOS patterns (src/lib/embedded-skills.ts)

• Added complete AppDelegate pattern with all delegate methods
• Added UNUserNotificationCenterDelegate conformance
• Added didRegisterForRemoteNotificationsWithDeviceToken for token registration
• Added didFailToRegisterForRemoteNotificationsWithError for error handling
• Added willPresent for foreground notifications
• Added didReceive for notification tap handling
• Added push notification permission request code
• Included SwiftUI + AppDelegate hybrid pattern

2. Updated install skill (src/lib/skills/install/SKILL.md)

• Moved NSE setup from "IDE-Only Manual Steps" to main installation flow
• Added explicit instructions to create files AUTOMATICALLY
• Clearly distinguished what CAN vs CANNOT be automated

3. Updated interactive mode instruction (src/lib/skills.ts)

• Changed from passive "ask before doing anything" to proactive automation
• Standard file creation/modification now proceeds automatically
• Only asks for confirmation when genuinely needed

4. Updated iOS setup skill (src/lib/skills/ios-setup/SKILL.md)

• Updated Phase 3.5 with clear CAN/CANNOT automate sections
• Added explicit file templates for automated creation

Test plan

• Run /integrate on a sample iOS project and verify SDK initialization includes delegate methods
• Verify NSE files are created automatically (NotificationService.swift, Info.plist, entitlements)
• Verify skill only provides manual instructions for Xcode UI steps
• Run bun run check && bun test to verify no regressions

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation

  • Enhanced iOS setup documentation with additional initialization patterns and expanded notification handling guidance.
  • Clarified which setup steps can be automated and which require manual configuration or portal access.

• Enhancement

  • Improved interactive workflow instructions to prioritize automation while requesting confirmation only when necessary.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

The PR updates iOS documentation and workflow instructions across multiple files. It adds SwiftUI/AppDelegate initialization patterns in embedded skills, replaces manual iOS setup steps with automated workflows in skill markdown files, and updates interactive mode guidance to emphasize automation-oriented instructions rather than strict workflow patterns.

Changes

Cohort / File(s)	Summary
iOS Documentation & Initialization Patterns src/lib/embedded-skills.ts	Added three SwiftUI initialization patterns (App Pattern, AppDelegate Pattern, hybrid pattern) with complete code examples. Expanded Key Points section to cover push-notification handling, delegate usage, and environment variable-based credentials. +150 lines.
Interactive Workflow Instructions src/lib/skills.ts	Replaced strict Confirm → Propose → Validate → Implement → Verify workflow enforcement with automation-oriented guidance. Introduced explicit CAN AUTOMATE vs CANNOT AUTOMATE task distinctions and restructured prompts for autonomous execution vs interactive modes. +35/-16 lines.
iOS Setup Automation src/lib/skills/install/SKILL.md, src/lib/skills/ios-setup/SKILL.md	Shifted from manual Xcode target creation steps to automated NSE file generation workflow. Updated NotificationService.swift project ID constant from YOUR_PROJECT_ID to YOUR_CLIX_PROJECT_ID. Added automated Info.plist, entitlements, and Podfile templates with placeholders. Delineated automatable vs manual steps with concrete file creation instructions. +235 lines combined.

Possibly Related PRs

• feat: add iOS setup autonomous command #4: Modifies iOS setup skill documentation and interactive workflow instruction strings in src/lib/skills.ts and iOS SKILL.md files with overlapping content.
• feat(ios): add NSE setup guide with SDK-aligned implementation #9: Updates iOS Notification Service Extension setup documentation and NotificationService.swift template in embedded-skills.ts and iOS setup SKILLs.
• fix: add interactive mode instruction to embedded skills #6: Modifies the interactive-mode guidance and workflow instruction strings in src/lib/skills.ts with changes to automation-oriented prompts.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: improving iOS integration with push notification setup, which aligns with the primary objectives across all modified files.
Description check	✅ Passed	The description comprehensively covers the Summary, Details/Problem/Changes, and includes a Test plan section; all key sections of the template are addressed with substantive content.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pitzcarraldo]

Closing this PR — the changes are no longer applicable after the command-mode architecture refactor in #22.

What happened:

• INTERACTIVE_MODE_INSTRUCTION was removed entirely (replaced by ONE_SHOT_INSTRUCTION)
• embedded-skills.ts was completely rewritten (1495 → 215 lines)
• install/SKILL.md was rewritten with preparation-based architecture (NSE handled by InstallPreparationUI)
• ios-setup moved from skills to UI components (src/ui/components/ios-setup/)

The goals of this PR (proactive iOS automation, better push notification patterns) are now addressed differently through the preparation task flow in #22.