Skip to content

Releases: githubnext/gh-aw-workshop

v0.3.5

Choose a tag to compare

@github-actions github-actions released this 04 Oct 08:11
3e83cb0

Highlights

  • Added new workshop content: Step 29 on teaching agents domain knowledge with Skills, and side quests on skill injection strategies, A/B round-robin experiments, repo poisoning, and the agentic-workflows skill dispatcher.
  • Expanded theme-aware (light/dark) diagrams across many steps, including preflight troubleshooting, cache-memory loops, runner label dispatch, audit lifecycle, permission-error decisions, MCP agent loop, and PR reviewer architecture.
  • Brand and accessibility pass: migrated multiple workshop SVGs to the GitHub brand palette and fixed several color-contrast violations.
  • Consistency fix across dozens of files: standardized Checkpoint headings to use the :white_check_mark: shortcode instead of raw Unicode checkmarks.
  • Numerous workshop readability and UX improvements: wider markdown body on large desktops, fixed page gutters and touch target sizing, wrapped long code lines, and clarified gh-aw permission, environment, and init-behavior guidance.
  • Ongoing "add gh-aw doc links" passes threading official documentation references throughout the workshop.

Changes since v0.3.4

  • Diagram and SVG fixes: architecture clarifications, contrast fixes, brand-palette migrations, and new theme-aware diagrams for steps 07d, 08b, 14, 17, 20–25, and 27 (#2449, #2456, #2458, #2460, #2554, #2559, #2588, #2668, #2711, #2730, #2799, #2826, #2841, #2860, #2874, #2893, #3053, #3145, #3285)
  • Checkpoint heading consistency fixes replacing raw Unicode ✅ with the :white_check_mark: shortcode (#2553, #2665, #2716, #2728, #2748, #2763, #2775, #2788, #2797)
  • New workshop content: Step 29 on Skills (#2657), skill injection strategies side quest (#2836), A/B round-robin deep-dive (#2867), repo poisoning improvements (#2729, side-quest-17-07 #2827), agentic-workflows skill dispatcher primer (#3080), failure-modes primer extraction (#2949)
  • Workshop documentation link passes adding gh-aw doc references across many files (#2468, #2483, #2555, #2669, #2718, #2734, #2802, #2815, #2828, #2875, #2895, #2937, #3068, #3434, #3641, #3689, #3970)
  • Guideline violation cleanups across batches of files (#2479, #2538, #2574, #2642, #3677, #3882)
  • UX and accessibility fixes: workshop page gutters and touch targets (#2490), wide-code-line wrapping (#2674), wider markdown body on desktop (#2712), image width cap increase (#2721)
  • Content clarity and correctness fixes: safe-outputs array syntax (#2489), second-person voice in data-ops checkpoints (#2492), note-style security callout (#2491), permission-error alert downgrade (#2593), broken OpenAI links (#2592), ordered list numbering (#2659), bare code fence language labels (#2658), environment reference clarity (#2840), credential guidance (#7b05e68 / #2868), gh aw init behavior sync (#3111), workflow_dispatch reference link (#6b7ce60 / #4047), gh aw add access model and private:true docs (#4167), research node source URLs (#8435280 / #3177), broken gh-aw overview anchor (#4ec6259 / #3070), Markdown emphasis lint fix (#3985)
  • Infrastructure: upgraded agentic workflows with prerelease auto-upgrades enabled and switched to GitHub.com artifact actions (#2935, #2936)
  • Golden Ticket and README updates: added welcome callout, removed duplicate callout, added demo environment request notes for facilitators
  • Workshop reader typography refresh (#4176)

Generated by 📦 Manual SemVer Release · copilot · auto · 12.6 AIC · ⌖ 5.53 AIC · ⊞ 6.6K

v0.3.4

Choose a tag to compare

@github-actions github-actions released this 02 Aug 10:33
d250398

Highlights

  • Added workshop step 28: Orchestrate Multiple Agentic Workflows
  • New theme-aware SVG diagrams for sandbox boundaries, security layers, and key terms
  • Accessibility improvements: raised touch targets, text contrast fixes, and mobile viewport fixes

Changes since v0.3.3

  • feat: add workshop step 28 — Orchestrate Multiple Agentic Workflows (#2414)
  • Add theme-aware SVG pair for sandbox boundary diagram (#2418)
  • Add theme-aware explanatory diagram for three key terms (#2416)
  • Add theme-aware security layers diagram for step 05b (#2435)
  • Raise mobile docs gutter and menu toggle touch target (#2399)
  • Raise workshop header and code-copy controls to 44px interactive targets (#2430)
  • Raise two light-theme label colors in 05b security layers SVG to meet WCAG contrast (#2443)
  • Raise text contrast in 05-three-terms-light.svg (#2428)
  • Apply GitHub brand guidance to visual workflows and SVG validation (#2389)
  • Restore brand-compliant page gutters for workshop SPA content (#2444)
  • fix: prevent code block viewport overflow at 360px mobile (#2445)
  • Prevent duplicate workshop-page view transitions during hash navigation (#2386)
  • Disable workshop page transition animation (#2395)
  • Fix workshop page annotation order (#2393)
  • Fix side-menu completed marker escape sequence (#2448)
  • Fix broken GitHub Actions docs link in enterprise side-quest guidance (#2447)
  • fix: replace compile --validate with compile in side-quest-11-06 (#2433)
  • Correct audit reference network and parse guidance (#2403)
  • Correct network.allowed syntax in runner infrastructure side quest (#2405)
  • Link --watch guidance to official CLI documentation (#2404)
  • Clarify gh aw forecast side quest docs (#2429)
  • workshop docs: add gh-aw doc links (rounds 5, 14, and more) (#2397, #2419, #2439)
  • trim redundant doc_url_map schema example from workshop-sync-check (#2388)
  • Remove redundant Safe Outputs table from guidelines-enforcer (#2413)
  • [WIP] Remove Objectives block and fix Phase 1 numbering in q.md (#2446)

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

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

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 📦 Manual SemVer Release · 11.5 AIC · ⌖ 7.41 AIC · ⊞ 4.5K

v0.3.3

Choose a tag to compare

@github-actions github-actions released this 30 Jul 20:07

Highlights

  • Added GitHub brand skill for applying GitHub-inspired brand guidance to workshop experiences

Changes since v0.3.2

  • Add github-workshop-brand Copilot skill with visual, editorial, accessibility, and trademark rules for workshop surfaces (8377e2a)

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

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

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 📦 Manual SemVer Release · 10 AIC · ⌖ 4.87 AIC · ⊞ 4.5K

v0.3.2

Choose a tag to compare

@github-actions github-actions released this 29 Jul 09:19
ecf6417

Highlights

  • Added CSS View Transitions, a victory banner on full checkpoint completion, and a micro progress bar in the sidebar for a smoother workshop navigation experience
  • New theme-aware diagrams and light/dark image variants across workshop steps 01–14 and side quests
  • GitHub emoji (GFM shortcodes) and Primer octicon SVGs now render correctly in docs
  • New side quest: Self-Hosted Runner Infrastructure Deep Dive
  • New training plan step: Step 27 for eval-driven workflow quality verification
  • YAML and Markdown code blocks now render with editor chrome and syntax highlighting

Changes since v0.3.1

  • Polished checkpoint UI: clearer checkbox markers, non-interactive pre-checkpoint checkboxes, scoped checkpoint tracker, and improved visual chrome (#2225, #2232, #2243, #2249, #2250, #2253)
  • Added CSS View Transitions and victory banner for page navigation (#2233, #2231)
  • Added micro progress bar to sidebar menu items (#2228)
  • YAML/Markdown editor chrome and syntax highlighting for code blocks (#2169, #2175, #2230)
  • GitHub emoji GFM rendering and Primer octicon checkmarks (#2296, #2300)
  • Added light/dark SVG image variants for steps 01–14 and side quests (#2236, #2239, #2288)
  • New theme-aware diagrams (two-file structure, install troubleshooting) (#2221, #2288)
  • New side quest: Self-Hosted Runner Infrastructure Deep Dive (#2321)
  • Added Step 27 (eval-driven workflow quality) to training plan (#2304)
  • Split side-quest-05-02 into two focused pages; refactored Step 05 intro (#2319, #2223)
  • Replaced native emoji with GitHub colon-syntax shortcodes across workshop and templates (#2305, #2322)
  • Fixed broken links across workshop steps and side quests (#2177, #2180, #2256, #2278, #2310)
  • Fixed safe-outputs key names (add-comment) in examples (#2176, #2182)
  • Fixed checkpoint counts and alert levels in side quests to comply with guidelines (#2172, #2173, #2189, #2262)
  • Added prompt simplicity guidance and preferred markdown frontmatter examples to guidelines (#2201, #2210)
  • Replaced gh CLI reads with GitHub MCP tools in workshop-builder (#2202)
  • Aligned multiple workshop steps with present-tense active voice guidelines (#2216–#2220)
  • Corrected permission and frontmatter examples (#2187, #2293, #2294)
  • Refactored build-docs.js into focused lib modules (#2235)
  • Added gh-aw doc links (rounds 8, 9, 10) (#2238, #2289, #2320)
  • Open hash-targeted <details> elements on SPA navigation (#2303)
  • Updated demo environment link for facilitators

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

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

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 📦 Manual SemVer Release · 12.2 AIC · ⌖ 5.09 AIC · ⊞ 4.5K

v0.3.1

Choose a tag to compare

@github-actions github-actions released this 26 Jul 18:56
edaa90f

Highlights

  • Interactive checkboxes with progress tracking — Checkpoint lists now render as clickable checkboxes with localStorage persistence and per-page progress indicators, replacing static bullet+checkbox controls.
  • Markdown editor chrome — Code fences and markdown content now render with an editor-style chrome UI, and the markdown body is constrained to 650px width for improved reading comfort.
  • Theme-aware SVG screenshots — Three workshop terminal images and the side-quest-05 hybrid pattern diagram now adapt to light/dark themes.

Changes since v0.3.0

  • Add image text legibility guidance (#2132)
  • Render checkpoint lists as ✓ markers instead of bullet+checkbox controls (#2136)
  • Add theme-aware SVG screenshots for 3 workshop terminal images (#2133)
  • Add theme-aware hybrid pattern diagram to side-quest-05-01 (#2131)
  • Add gh-aw doc links to side-quest-11 files (#2137)
  • Add markdown editor chrome and reduce content margins (#2146)
  • Clickable checkboxes with localStorage persistence and per-page progress tracking (#2147)
  • Render md code fences with markdown-editor-block chrome (#2148)
  • Use ○ for pending checkmarks to distinguish from completed ✓ (#2155)
  • Add guideline: at most 10 checkboxes per page (#2156)
  • Style: constrain markdown-body to 650px width, centered for reading comfort (#2161)
  • Align side-quest Anthropic key guide with callout and CLI validation guidelines (#2159)
  • Remove numbered section headers in side quest frontmatter walkthrough (#2158)
  • Fix correct validation command in side-quest-11-07-openai-key.md (#2160)
  • Fix broken anchor links in workshop files (#2141)
  • Fix broken URL in README (#2162)

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

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

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 📦 Manual SemVer Release · 11 AIC · ⌖ 7.44 AIC · ⊞ 4.5K

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 26 Jul 04:17
8b04f03

Highlights

  • Codespaces is now the sole core workshop route, with curl as the primary gh-aw install path
  • All workshop prompt surfaces unified to use Copilot CLI instead of Chat/Agents tab
  • New theme-aware SVG diagrams throughout (architecture, sub-agents, resilience, conditional logic, local setup, A/B experiments)
  • Copy button and syntax highlighting added to code blocks; terminal UI wrapper for shell and output blocks
  • Light/dark theme chooser added to workshop docs menu
  • Step 7 merged into a single unified "Write Your First Agentic Workflow" step; steps 9 and 6 also consolidated
  • New Step 14b PR reviewer workshop activity rebuilt around agents and skills
  • Side Quest 15-02 added (weekend-skip exercise extracted from step 15)
  • Accessibility improvements: heading anchor focus indicator, image inspector alt text
  • Responsive navigation fixes for small and medium viewports

Changes since v0.2.1

  • Corrected gh aw logs syntax in cost-estimation step
  • Fixed heredoc parsing failure in workshop-ui-screenshots scan step
  • Split step 05 into concept (intro) and practice (security) pages
  • Recompiled agentic workflows with gh-aw v0.82.13
  • Added gh-aw doc links across 10+ workshop steps (rounds 2–9)
  • Fixed orphaned checkpoint items, heading levels, and navigation order across multiple steps
  • Updated README to reflect new curriculum structure
  • Added rescue-lane recovery block to step 05 checkpoint
  • Added token and cost optimization activity to Step 26
  • Removed --validate flag from gh aw compile instructions throughout
  • Moved PR reviewer workflow to step 14b
  • Removed mentions of phones and tablets from docs and simulator
  • Shifted step 7a workflow authoring to Copilot prompts
  • Fixed git add commands to use git add . across the workshop
  • Removed duplicate cache-memory task brief; replaced with cross-reference
  • Corrected jailbreak brief network field and threat-detection guidance
  • Updated safe-output debugging guidance to match current gh-aw log wording
  • Fixed add-labels-to-pull-request → add-labels safe-output key in PR labeler side quest
  • Used gh aw validate in API key side quests
  • Added facilitator demo environment notice
  • Added themed README images (light/dark variants)
  • Tightened pain-points section in workshop-student-simulator
  • Removed numbered step headers from agent brief side quest

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

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

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 📦 Manual SemVer Release · 14.6 AIC · ⌖ 7.51 AIC · ⊞ 4.5K

v0.2.1

Choose a tag to compare

@github-actions github-actions released this 23 Jul 11:51
1919d43

Highlights

  • Added documentation links to gh-aw reference pages throughout workshop steps and side quests (batches 3–5)
  • Fixed broken workshop links and restored the missing browser-path Step 6c page
  • Improved student simulator reliability: browser path, model-access gate, active learning, and updated workshop mappings
  • Closed Step 8 dropout wall with pre-flight checks, recompiled steps, and new active exercises
  • Added theme-aware SVG diagrams for step-to-agent data flow

Changes since v0.2.0

  • Add gh-aw doc links to workshop steps (batches 3, 4, 5) and side-quest files (#1826, #1840, #1849, #1891)
  • Fix broken workshop links and restore missing browser-path Step 6c page (#1842)
  • Fix Step 8 dropout wall: pre-flight checks, recompile steps, new exercises (#1877)
  • Fix sequential navigation across advanced workshop steps 18–24 (#1872)
  • Workshop simulation repairs: browser path, model-access gate, active learning (#1814)
  • Refresh simulator mappings for current workshop pages (#1818, #1858)
  • Add Vandendorpe-style Greeks to Monte Carlo student simulator (#1815)
  • Remove unsupported phone and tablet student profiles (#1862)
  • Add guidelines for golden-ticket workshop surfaces and maintenance (#1835)
  • Add theme-aware SVG pair for step-to-agent data-flow diagram (#1886)
  • Optimize hero image and add optimize-images.py script (#1847)
  • Fix workshop-explanatory-diagrams workflow crash in state-gathering step (#1878)
  • Fix heredoc alignment in workshop UI screenshot workflow image-scan step (#1888)
  • Recompile workshop-ui-screenshots lockfile to restore md/lock sync (#1843)
  • Remove duplicated theme-aware picture snippet from explanatory-diagrams workflow (#1841)
  • Fix mobile navigation width constraint (#1881)
  • Correct gh aw CLI glossary wording in environment reference side quest (#1844)
  • Classify install-gh terminal pages as non-learning (#1857)
  • Exempt learning:false dispatcher pages from checkpoint enforcement (#1846)
  • Add gh auth status check and fix checkpoint accuracy in step 02a (#1829)
  • Change image syntax from markdown to HTML (7653bb2)

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

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

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 📦 Manual SemVer Release · 11.4 AIC · ⌖ 4.98 AIC · ⊞ 4.5K

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 21 Jul 12:41
fd7a29c

Highlights

  • Navigation buttons are now rendered in a central column with primary/secondary styles and support for multiple next links
  • Workshop setup instructions streamlined: GitHub UI installation path removed, Codespace usage clarified, and prerequisites updated
  • Student simulation is now content-aware and hybrid, reducing dropout friction
  • New scheduled cleanup workflow removes stale copilot/* branches automatically
  • Rendered docs now include a footer with a GitHub repo link

Changes since v0.1.11

  • Clarify prerequisites for setup and update Copilot access instructions
  • Fix link format for account creation in prerequisites
  • Streamline setup instructions and clarify Codespace usage
  • Encode and enforce workshop **Next:** link format (#1768)
  • Render nav buttons in central column with primary/secondary styles and multi-next support (#1769)
  • Remove redundant convergence note in installation guide
  • Remove GitHub UI installation guide and update navigation links
  • Remove comparison section between Classic Actions and Agentic Workflows
  • Remove GitHub UI path instructions from prerequisites
  • Fix fallback installer URL for gh-aw installation
  • Fix images
  • Fix SPA heading hierarchy in generated workshop docs (#1803)
  • Address top workshop simulation dropout barriers (#1805)
  • Enhance safety explanation for agentic workflows with sandbox and guardrails
  • Add scheduled cleanup workflow for stale copilot/* branches (#1810)
  • Clarify provider scope in prerequisites and keep tutorial Copilot-focused (#1809)
  • Make student simulation content-aware and hybrid (#1811)
  • Add footer with GitHub repo link and "made by github" to rendered docs (#1812)

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

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

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 📦 Manual SemVer Release · 10.7 AIC · ⌖ 4.98 AIC · ⊞ 4.5K

v0.1.11

Choose a tag to compare

@github-actions github-actions released this 21 Jul 04:24
8ae26e9

Highlights

  • Added a GitHub Pages docs site for the workshop with improved rendering (GFM alerts, clickable anchors, collapsible pages, underlined links)
  • Replaced journey/adventure YAML frontmatter with XML comment annotations
  • Added new Step 09 covering agentic editing with the agentic-workflows skill
  • Removed the unusable GitHub UI workflow path (Step 7b)
  • Renamed Adventure A/B to Adventure Codespace/Adventure Local for clarity
  • Added event provisioning examples and guidelines for workshop assets
  • Hardened Workshop Builder to always emit a safe output (noop fallback)

Changes since v0.1.10

  • Workshop content: Added and refined steps 07–09, 12, 14, 22, 25, 26; streamlined welcome and prerequisites; removed numbered prefixes from page titles and link text
  • Docs site: New GitHub Pages deploy workflow; GFM checkbox/alert/anchor rendering; <details>-based single-page layout; internal link resolution improvements
  • Documentation links: Multiple rounds (batches 4–8) of gh-aw doc link additions and broken-link fixes across workshop and side-quest files
  • SVG diagrams: Added diagrams for Copilot billing path, billing dashboard, agent execution loop, and step-to-agent data-flow pattern
  • Workflow fixes: Recompiled stale lock files; replaced gh aw compile --validate with gh aw compile; fixed workshop-student-simulator profile caching; removed banned See Also sections
  • Billing / costs step: Added new workshop node for managing costs and AI credit budgets
  • Codespace setup: Added diagnostic checks for Codespace and local terminal setups
  • Side quests: Fixed broken links, replaced dead URLs, extracted gh aw forecast into its own side quest, fixed invalid frontmatter syntax examples

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

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

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 📦 Manual SemVer Release · 11.1 AIC · ⌖ 4.99 AIC · ⊞ 4.5K

v0.1.10

Choose a tag to compare

@github-actions github-actions released this 17 Jul 09:22
2f5b89e

Highlights

  • New Audit and Monitor Your Agentic Workflows workshop node to help learners track and govern their workflows.
  • New Repository Poisoning via Agentic Write Access security side quest.
  • Added an explanatory SVG diagram for the Copilot agent session flow.
  • Added a ready-for-review AW accuracy reviewer workflow.
  • Improved beginner experience: reduced cognitive load in Steps 2, 5, and 16; surfaced Copilot model access verification in Step 1 to prevent Step 7 failures.
  • Extended frontmatter coverage with a new Part C covering token/usage metadata.

Changes since v0.1.9

  • Add plan-selection column, terminal orientation, and plan-check checkpoint to Step 2 Codespace setup (#1333)
  • Add GitHub beginners link to docs-linker workflow (#1340)
  • Prepare model access before the first workflow run (#1342)
  • Remove redundant static URL table from docs-linker workflow (#1344)
  • Add mandatory compile checkpoint gate in Step 13 (Schedule It) (#1349)
  • Reduce deployment-prerequisite cognitive overload for beginner learners in Step 5 (#1351)
  • Surface Copilot model access verification in Step 1 to prevent Step 7 access failures (#1350)
  • Add gh-aw doc links to workshop steps 07a–08b (#1352)
  • Add concept-check exercise and advanced-developer orientation to Step 5 (#1359)
  • Reduce cognitive load in Step 16 data-source workshop content (#1377)
  • Remove broken gh-aw doc links in codespaces-actions-write side quest (#1384)
  • Correct --validate and --no-emit descriptions in compile side quest (#1385)
  • Add workshop node: Audit and Monitor Your Agentic Workflows (#1371)
  • Fix temporary ID length in workshop simulation parent (#1388)
  • Remove --validate flag and add enterprise MCP guidance in step 17 (#1400)
  • Add explanatory SVG diagram for Copilot agent session flow (#1401)
  • Add security side quest: Repository Poisoning via Agentic Write Access (#1404)
  • Reduce concept density in frontmatter Part B, add Part C for token/usage metadata (#1405)
  • Add ready-for-review AW accuracy reviewer workflow (#1411)

Generated by 📦 Manual SemVer Release · 11 AIC · ⌖ 5.64 AIC · ⊞ 4.4K