From 7c9723b715fe89fb196452c22701b6170cec052d Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 13 May 2026 09:35:24 +0000 Subject: [PATCH 1/3] Initial plan From 37f91c96d02510d3b31fd9104fec7510234cefb2 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 13 May 2026 09:46:14 +0000 Subject: [PATCH 2/3] docs: convert getting help sentence to numbered steps Agent-Logs-Url: https://github.com/github/gh-aw/sessions/b131c6fe-3758-40a4-b6b9-f14dbcb00481 Co-authored-by: gh-aw-bot <259018956+gh-aw-bot@users.noreply.github.com> --- docs/src/content/docs/troubleshooting/errors.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/troubleshooting/errors.md b/docs/src/content/docs/troubleshooting/errors.md index f0748939de8..b231edb1166 100644 --- a/docs/src/content/docs/troubleshooting/errors.md +++ b/docs/src/content/docs/troubleshooting/errors.md @@ -359,4 +359,10 @@ Remove `read-only: false` or change it to `read-only: true` (the default). Write ## Getting Help -If you encounter an error not documented here, search this page (Ctrl+F / Cmd+F) for keywords, review workflow examples in the documentation, enable verbose mode with `gh aw compile --verbose`, or [report issues on GitHub](https://github.com/github/gh-aw/issues). See [Common Issues](/gh-aw/troubleshooting/common-issues/) for additional help. +If you encounter an error not documented here: + +1. Enable verbose mode for details: `gh aw compile --verbose` +2. Search this page (Ctrl+F / Cmd+F) for keywords from the error message +3. Review [workflow examples](/gh-aw/examples/) in the documentation +4. Check [Common Issues](/gh-aw/troubleshooting/common-issues/) for additional guidance +5. [Report the issue on GitHub](https://github.com/github/gh-aw/issues) if it is not documented From c392cd99fab1363b626c299604fd449c116d03e4 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 13 May 2026 09:58:16 +0000 Subject: [PATCH 3/3] docs: add debug.md agent guidance in errors help Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- docs/src/content/docs/troubleshooting/errors.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/src/content/docs/troubleshooting/errors.md b/docs/src/content/docs/troubleshooting/errors.md index b231edb1166..fc371d2de0d 100644 --- a/docs/src/content/docs/troubleshooting/errors.md +++ b/docs/src/content/docs/troubleshooting/errors.md @@ -363,6 +363,7 @@ If you encounter an error not documented here: 1. Enable verbose mode for details: `gh aw compile --verbose` 2. Search this page (Ctrl+F / Cmd+F) for keywords from the error message -3. Review [workflow examples](/gh-aw/examples/) in the documentation -4. Check [Common Issues](/gh-aw/troubleshooting/common-issues/) for additional guidance -5. [Report the issue on GitHub](https://github.com/github/gh-aw/issues) if it is not documented +3. Use an agent with the [debug.md prompt](https://raw.githubusercontent.com/github/gh-aw/main/debug.md) to investigate failing workflow runs +4. Review [workflow examples](/gh-aw/examples/issue-pr-events/) in the documentation +5. Check [Common Issues](/gh-aw/troubleshooting/common-issues/) for additional guidance +6. [Report the issue on GitHub](https://github.com/github/gh-aw/issues) if it is not documented