docs: update debugging guides with copy-paste agent prompt templates

[Copilot]

Debugging guides were sparse and inconsistent — none reliably surfaced the agentic-workflows agent + run URL as the primary debugging path, and none provided a ready-to-copy prompt template.

Changes

troubleshooting/common-issues.md

Rewrote the one-liner "How Do I Debug a Failing Workflow?" into a full section with two ready-to-copy templates and a > [!TIP] callout:

# Copilot Chat
/agent agentic-workflows debug https://github.com/OWNER/REPO/actions/runs/RUN_ID

# Any AI agent (self-contained)
Debug this workflow run using https://raw.githubusercontent.com/github/gh-aw/main/debug.md
The failed workflow run is at https://github.com/OWNER/REPO/actions/runs/RUN_ID

guides/agentic-authoring.mdx

Added a > [!TIP] callout after the Copilot Chat example. Updated the self-contained prompt wording to match the issue triage template (The failed workflow run is at … instead of Run URL: …).

reference/custom-agent-for-aw.mdx

Added a > [!TIP] callout inside "Debugging Agentic Workflows" after the run-URL examples. Applied the same self-contained prompt wording fix.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• telemetry.astro.build
  • Triggering command: /opt/hostedtoolcache/node/24.14.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Update the debugging guides to always suggest using the agentic-workflows.agent.md and the run url to prompt an agent to debug an issue. Provide the prompt template as a tip that people can copy paste.

See template used in the issue triage description when an error occurs.

Custom agent used: technical-doc-writer
AI technical documentation writer for GitHub Actions library using GitHub Docs voice

---

💬 Send tasks to Copilot coding agent from Slack and Teams to turn conversations into code. Copilot posts an update in your thread when it's finished.

[Copilot]

Pull request overview

Updates the debugging documentation to consistently recommend using the agentic-workflows agent with a GitHub Actions run URL, and adds copy/paste-ready prompt templates and TIP callouts.

Changes:

• Expanded “How Do I Debug a Failing Workflow?” into a fuller section with Copilot Chat + self-contained templates.
• Added TIP callouts and standardized self-contained prompt wording in authoring/reference docs.
• Added two new workflow entries to the agent factory status table.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File	Description
docs/src/content/docs/troubleshooting/common-issues.md	Adds an agent-first debugging section with copy/paste templates and a TIP callout.
docs/src/content/docs/guides/agentic-authoring.mdx	Adds a TIP callout and updates the self-contained debugging template wording.
docs/src/content/docs/reference/custom-agent-for-aw.mdx	Adds a TIP callout for run-URL usage and updates self-contained template wording.
docs/src/content/docs/agent-factory-status.mdx	Adds rows for “Daily Safe Output Integrator” and “Update Astro”.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.