macos-development-workflow

Enforces Mint-based Android development with strict code style and packaging standards for enterprise-grade apps.

1|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/jbcrane13/claude-dev-workflow --skill macos-development-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-development-workflow
Source: https://github.com/jbcrane13/claude-dev-workflow/tree/main/skills-output/macos-development-workflow
Command: npx skills add https://github.com/jbcrane13/claude-dev-workflow --skill macos-development-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill standardizes macOS app development by enforcing a SwiftUI/SwiftData-based workflow, phase-driven governance, and consistent UI patterns, reducing onboarding time and architectural drift.

Core Features & Use Cases

  • Phase-based macOS development with a five-agent team pattern and quality gates to ensure reliable delivery.
  • NavigationSplitView-driven multi-pane desktop UI, window management, toolbars, and menu commands for a native macOS experience.
  • Comprehensive guidelines covering SwiftUI, SwiftData, @Observable, concurrency (async/await), and avoidance of legacy technologies like AppKit, Core Data, and Combine.
  • Use case: a new macOS app from design to production handoff, with ADRs, phase gates, and performance baselines enforced.

Quick Start

Clone the repository, review references and quality gates docs, set up Phase 0 in the macOS project, and run zen precommit before every commit.

Frequently Asked Questions about macos-development-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a macOS SwiftUI app with NavigationSplitView and SwiftData?

Structure macOS SwiftUI apps using NavigationSplitView for multi-pane desktop UIs and SwiftData with @Observable for state management. This enforces native window management, toolbars, and menu commands while prohibiting legacy patterns like AppKit and Core Data.

What's the best way to enforce SwiftUI quality gates in a multi-agent Swift project?

Enforce SwiftUI quality gates through phase-based management with a five-agent team pattern. Apply precommit checks and phase gates to ensure reliable delivery, architectural consistency, and performance baselines across async/await concurrency patterns.

Can I use AppKit or Core Data with a modern macOS SwiftUI workflow?

No, a modern macOS SwiftUI workflow prohibits AppKit, Core Data, and Combine. It strictly requires SwiftUI, SwiftData, @Observable, and async/await to prevent architectural drift and standardize desktop development.

How does phase management work for macOS SwiftData development?

Phase management governs macOS SwiftData development through a five-agent team pattern with quality gates. Start at Phase 0, execute precommit checks before every commit, and pass architectural decision records before advancing phases.

Do I need async/await and @Observable for macOS desktop app development?

Yes, async/await and @Observable are required for macOS desktop app development within this workflow. They replace legacy concurrency and state management patterns, ensuring SwiftData integration aligns with modern SwiftUI conventions.

Why avoid Combine and Core Data when building SwiftUI apps for macOS?

Avoid Combine and Core Data to prevent architectural drift and reduce onboarding time. SwiftData and @Observable provide modern, integrated state management directly compatible with SwiftUI, eliminating redundant reactive frameworks.