diff --git a/docs/vex-generator.md b/docs/vex-generator.md
index 1bef5b1..17eaeaf 100644
--- a/docs/vex-generator.md
+++ b/docs/vex-generator.md
@@ -107,6 +107,10 @@ For each eligible dismissal, the workflow creates a pull request adding a `.vex/
 }
 ```
 
+### Configuration
+
+After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.
+
 ### Human in the Loop
 
 - Review the generated VEX statement PR before merging
diff --git a/workflows/vex-generator.md b/workflows/vex-generator.md
index a41360d..cdcd7a3 100644
--- a/workflows/vex-generator.md
+++ b/workflows/vex-generator.md
@@ -1,4 +1,9 @@
 ---
+description: >
+  Auto-generates an OpenVEX statement for a dismissed Dependabot alert.
+  Provide the alert details as inputs — the agent generates a standards-compliant
+  OpenVEX document and opens a PR.
+
 on:
   workflow_dispatch:
     inputs:
@@ -40,11 +45,6 @@ on:
           - tolerable_risk
           - no_bandwidth
 
-description: >
-  Auto-generates an OpenVEX statement for a dismissed Dependabot alert.
-  Provide the alert details as inputs — the agent generates a standards-compliant
-  OpenVEX document and opens a PR.
-
 permissions:
   contents: read
   issues: read