Skip to content

pavliuko/cursor-rules

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Purpose

A centralized collection of Cursor AI rules, Claude AI agents, commands, skills, and Apple framework documentation designed to enhance AI-assisted iOS/Swift development workflows. These resources provide clear context about coding standards, architectural decisions, and framework usage patterns to ensure consistent code quality across projects.

Cursor

🏗️ Architecture & Design

  • Forget MVVM (by Dimillian) — Modern SwiftUI architecture patterns that embrace declarative UI and native data flow instead of legacy MVVM patterns.
  • Modular Architecture — Guidelines for a modular Swift Package architecture with Core infrastructure and self-contained Features.

📋 Issue & Task Management

  • GitHub Issue — Create comprehensive GitHub issues with proper templates and CLI integration.
  • ZenHub Issue — Create comprehensive ZenHub issues with proper templates and MCP functions.

🔧 Development Workflow

  • Commit Message — Conventional Commits guidelines with recommended tags and footer metadata.
  • Commit Staged & Push — Commit staged changes and push to remote.
  • Pull Request — Pull request creation guidelines with GitHub CLI integration and emoji conventions.

🎨 Code Quality

  • SwiftFormat — Automatic code formatting with SwiftFormat for consistent Swift code style.

⚠️ Critical Rules

📖 Meta

  • Cursor Rules Meta Guide — Guidelines for creating and maintaining Cursor rules to ensure consistency and effectiveness.

Claude

🤖 Agents

  • QA Test Engineer — Expert QA engineer for assessing test coverage, creating test strategies, writing test cases, and verifying application functionality.
  • Security Audit Specialist — Senior security auditor for credential management review, token handling, and architecture security assessment.
  • SwiftUI Architect — SwiftUI architecture specialist for building clean, maintainable views using modern iOS 18/26 features and proper component patterns.

🛠️ Commands

  • Commit Staged — Commit staged changes following project commit message guidelines.
  • Document Core UI Components — Generate a concise quick-reference for the Core package's DesignSystem, SharedUI, and Router modules.
  • Extract to Package — Extract requested functionality into a Swift Package with proper structure and public API.
  • Pull Request — Create or edit GitHub Pull Requests following project PR guidelines.
  • Update README — Update the README.md with a structured summary of all rules and documentation.
  • View Config — Refactor SwiftUI views into configurable components with nested ViewConfiguration struct and modifier functions.
  • ZenHub Issue — Create or update ZenHub issues following project workflows.

📐 Rules

  • Build Commands — XcodeBuildMCP tool usage for building, testing, and managing iOS projects.
  • Commit Message — Commit message conventions with issue number extraction from branch names and conventional commits.
  • GitHub Issue — GitHub issue creation workflow with templates, CLI commands, and quality guidelines.
  • Modular Architecture — Modular Swift Package architecture with Core and Features package structure.
  • PR Guide — Pull request creation workflow with analysis, syncing, description templates, and review guidelines.
  • Rules Meta Guide — Guidelines for creating and maintaining Claude rules with proper structure and examples.
  • SwiftFormat — SwiftFormat integration requirements and best practices for automatic code formatting.
  • SwiftUI Architecture — UI-heavy feature architecture principles: native state management, no ViewModels, unidirectional data flow.
  • SwiftUI View Organization — View structure conventions including property ordering, body decomposition, and extension-based helpers.
  • Unit Testing — Unit testing guidelines using Swift Testing framework with decision framework and examples.
  • ZenHub Issue — ZenHub issue creation workflow with MCP functions, templates, and pipeline configuration.

🧩 Skills

  • Agent Rules Writer — Guide for writing and maintaining agent rules files with proper structure and DO/DON'T examples.
  • Explaining Code — Explains code with visual ASCII diagrams, analogies, and step-by-step walkthroughs.

Documentation

📚 Apple Framework References

  • AppKit Documentation — Comprehensive AppKit reference for building macOS graphical user interfaces (1,847 pages).
  • Swift Concurrency — Complete guide to Swift 6 data race safety, actors, Sendable protocol, and strict concurrency.
  • SwiftData Documentation — SwiftData reference for declarative model persistence and efficient fetching (292 pages).
  • SwiftUI Documentation — SwiftUI reference for declarative UI and behavior across all Apple platforms (1,982 pages).
  • UIKit Documentation — UIKit reference for building iOS, iPadOS, and tvOS graphical user interfaces (1,935 pages).

License

This project is licensed under the MIT License. See LICENSE for details.

About

A growing collection of rules for Cursor scans to help improve code quality, structure, and best practices.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors