diff --git a/.cursor/BUGBOT.md b/.cursor/BUGBOT.md
new file mode 100644
index 0000000..3de5e4d
--- /dev/null
+++ b/.cursor/BUGBOT.md
@@ -0,0 +1,12 @@
+# Dead Code Finder — Repo-Specific BugBot Rules
+
+> Org-wide rules are enforced via Cursor Team Rules.
+
+## Purpose
+
+- This is an Elixir tool for finding dead code across codebases. It uses Mix as the build tool.
+
+## Elixir Conventions
+
+- Source code is in `lib/`, tests in `test/`, config in `config/`. Follow standard Elixir/Mix project conventions.
+- Run `mix test` before committing changes to ensure no regressions.