diff --git a/README.md b/README.md
index 753a439..3113046 100644
--- a/README.md
+++ b/README.md
@@ -98,13 +98,11 @@ The sliders go far: a nudge can be a tremor or an earthquake, a banner can
 stay for five minutes. `attention-required effects` prints every option and
 range as JSON.
 
-## For agents and scripts
+## Reference
 
-[AGENTS.md](AGENTS.md) is the complete, exact reference: the file schema, every
+[REFERENCE.md](REFERENCE.md) is the complete reference: the file schema, every
 effect option with its range, the CLI, how to verify, and worked scenarios.
-Point your coding agent at it (`attention-required docs` prints it) and ask
-for "a red flash and a chime when the build fails" or "meeting mode: only my
-boss on Slack gets through".
+`attention-required docs` prints it.
 
 ## Command line
 
diff --git a/AGENTS.md b/REFERENCE.md
similarity index 99%
rename from AGENTS.md
rename to REFERENCE.md
index 48905eb..055005d 100644
--- a/AGENTS.md
+++ b/REFERENCE.md
@@ -1,4 +1,4 @@
-# Attention Required: guide for agents
+# Attention Required: configuration reference
 
 This file is for an AI agent (or a script) asked to change how this machine
 reacts to notifications, for example "shake the screen and play a sound when
diff --git a/bin/attention-required b/bin/attention-required
index 11a0299..4cba24d 100755
--- a/bin/attention-required
+++ b/bin/attention-required
@@ -13,7 +13,7 @@
 #   attention-required remove NAME
 #   attention-required enable NAME | disable NAME
 #   attention-required effects                      the effect catalog with every option and range, as JSON
-#   attention-required docs                         print the guide for scripts and agents (AGENTS.md)
+#   attention-required docs                         print the configuration reference
 #   attention-required test EFFECT                  run one effect now, e.g. `test nudge`
 #                                                   or `test '{"type":"flash","color":"urgent"}'`
 #   attention-required simulate APP SUMMARY [BODY]  run a made-up notification past the rules
@@ -149,7 +149,7 @@ case ${1:-help} in
   patch) shift; cmd_patch "$@" ;;
   remove|rm) shift; cmd_remove "$@" ;;
   effects) ipc effects | jq . ;;
-  docs) cat "$here/AGENTS.md" ;;
+  docs) cat "$here/REFERENCE.md" ;;
   enable) shift; cmd_toggle true "$@" ;;
   disable) shift; cmd_toggle false "$@" ;;
   test) [[ -n ${2:-} ]] || die "usage: test EFFECT"; ipc test "$2" ;;