From 568af4432090a497e8c9512d5e63ecd19382675d Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 11 Aug 2026 05:07:46 +0000 Subject: [PATCH] Add theme-aware error-checks diagram to workshop/08b MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a new light/dark SVG pair that visualises the three quick checks learners should perform when a run does not look right: 1. Does the workflow appear in Actions? 2. Does the log show useful tool calls? 3. Did something change in GitHub? Each check has a Yes path (continue to the next check / reach the 'Run looks good' terminal) and a No path pointing to a concrete fix. Files added: workshop/images/08b-error-checks-light.svg workshop/images/08b-error-checks-dark.svg Markdown change: workshop/08b-interpret-your-run.md — inserted a block with a two-sentence introduction immediately before the prose checklist in the 'Check common error patterns first' section. SVGs pass check-svg-visual-language.js and markdownlint. Playwright confirms light currentSrc ends with -light.svg and dark currentSrc ends with -dark.svg; both images are 1200×560 and nonblank. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- workshop/08b-interpret-your-run.md | 8 +- workshop/images/08b-error-checks-dark.svg | 96 ++++++++++++++++++++++ workshop/images/08b-error-checks-light.svg | 96 ++++++++++++++++++++++ 3 files changed, 199 insertions(+), 1 deletion(-) create mode 100644 workshop/images/08b-error-checks-dark.svg create mode 100644 workshop/images/08b-error-checks-light.svg diff --git a/workshop/08b-interpret-your-run.md b/workshop/08b-interpret-your-run.md index e1ec9551..7fed0155 100644 --- a/workshop/08b-interpret-your-run.md +++ b/workshop/08b-interpret-your-run.md @@ -53,7 +53,13 @@ Then verify the real output in your repository. For **Daily Report Status**, tha ## Check common error patterns first -If your run does not look right, start with these quick checks before changing the workflow: +If your run does not look right, work through these three checks in order before changing anything in the workflow. + + + + + Three quick checks for a failed workflow run: check if the workflow appears in Actions, then if the log shows useful action, then if anything changed in GitHub + - **The workflow never appears in Actions** — confirm the workflow file is committed on `main`, then refresh. If you use the terminal path, run `gh aw compile` to catch [compile](https://github.github.com/gh-aw/reference/compilation-process/) errors. - **The log shows lots of thinking but no useful action** — your instructions may be too vague. Keep the run open, then refine the workflow body in a later step. diff --git a/workshop/images/08b-error-checks-dark.svg b/workshop/images/08b-error-checks-dark.svg new file mode 100644 index 00000000..c6926414 --- /dev/null +++ b/workshop/images/08b-error-checks-dark.svg @@ -0,0 +1,96 @@ + + + + + + + + + + + + + + + + + + + + + + Three Quick Checks for a Failing Run + Start here before editing your workflow + + + + Run doesn't look right + + + + + + + + 1 + Workflow appears in Actions? + Check workflow is committed on main + + + + Yes + + + + No + + Commit file to main + Run: gh aw compile + + + + + 2 + Log shows useful tool calls? + Thinking but no actions = vague brief + + + + Yes + + + + No + + Refine the brief + Be more specific about the task + + + + + 3 + Something changed in GitHub? + Verify issue, permissions, safe-output + + + + Yes + + ✓ Run looks good + Review output in repo + + + + No + + Check issue + permissions + Ensure workflow can write + + + Work top-to-bottom. Stop and fix at the first “No”. + + diff --git a/workshop/images/08b-error-checks-light.svg b/workshop/images/08b-error-checks-light.svg new file mode 100644 index 00000000..656628b7 --- /dev/null +++ b/workshop/images/08b-error-checks-light.svg @@ -0,0 +1,96 @@ + + + + + + + + + + + + + + + + + + + + + + Three Quick Checks for a Failing Run + Start here before editing your workflow + + + + Run doesn't look right + + + + + + + + 1 + Workflow appears in Actions? + Check workflow is committed on main + + + + Yes + + + + No + + Commit file to main + Run: gh aw compile + + + + + 2 + Log shows useful tool calls? + Thinking but no actions = vague brief + + + + Yes + + + + No + + Refine the brief + Be more specific about the task + + + + + 3 + Something changed in GitHub? + Verify issue, permissions, safe-output + + + + Yes + + ✓ Run looks good + Review output in repo + + + + No + + Check issue + permissions + Ensure workflow can write + + + Work top-to-bottom. Stop and fix at the first “No”. + +