Skip to content

Latest commit

 

History

History
29 lines (19 loc) · 1.52 KB

AGENTS.md

File metadata and controls

29 lines (19 loc) · 1.52 KB

Agents

This file provides development guidelines for AI agents working with this Swift Package Manager project.

Development

Code Patterns

  • Use appropriate logging frameworks instead of print statements.
  • Follow protocol-oriented design patterns.
  • CRITICAL: If they are listed on Package.swift, always check FoundationKit, LoggerKit, and other core frameworks before implementing basic functionality. These frameworks contain extensive extensions and utilities that avoid code duplication (typically you can find them in the project parent directory).

Core Frameworks Functionality Examples

  • NSError: NSError(description:, recoverySuggestion:) convenience initializer.
  • NSAppleScript: execute() method with proper Swift error handling.
  • ProcessInfo: launchExtensionsPaneInSystemSettings(), launchPrivacyAndSecurityPaneInSystemSettings().
  • URL: open(withAppBundleIdentifier:) for cross-platform URL opening.
  • Process: Enhanced execution utilities with output capture.
  • UserDefaults: @UserDefaults.Wrapper property wrapper for cleaner app settings.

Building and Testing

  • Always verify changes work by building or testing before considering task complete.
  • Changes are not complete until successfully built and verified.

IMPORTANT: This is a generic development guide for AI agents shared and available on multiple projects, so avoid adding project-specific information here. Refer to README.md file if available and the source code for project-specific details.