From 0fc8dd679739ecaec1cd8b8d80a8d55bed678989 Mon Sep 17 00:00:00 2001
From: William Bezuidenhout <william.bezuidenhout@sourcegraph.com>
Date: Wed, 15 Apr 2026 16:15:56 +0200
Subject: [PATCH] add AGENTS.md guidance to use urfave/cli when adding new
 commands

---
 AGENTS.md | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 AGENTS.md

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`.