1 files changed, 24 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..cc54ada
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,24 @@
+# Project Instructions
+
+## Context
+
+- Read `README.md` and `docs/architecture.md` before substantial changes.
+- Keep this HTTPS/Nym codebase separate from the legacy onion PHP `/compose/`
+  deployment.
+- Do not store secrets, SMTP credentials, private keys, or private provider
+  configuration in the repository.
+
+## Workflow
+
+- Preserve the onion-only path; do not add clearnet fallback there.
+- Keep Nym, SMTP, validation, and storage boundaries separate.
+- Prefer standard-library Go unless a dependency is clearly justified.
+
+## Checks
+
+```bash
+gofmt -w .
+go test ./...
+go vet ./...
+```
+