diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..e0e3321
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,36 @@
+# AGENTS.md
+
+## Repo purpose
+(summary not found; see README.md)
+
+## Tech stack
+- (unknown; infer from repo files)
+
+## Build / test / lint / run (best-effort)
+
+### Bootstrap
+- (not detected; check README/Makefile/package scripts)
+
+### Build
+- (not detected; check README/Makefile/package scripts)
+
+### Test
+- (not detected; check README/Makefile/package scripts)
+
+### Lint / format
+- (not detected; check README/Makefile/package scripts)
+
+### Run
+- (not detected; check README/Makefile/package scripts)
+
+## Project layout (where to look)
+- Start with `README.md` and `.github/workflows/`.
+- Common conventions (if present): `src/`, `lib/`, `cmd/`, `internal/`, `packages/`.
+- Look for build entrypoints: `Makefile`, `package.json`, `go.mod`, `pyproject.toml`.
+
+## CI / workflows
+- `publish-deployer.yaml`
+
+## Common gotchas
+- Some commands above are **best-effort guesses** based on repository signals; prefer README/Makefile/package scripts when they disagree.
+- If CI fails, check workflow logs for exact tool versions and required secrets.