diff --git a/docs/reference/specs/plan-export.md b/docs/reference/specs/plan-export.md
index be4cde1b..a11bc4ba 100644
--- a/docs/reference/specs/plan-export.md
+++ b/docs/reference/specs/plan-export.md
@@ -166,7 +166,7 @@ This bound prevents unbounded snapshot artifacts while keeping the marker audita
 ```json
 "plan": {
   "id": "plan-001",
-  "mode": "PlanOnly",
+  "mode": null,
   "steps": []
 }
 ```
@@ -177,7 +177,7 @@ This bound prevents unbounded snapshot artifacts while keeping the marker audita
 | ------ | ------------ |
 | id | Unique identifier of the plan |
 | createdAt | (Optional) ISO-8601 UTC timestamp |
-| mode | Plan lifecycle state |
+| mode | Plan lifecycle state (`null` when not explicitly set on the plan object) |
 | steps | Ordered list of step objects |
 
 ---
diff --git a/docs/use/plan-export.md b/docs/use/plan-export.md
index da73bffc..be5f7093 100644
--- a/docs/use/plan-export.md
+++ b/docs/use/plan-export.md
@@ -21,7 +21,7 @@ Plan export is useful to:
 ## Export a plan
 
 ```powershell
-$request = New-IdleRequest -LifecycleEvent 'Joiner' -CorrelationId (New-Guid) -IdentityKeys @{
+$request = New-IdleRequest -LifecycleEvent 'Joiner' -CorrelationId (New-Guid) -Actor 'HR-System' -IdentityKeys @{
     EmployeeId = '12345'
 } -Intent @{
     Department = 'IT'