diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..5e4bbfe --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,22 @@ +# Agent Instructions + +These instructions are authoritative for work in this repository. + +## Product & UX +- Always adhere to the latest Apple Human Interface Guidelines (iOS). +- Always implement accessibility best practices (labels, traits, dynamic type, sufficient contrast). +- On iOS, always use default system colors unless explicitly told otherwise (e.g., `.green`). +- Use English as the primary language in the app and design with localization in mind from the start. Implement localization scaffolding for English, German, Spanish, and French. +- Date/time conventions are fixed: Monday is the first day of the week. Do not vary by locale. +- Units are always metric; do not use imperial units. + +## Privacy & Permissions +- Follow the principle of least privilege. For sensitive access (e.g., contacts), always offer the user a choice between limited and full access when the platform supports it. + +## Engineering Standards +- Always use SwiftUI when possible. +- Git commit messages must start with a lower-case letter. +- Prefer self-contained builds. The app should run on first launch without extra setup when feasible. +- For iOS development, target the latest available iOS version when creating new projects. +- For iOS project setup, use Team ID `NG5W75WE8U`. +- Avoid accounts unless absolutely necessary. Prefer account-less flows; for iOS apps, use iCloud as a backend by default. If we go to web, discuss accounts explicitly.