From b19e3b646ded3ecddf20030cfa54829178a3a3c1 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sat, 9 May 2026 01:20:50 +0000
Subject: [PATCH] docs: fix schedule syntax documentation drift
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add missing schedule options to README.md and prompts/create-ado-agentic-workflow.md:
- every N days (EveryDays variant in fuzzy_schedule.rs)
- every N weeks (converts to N×7 days)
- bi-weekly / tri-weekly (already in prompts table but missing from README)
- Clarify valid hour intervals: 1, 2, 3, 4, 6, 8, 12 (not just "must divide 24")

All options are implemented in src/fuzzy_schedule.rs and documented in
docs/schedule-syntax.md, but were missing from the human-facing README
and the AI agent prompts guide.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 README.md                              | 12 +++++++++++-
 prompts/create-ado-agentic-workflow.md |  8 +++++---
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 97e62230..309e7be8 100644
--- a/README.md
+++ b/README.md
@@ -285,11 +285,21 @@ on:
 on:
   schedule: weekly on monday around 9:00   # Monday morning
 
+# Multi-day / Special periods
+on:
+  schedule: every 2 days                   # Every 2 days at scattered time
+on:
+  schedule: every 2 weeks                  # Every 14 days at scattered time
+on:
+  schedule: bi-weekly                      # Every 14 days at scattered time
+on:
+  schedule: tri-weekly                     # Every 21 days at scattered time
+
 # Hourly / Minute intervals
 on:
   schedule: hourly                         # Every hour, scattered minute
 on:
-  schedule: every 2h                       # Every 2 hours
+  schedule: every 2h                       # Every 2 hours (valid: 1, 2, 3, 4, 6, 8, 12)
 on:
   schedule: every 15 minutes               # Fixed, not scattered
 
diff --git a/prompts/create-ado-agentic-workflow.md b/prompts/create-ado-agentic-workflow.md
index f6166a55..35b2c828 100644
--- a/prompts/create-ado-agentic-workflow.md
+++ b/prompts/create-ado-agentic-workflow.md
@@ -111,11 +111,13 @@ schedule:
 | `daily between 9:00 and 17:00` | Business hours |
 | `weekly on monday` | Every Monday, scattered time |
 | `weekly on friday around 17:00` | Friday ~5 PM |
-| `hourly` | Every hour, scattered minute |
-| `every 2h` / `every 6h` | Every N hours (must divide 24) |
-| `every 15 minutes` | Minimum 5 min interval |
+| `every 2 days` | Every N days, time scattered |
+| `every 2 weeks` | Every N weeks (converted to N×7 days) |
 | `bi-weekly` | Every 14 days |
 | `tri-weekly` | Every 21 days |
+| `hourly` | Every hour, scattered minute |
+| `every 2h` / `every 6h` | Every N hours (valid: 1, 2, 3, 4, 6, 8, 12) |
+| `every 15 minutes` | Minimum 5 min interval |
 
 **Timezone**: Append `utc+N` or `utc-N` to any time: `daily around 9:00 utc-5`