[workshop] Add node: Schedule It to Run Every Day (#69)

Author: github-actions[bot]

workshop/13-schedule-it.md

@@ -0,0 +1,92 @@
+# Schedule It to Run Every Day
+
+> _Automating the trigger is what turns a one-off script into a true workflow — after this step your report will arrive without you lifting a finger._
+
+## 🎯 What You'll Do
+
+You'll update the `schedule` trigger in your workflow using gh-aw's fuzzy schedule syntax so GitHub Actions runs it at exactly the cadence you want. By the end, you'll know how to express any recurring schedule in plain English.
+
+## 📋 Before You Start
+
+- You have a working, manually tested workflow from [Test and Improve Your Workflow](12-test-and-iterate.md).
+- Your workflow file lives at `.github/workflows/daily-status.md`.
+
+## Steps
+
+### 1. Open your workflow file
+
+In your editor (or Codespace), open `.github/workflows/daily-status.md`.
+
+### 2. Locate the `on:` block
+
+You should already have a `schedule: daily` trigger and a `workflow_dispatch` trigger:
+
+```yaml
+on:
+  schedule: daily
+  workflow_dispatch: {}
+```
+
+### 3. Choose your schedule
+
+gh-aw accepts natural-language schedule expressions — no cron syntax needed. The `gh aw compile` command expands them into the correct cron expression automatically.
+
+| What you want | Fuzzy expression |
+|---------------|-----------------|
+| Once a day (midnight UTC) | `schedule: daily` |
+| Weekdays only | `schedule: daily on weekdays` |
+| Once a week | `schedule: weekly` |
+| Every hour | `schedule: hourly` |
+| Every six hours | `schedule: every 6 hours` |
+
+Pick the cadence that fits your team and update the `schedule:` line accordingly. For example, to run only on weekdays:
+
+```yaml
+on:
+  schedule: daily on weekdays
+  workflow_dispatch: {}
+```
+
+> [!TIP]
+> Keep `workflow_dispatch` in the file even after you go to production. It lets you re-run the report on demand without changing the schedule.
+
+### 4. Compile and validate
+
+After editing, compile the file to make sure the expression is recognised:
+
+```bash
+gh aw compile .github/workflows/daily-status.md --validate
+```
+
+You should see `✅ Compiled successfully`. The compiled `.yml` will contain the expanded cron expression — you don't need to write or maintain it by hand.
+
+### 5. Commit and push
+
+```bash
+git add .github/workflows/daily-status.md
+git commit -m "chore: schedule daily status workflow"
+git push
+```
+
+### 6. Confirm the schedule is registered
+
+Navigate to your repository on GitHub, then **Actions → daily-status**. On the right-hand sidebar you'll see a **This workflow has a schedule trigger** badge.
+
+![Scheduled workflow badge visible in the Actions sidebar](images/13-schedule-badge.png)
+
+> [!WARNING]
+> GitHub may delay the very first scheduled run by up to 15 minutes after you push. If the workflow doesn't fire at the expected time, check **Actions** for queued runs before assuming something is broken.
+
+### 7. Wait for or trigger a run
+
+You can wait for the next scheduled time, or click **Run workflow** → **Run workflow** to trigger it immediately and confirm everything still works.
+
+## ✅ Checkpoint
+
+- [ ] Your `on:` block contains both `workflow_dispatch` and a `schedule` fuzzy expression
+- [ ] The schedule expression reflects the cadence you actually want
+- [ ] `gh aw compile .github/workflows/daily-status.md --validate` reports no errors
+- [ ] You have pushed the change and can see the schedule badge in the Actions UI
+- [ ] At least one scheduled (or manual) run has completed successfully after the change
+
+**Next:** [What's Next? Keep Exploring](14-next-steps.md)

workshop/README.md

@@ -20,7 +20,7 @@ A hands-on workshop that takes you from zero to a fully automated, AI-powered da
 | 10 | [10-design-daily-status.md](10-design-daily-status.md) | Design: Your Daily Repo Status Report | ✅ |
 | 11 | [11-build-daily-status.md](11-build-daily-status.md) | Build: Daily Repo Status Workflow | ⏳ |
 | 12 | [12-test-and-iterate.md](12-test-and-iterate.md) | Test and Improve Your Workflow | ✅ |
-| 13 | [13-schedule-it.md](13-schedule-it.md) | Schedule It to Run Every Day | ⏳ |
+| 13 | [13-schedule-it.md](13-schedule-it.md) | Schedule It to Run Every Day | ✅ |
 | 14 | [14-next-steps.md](14-next-steps.md) | What's Next? Keep Exploring | ⏳ |
 
 ## Getting Started