GitHub Agentic Workflows Files

🌟 Release Highlights

This release focuses on reliability and developer experience — fixing schema validation gaps, hardening the upgrade flow, improving failure diagnostics, and expanding cross-repo workflow capabilities.

✨ What's New

• Cross-repo workflow_call runtime imports — Workflows invoked via workflow_call from another repository now correctly check out the callee's .md files at runtime, eliminating ERR_SYSTEM: Runtime import file not found errors in cross-repo reuse scenarios. Includes a secrets: inherit support for reusable workflow call jobs. (#20301)

• Auto-upgrade on gh aw upgrade — gh aw upgrade now automatically installs the latest extension version before compiling lock files, then relaunches the new binary transparently. Lock files no longer embed a stale version string after upgrading. (#20300)

• Richer failure issue diagnostics — Agent failure issues now include a universal copy-pasteable debug prompt for any coding agent (Copilot, Claude, Gemini, etc.), plus a new top-level debug.md entry point. A new report-failure-as-issue: false frontmatter option lets you suppress failure issue creation per-workflow. Dedicated 📦 Patch Size Exceeded sections appear when max-patch-size limits are hit. (#20266, #20354)

• CLI flag consistency — Four commands gained missing flags to align with the rest of the CLI: gh aw run --json, gh aw audit --repo, gh aw new --engine, and gh aw list --dir. (#20272)

• Non-agent job concurrency defaults — Non-agent job concurrency groups now default cancel-in-progress: false, preventing accidental cancellation of setup or cleanup jobs during rapid pushes. (#20224)

🐛 Bug Fixes & Improvements

• max-patch-size schema fix — The tools.repo-memory JSON schema was missing the max-patch-size property, causing schema validation to reject valid frontmatter before compilation could process it. (#20309)

• pull_request_target as PR context — create_pull_request_review_comment and target: "triggering" now correctly recognize pull_request_target events as valid PR context, fixing Not in pull request context errors. (#20268)

• gh aw audit no longer crashes on non-zip artifacts — Docker build artifacts and other non-zip formats are now skipped gracefully instead of aborting the entire audit report. (#20294)

• Improved Docker validation error messages — Docker-related validation failures now surface actionable guidance instead of opaque internal errors. (#20350)

📚 Documentation

• Staged mode reference page — A dedicated reference/staged-mode page covers enabling staged mode globally or per output type, the 🎭 preview format, per-type support table, and the recommended staged → review → enable adoption pattern. (#20269)

• Debugging prompts in authoring guides — Self-contained and Copilot-specific debugging prompts have been added to the authoring guides and debug.md to help diagnose workflow failures faster. (#20349)

🌍 Community Contributions

A huge thank you to the community members who reported issues that were resolved in this release:

• @mnkiefer for [research] Overview of docs improver agents (#19836)

For complete details, see CHANGELOG.

Generated by Release

What's Changed

• chore: clarify org permissions in docs by @mnkiefer in https://github.com/github/gh-aw/pull/20260
• Default cancel-in-progress: false for non-agent job concurrency groups by @Copilot in https://github.com/github/gh-aw/pull/20224
• [log] Add debug logging to artifact manager, update command, and MCP config utils by @github-actions[bot] in https://github.com/github/gh-aw/pull/20261
• [code-simplifier] refactor: combine PR expires tests into table-driven test by @github-actions[bot] in https://github.com/github/gh-aw/pull/20253
• [docs] Self-healing documentation fixes from issue analysis - 2026-03-09 by @github-actions[bot] in https://github.com/github/gh-aw/pull/20254
• docs: add dedicated staged mode documentation page for safe outputs by @Copilot in https://github.com/github/gh-aw/pull/20269
• fix(safe-outputs): treat pull_request_target as valid PR context in create_pull_request_review_comment by @Copilot in https://github.com/github/gh-aw/pull/20268
• Improve failure issue actionability with generic debug prompt and report-failure-as-issue option by @Copilot in https://github.com/github/gh-aw/pull/20266
• Fix schema/validation mismatch: add "public" to repos enum in guard-policies by @Copilot in https://github.com/github/gh-aw/pull/20281
• fix: move permission computation to dedicated safe_outputs_permissions.go by @Copilot in https://github.com/github/gh-aw/pull/20270
• Add missing flags to run, audit, new, and list commands for CLI consistency by @Copilot in https://github.com/github/gh-aw/pull/20272
• fix(audit): gracefully skip non-zip artifacts instead of crashing by @Copilot in https://github.com/github/gh-aw/pull/20294
• fix(step-names): standardize "Install dev dependencies" → "Install development dependencies" and "Install uv" → "Setup uv" by @Copilot in https://github.com/github/gh-aw/pull/20295
• refactor: split safe_outputs_generation.go (1549 lines) into focused modules by @Copilot in https://github.com/github/gh-aw/pull/20296
• [docs] Update documentation for features from 2026-03-10 by @github-actions[bot] in https://github.com/github/gh-aw/pull/20306
• fix: auto-upgrade gh-aw extension during gh aw upgrade to prevent stale version in lock files by @Copilot in https://github.com/github/gh-aw/pull/20300
• Fix: max-patch-size missing from tools.repo-memory JSON schema by @Copilot in https://github.com/github/gh-aw/pull/20309
• [fp-enhancer] Improve pkg/cli: replace bubble sort, use sliceutil.Map, migrate to slices package by @github-actions[bot] in https://github.com/github/gh-aw/pull/20323
• [docs] Update glossary - daily scan by @github-actions[bot] in https://github.com/github/gh-aw/pull/20328
• feat: fix runtime-import in cross-repo workflow_call by detecting callee repository at checkout by @Copilot in https://github.com/github/gh-aw/pull/20301
• Improve Docker validation error messages to be actionable by @Copilot in https://github.com/github/gh-aw/pull/20350
• docs: add self-contained and Copilot debugging prompts to authoring guides and debug.md by @Copilot in https://github.com/github/gh-aw/pull/20349
• fix(daily-code-metrics): increase max-patch-size to prevent push_repo_memory failures by @Copilot in https://github.com/github/gh-aw/pull/20353
• Add dedicated error messages for max patch size failures in agent failure issues by @Copilot in https://github.com/github/gh-aw/pull/20354

Full Changelog: https://github.com/github/gh-aw/compare/v0.57.0...v0.57.1