diff --git a/bin/modules.md b/bin/modules.md
new file mode 100644
index 00000000..7aa6fb4d
--- /dev/null
+++ b/bin/modules.md
@@ -0,0 +1,14 @@
+# Modules
+
+```mermaid
+sequenceDiagram
+    actor Dev
+    participant poscli
+    participant filesystem
+    participant Platform
+    participant Portal
+    Dev->>poscli: pos-cli modules setup
+    poscli->>filesystem: read local modules
+    poscli->>Portal: create pos-modules.lock.json
+```
+
diff --git a/bin/pos-cli-modules.js b/bin/pos-cli-modules.js
index d9682069..c6e3a88b 100755
--- a/bin/pos-cli-modules.js
+++ b/bin/pos-cli-modules.js
@@ -4,11 +4,11 @@ const program = require('commander');
 
 program
   .name('pos-cli modules')
+  .command('list [environment]', 'list installed modules on the instance')
+  .command('pull [environment] <name>', 'pull a module for the instance')
+  .command('remove [environment] <name>', 'remove module from the instance (removes configuration and data)')
+  .command('setup', 'initialize module lock file for the instance')
   .command('init <name>', 'initialize a module with the starter structure')
-  .command('list [environment]', 'list installed modules')
-  .command('pull [environment] <name>', 'pull a module for instance')
-  .command('push', 'publish module version')
-  .command('remove [environment] <name>', 'remove module from instance (removes configuration and data)')
   .command('version [version] --package', 'create a new version of the module')
-  .command('setup', 'initialize module lock file')
+  .command('push', 'publish module version')
   .parse(process.argv);