diff --git a/AGENTS.md b/AGENTS.md
index 2686dd873..5eb689b35 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -82,4 +82,5 @@ When interpolating values into shell command strings (in `fabro-exe` and `fabro-
 
 ## Testing workflows
 
-When manually testing workflows with `fabro run`, use `--no-retro` to skip the retro step and finish faster.
+- `fabro run <name>` — run a workflow by name (resolves `arc/workflows/<name>/workflow.toml`), e.g. `fabro run repl`
+- Use `--no-retro` to skip the retro step and finish faster