diff --git a/src/commands/index.js b/src/commands/index.js
index 40da98b..483d3b3 100644
--- a/src/commands/index.js
+++ b/src/commands/index.js
@@ -19,7 +19,7 @@ module.exports = [
     topic: 'set.mode',
     aliases: ['setMode'],
     payloadSchema: { type: 'string' },
-    description: 'Switch the machine between auto / manual control modes.',
+    description: 'Switch the operating mode. Allowed: `auto`, `virtualControl`, `fysicalControl`, `maintenance` (schema-validated in `rotatingMachine.json` → `mode.current`).',
     handler: handlers.setMode,
   },
   {