diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000000..a499626f38
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,4 @@
+# Command Guidelines
+
+- When adding new commands, use `urfave/cli` instead of the legacy `commander` pattern.
+- Register new `urfave/cli` commands in the `migratedCommands` map in `cmd/src/run_migration_compat.go`.