Skip to content

Commit d255c37

Browse files
committed
Updated project [SKIP-CI]
1 parent 68d4584 commit d255c37

1 file changed

Lines changed: 27 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# Agents
2+
3+
This file provides development guidelines for AI agents working with this Swift Package Manager project.
4+
5+
## Development
6+
7+
### Code Patterns
8+
- Use appropriate logging frameworks instead of print statements.
9+
- Follow protocol-oriented design patterns.
10+
- **CRITICAL: Always check FoundationKit, LoggerKit, and other core frameworks before implementing basic functionality.** These frameworks contain extensive extensions and utilities that avoid code duplication.
11+
12+
#### Core Frameworks Extensions Examples
13+
- **NSError**: `NSError(description:, recoverySuggestion:)` convenience initializer
14+
- **NSAppleScript**: `execute()` method with proper Swift error handling
15+
- **ProcessInfo**: `launchExtensionsPaneInSystemSettings()`, `launchPrivacyAndSecurityPaneInSystemSettings()`
16+
- **URL**: `open(withAppBundleIdentifier:)` for cross-platform URL opening
17+
- **Process**: Enhanced execution utilities with output capture
18+
- **UserDefaults**: `@UserDefaults.Wrapper` property wrapper for cleaner app preferences
19+
20+
### Building and Testing
21+
- To build or test this SwiftPM project, use `DeveloperBuildTool [--test]` instead of `swift build` or `swift test`.
22+
- **Always verify changes work** by building or testing before considering task complete.
23+
- Changes are not complete until successfully built and verified.
24+
25+
---
26+
27+
**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 and the source code for project-specific details.

0 commit comments

Comments
 (0)