Repository navigation
Releases: githubnext/gh-aw-workshop
Release list
v0.3.5
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
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-pageview 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.allowedsyntax in runner infrastructure side quest (#2405) - Link
--watchguidance to official CLI documentation (#2404) - Clarify
gh aw forecastside 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.allowedlist 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
Highlights
- Added GitHub brand skill for applying GitHub-inspired brand guidance to workshop experiences
Changes since v0.3.2
- Add
github-workshop-brandCopilot 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.allowedlist 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
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
ghCLI 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.allowedlist 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
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.allowedlist 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
Highlights
- Codespaces is now the sole core workshop route, with curl as the primary
gh-awinstall 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 logssyntax 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
--validateflag fromgh aw compileinstructions 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-labelssafe-output key in PR labeler side quest - Used
gh aw validatein 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.allowedlist 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
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-diagramsworkflow crash in state-gathering step (#1878) - Fix heredoc alignment in workshop UI screenshot workflow image-scan step (#1888)
- Recompile
workshop-ui-screenshotslockfile 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 awCLI glossary wording in environment reference side quest (#1844) - Classify install-gh terminal pages as non-learning (#1857)
- Exempt
learning:falsedispatcher 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.allowedlist 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
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.allowedlist 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
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-workflowsskill - 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 --validatewithgh aw compile; fixed workshop-student-simulator profile caching; removed bannedSee Alsosections - 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 forecastinto 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.allowedlist 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
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
--validateand--no-emitdescriptions 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
--validateflag 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