
Persistent notes pattern for complex epics with 3+ stories. Creates planning/notes/<epic>/ with context.md, decisions.md, open-questions.md, progress.md. Maintains context across sessions.
Comment structure and rules for task workflow updates. Use when adding any comment to a task during implementation, review, or fix cycles.
Xcode 26.3 MCP bridge integration. Dual-mode build, test, preview, diagnostics, and documentation tools. Requires Xcode 26.3+ running with project loaded.
SOLID principles, DRY, Clean Architecture, and design patterns for macOS development. Use when making architectural decisions or reviewing code structure.
Concrete SwiftUI design system with exact values for spacing, typography, color, and components. Reference during ALL UI implementation work.
Generates a protocol-based networking layer with async/await, error handling, and swappable implementations. Use when user wants to add API client, networking, or HTTP layer.
Generate XCTest templates for unit tests, integration tests, and UI tests. Use when adding test coverage to ViewModels, services, or repositories.
macOS development best practices for code organization, data persistence, concurrency, and Swift language usage. Use when planning project structure or reviewing code patterns.
Comprehensive UI/UX review for macOS Tahoe apps. Covers Liquid Glass design, HIG compliance, SwiftUI patterns, and accessibility. Use when reviewing macOS UI or checking HIG compliance.
Security review and guidance for iOS, macOS, and watchOS apps. Covers secure storage, biometric authentication, network security, and platform-specific patterns. Use when implementing security features or reviewing code for vulnerabilities.
Claude Code's built-in task management system. Provides persistent memory via TaskCreate, TaskUpdate, TaskGet, TaskList tools with hierarchical organization and dedicated workflow state fields.
Core Data persistence patterns for macOS apps. Stack setup, CRUD operations, relationships, migrations.
Secure storage patterns using Keychain Services for macOS apps. Covers storing credentials, API tokens, and sensitive data. Use when implementing Keychain access, credential storage, or secure data management.
macOS app crash recovery, state restoration, and autosave patterns. Use when implementing data persistence, app lifecycle, or any feature where data loss on crash is a concern.
macOS SwiftUI scene types, window management, and multi-window patterns. Use when building app structure, adding windows, or managing window lifecycle.
Peekaboo MCP server for macOS screen capture and UI automation. Provides 22 tools for screenshots, element interaction, dialog handling, and visual QA. Requires Peekaboo MCP server running with Screen Recording + Accessibility permissions.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Project-specific Swift conventions for this macOS app. Not a language tutorial — covers only deviations from standard Swift.
Deep dive into SwiftData design patterns and best practices. Covers schema design, query patterns, repository pattern, and performance optimization. Use when designing data models or improving SwiftData usage.
macOS Tahoe (26.0+) SwiftUI conventions and project layout standards. Not a tutorial — covers Tahoe-specific patterns and project deviations only.
Xcode build system knowledge for macOS apps. Build settings, configurations, schemes, signing, distribution, and optimization.
Structured recovery templates for common agent failure modes. Use when an agent fails mid-task due to context exhaustion, build failure, or unclear requirements.
Canonical review cycle state machine, transition rules, and comment templates for all workflow stages. Use when advancing workflow state or writing review comments.
Validate task/story/epic/bug/techdebt metadata against schema v2.0. Run after TaskCreate or TaskUpdate to verify compliance. Returns pass/fail with actionable details.
Canonical v2.0 metadata schema field reference for epics, stories, and tasks. Use when creating or validating task metadata.
How to transition workflow state between review stages. Rules for setting review_stage and review_result fields on Stories and Epics.
GitHub CLI patterns for PRs, issues, and repository management.
Track Claude Code platform updates, model changes, and new features. Manages cached documentation snapshots and produces change reports.
Guidelines for spawning subagents to maintain clean context. Use for research tasks, parallel coding, verification, or any work benefiting from isolated context. Patterns by agent type.
Shared context file pattern for cross-task consistency within a story. Agents read before starting and append after completing each task.
macOS drag-and-drop patterns using Transferable, onDrag/onDrop, and dropDestination. Use when implementing list reordering, cross-app drops, or file drops.
Steps to mark a task completed with required comments, then check parent story advancement. Enforces completion gate: implementation + testing comments required.
Create epics, stories, and tasks with schema v2.0 compliance. Guidance for breaking epics into stories, stories into tasks. Use during /epic or /write-stories-and-tasks.
Pre-submission validation for stories before code review. Verifies all child tasks complete, tests pass, build succeeds. Required before setting review_stage to code-review.
XCTest patterns for macOS Swift apps. Unit tests, async tests, Core Data tests, mock patterns, and assertion reference. Use when writing or reviewing tests.
Shared terminology, review cycle overview, and task state protocol reference for all agents. Preloaded into agent context to avoid duplication across agent prompts.