Skip to content

[workshop-diagrams] Add theme-aware explanatory diagram for the agentic workflow iteration loop - #2599

Closed
github-actions[bot] wants to merge 1 commit into
mainfrom
add-09-iteration-loop-diagram-53d5cdc009526b15
Closed

[workshop-diagrams] Add theme-aware explanatory diagram for the agentic workflow iteration loop#2599
github-actions[bot] wants to merge 1 commit into
mainfrom
add-09-iteration-loop-diagram-53d5cdc009526b15

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Summary

This PR adds a light/dark SVG diagram pair illustrating the four-step agentic workflow iteration loop taught in workshop/09-agentic-editing.md and inserts it into the workshop file with a theme-aware <picture> block.

What changed

File Change
workshop/09-agentic-editing.md Inserted <picture> block before the "Start With One Concrete Observation" section with a two-sentence intro
workshop/images/09-iteration-loop-light.svg New light-theme diagram (1200×560)
workshop/images/09-iteration-loop-dark.svg New dark-theme diagram (1200×560)

What the diagram shows

The diagram illustrates the four-step loop:

  1. Observe — review run output in the Actions tab
  2. Edit — update the workflow brief or frontmatter (via /agentic-workflows skill)
  3. Compilegh aw compile + git push
  4. Trigger — dispatch a new run and compare against the previous one

The loop-back arrow is styled in GitHub Green with a dashed stroke, and an inline chip labels the /agentic-workflows edit | debug | optimize skill modes.

Why this helps learners

The prose currently describes the loop in multiple disconnected sections. A single diagram makes the repeating cycle immediately clear, anchors all four sections to a shared mental model, and reduces re-reading when learners follow the manual (terminal) path.

QA

  • scripts/check-svg-visual-language.js0 violations on both SVG files
  • Chromium headless render confirms both SVGs are non-blank (>25 KB screenshots)
  • Markdownlint — 0 issues on the updated step file
  • Both SVGs use role="img", aria-label, data-visual-kind="diagram", data-visual-id, and data-node attributes per brand skill requirements

Warning

Firewall blocked 7 domains

The following domains were blocked by the firewall during workflow execution:

  • accounts.google.com
  • awmgmcpg
  • clients2.google.com
  • redirector.gvt1.com
  • storage.googleapis.com
  • update.googleapis.com
  • www.google.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "accounts.google.com"
    - "awmgmcpg"
    - "clients2.google.com"
    - "redirector.gvt1.com"
    - "storage.googleapis.com"
    - "update.googleapis.com"
    - "www.google.com"

See Network Configuration for more information.

Generated by 🧠 Workshop Explanatory Diagram Generator · 75.1 AIC · ⌖ 8.13 AIC · ⊞ 6.8K ·

  • expires on Aug 13, 2026, 5:20 AM UTC

Adds a light/dark SVG pair illustrating the four-step agentic workflow
iteration loop (Observe → Edit → Compile → Trigger → repeat) introduced
in workshop/09-agentic-editing.md.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown
Contributor Author

This pull request was automatically closed because it expired on 2026-08-13T05:20:45.564Z.

Closed by Workflow

@github-actions github-actions Bot closed this Aug 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants