diff --git a/docs/src/content/docs/troubleshooting/errors.md b/docs/src/content/docs/troubleshooting/errors.md index f0748939de8..fc371d2de0d 100644 --- a/docs/src/content/docs/troubleshooting/errors.md +++ b/docs/src/content/docs/troubleshooting/errors.md @@ -359,4 +359,11 @@ 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. 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