diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..155312fa
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,7 @@
+# Repo Guidelines
+
+- Use 4 spaces for indentation.
+- Keep Swift file lines under 1000 characters.
+- Run SwiftLint using `.swiftlint.yml`.
+- Execute tests with `bundle exec fastlane tests` before committing.
+- Document public changes in `README.md`.