[side-quest] Add side quest: Diagnosing Common Agent Output Patterns

[github-actions]

Caution

Protected files were modified in this change.
This pull request is in request_review mode and requires explicit human scrutiny before merge.

Protected files: README.md

What was mined

Source file: workshop/09-understand-output.md (Step 9: Reading Workflow Output)

The original "Step 4: Common Output Patterns (and What They Mean)" section contained a five-row reference table explaining common log patterns, their causes, and suggested fixes. While useful, it felt like a troubleshooting detour inside a step primarily focused on reading and interpreting normal output.

What was extracted

New file: workshop/side-quest-debug-output.md — Side Quest: Diagnosing Common Agent Output Patterns

The side quest expands each of the five patterns into a full section with:

• A concrete example log snippet showing the pattern in context
• A plain-English explanation of the root cause
• A specific, actionable fix

It also adds a "Quick Log Anatomy Refresher" table and a numbered debugging checklist learners can work through when a run behaves unexpectedly.

How routing was updated

• Step 9 (09-understand-output.md): Step 4 is now a compact quick-reference table plus an > [!TIP] callout with a clearly optional link to the side quest.
• Side quest: closes with a "Return to the main adventure" link back to Step 9.
• workshop/README.md: new entry added under Optional Side Quests, noting it branches from Step 9.

Generated by 🗺️ Side Quest · 50.3 AIC · ⌖ 8.92 AIC · ⊞ 5.6K · ◷

---

Note

This was originally intended as a pull request, but the git push operation failed.

Original error: pushSignedCommits: refusing unsigned push for branch 'side-quest-debug-output-b13771730cfc0daf': Signed-commit payload violates file-protection policy (request_review): workshop/README.md

Workflow Run: View run details and download bundle artifact

The bundle file is available in the agent artifact in the workflow run linked above.

To create a pull request with the changes:

# Download the artifact from the workflow run
gh run download 29171623219 -n agent -D /tmp/agent-29171623219

# Fetch the bundle into a temporary ref, then update the local branch
git fetch /tmp/agent-29171623219/aw-side-quest-debug-output.bundle refs/heads/side-quest-debug-output:refs/bundles/create-pr-side-quest-debug-output-b13771730cfc0daf-612ba6e7
git update-ref refs/heads/side-quest-debug-output-b13771730cfc0daf refs/bundles/create-pr-side-quest-debug-output-b13771730cfc0daf-612ba6e7
git checkout side-quest-debug-output-b13771730cfc0daf
# Ensure the working tree matches the updated branch
git reset --hard
# Remove the temporary bundle ref
git update-ref -d refs/bundles/create-pr-side-quest-debug-output-b13771730cfc0daf-612ba6e7

# Push the branch to origin
git push origin side-quest-debug-output-b13771730cfc0daf

# Create the pull request
gh pr create --title '[side-quest] Add side quest: Diagnosing Common Agent Output Patterns' --base main --head side-quest-debug-output-b13771730cfc0daf --repo githubnext/gh-aw-workshop