docs: replace low-level cron with fuzzy scheduling in documentation (#30871)

Agent-Logs-Url: https://github.com/github/gh-aw/sessions/b8ce651c-48d1-47d2-afa9-87f74ef02496

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Author: Copilot

docs/src/content/docs/examples/scheduled.md

@@ -1,11 +1,11 @@
 ---
 title: Scheduled Workflows
-description: Workflows that run automatically on a schedule using cron expressions - daily reports, weekly research, and continuous improvement patterns
+description: Workflows that run automatically on a schedule using fuzzy schedules - daily reports, weekly research, and continuous improvement patterns
 sidebar:
   order: 1
 ---
 
-Scheduled workflows run automatically at specified times using cron expressions. They're perfect for recurring tasks like daily status updates, weekly research reports, continuous code improvements, and automated maintenance.
+Scheduled workflows run automatically at specified times using fuzzy schedule expressions. They're perfect for recurring tasks like daily status updates, weekly research reports, continuous code improvements, and automated maintenance.
 
 ## When to Use Scheduled Workflows
 

docs/src/content/docs/patterns/batch-ops.md

@@ -25,8 +25,7 @@ Split work into fixed-size pages using `GITHUB_RUN_NUMBER`. Each run processes o
 ```aw wrap
 ---
 on:
-  schedule:
-    - cron: "0 2 * * 1-5"  # Weekdays at 2 AM
+  schedule: daily on weekdays
   workflow_dispatch:
 
 tools:

docs/src/content/docs/patterns/central-repo-ops.mdx

@@ -24,8 +24,7 @@ Navigate to your central repository and create a workflow file `.github/workflow
 ```aw wrap
 ---
 on:
-  schedule:
-    - cron: '0 9 * * 1'
+  schedule: weekly on monday
 
 tools:
   github:

docs/src/content/docs/patterns/daily-ops.md

@@ -16,8 +16,7 @@ Workflows run on weekday schedules (avoiding weekends) with `workflow_dispatch`
 ```aw wrap
 ---
 on:
-  schedule:
-    - cron: "0 2 * * 1-5"  # Weekdays only (no short syntax available)
+  schedule: daily on weekdays
   workflow_dispatch:
 ---
 ```

docs/src/content/docs/patterns/project-ops.mdx

@@ -82,8 +82,7 @@ Let's start with a simple agentic workflow that reviews project board state and
 ```aw wrap
 ---
 on:
-  schedule:
-    - cron: "0 14 * * 1"
+  schedule: weekly on monday
 permissions:
   contents: read
   actions: read

docs/src/content/docs/patterns/research-plan-assign-ops.md

@@ -25,8 +25,7 @@ The [`go-fan`](https://github.com/github/gh-aw/blob/main/.github/workflows/go-fa
 ---
 name: Go Fan
 on:
-  schedule:
-    - cron: "0 7 * * 1-5"
+  schedule: daily on weekdays
   workflow_dispatch:
 engine: claude
 safe-outputs:

docs/src/content/docs/patterns/workqueue-ops.md

@@ -52,8 +52,7 @@ Create one sub-issue per work item. The agent queries open sub-issues of a paren
 ```aw wrap
 ---
 on:
-  schedule:
-    - cron: "0 * * * *"   # Every hour
+  schedule: hourly
   workflow_dispatch:
 
 tools:
@@ -90,8 +89,7 @@ Store queue state as a JSON file in [cache-memory](/gh-aw/reference/cache-memory
 ```aw wrap
 ---
 on:
-  schedule:
-    - cron: "0 6 * * 1-5"  # Weekdays at 6 AM
+  schedule: daily on weekdays
   workflow_dispatch:
 
 tools:
@@ -138,8 +136,7 @@ Use a GitHub Discussion to track pending work items. Unresolved replies represen
 ```aw wrap
 ---
 on:
-  schedule:
-    - cron: "0 8 * * *"   # Daily at 8 AM
+  schedule: daily
   workflow_dispatch:
 
 tools:

docs/src/content/docs/reference/cross-repository.md

@@ -256,8 +256,7 @@ A scheduled workflow that automatically pushes changes to open pull-request bran
 ```aw wrap
 ---
 on:
-  schedule:
-    - cron: "0 * * * *"
+  schedule: hourly
 
 checkout:
   - repository: org/target-repo

docs/src/content/docs/reference/faq.md

@@ -146,15 +146,21 @@ This enables reusable tool configurations, network settings, and permissions acr
 
 ### Can I run workflows on a schedule?
 
-Yes, use cron expressions in the `on:` trigger:
+Yes, use fuzzy schedule expressions in the `on:` trigger (recommended):
+
+```yaml wrap
+on: weekly on monday  # Automatically scattered to avoid load spikes
+```
+
+Or use standard cron syntax for fixed times:
 
 ```yaml wrap
 on:
   schedule:
     - cron: "0 9 * * MON"  # Every Monday at 9am UTC
 ```
 
-See [Schedule Syntax](/gh-aw/reference/schedule-syntax/) for cron expression reference.
+See [Schedule Syntax](/gh-aw/reference/schedule-syntax/) for all supported formats.
 
 ### Can I run workflows conditionally?
 

docs/src/content/docs/reference/playwright.md

@@ -139,8 +139,7 @@ Playwright includes three browser engines: **Chromium** (Chrome/Edge, most commo
 ```aw wrap
 ---
 on:
-  schedule:
-    - cron: "0 9 * * *"  # Daily at 9 AM
+  schedule: daily
 
 tools:
   playwright: