[side-quest] feat: extract failure modes reference into optional side quest

[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/22-error-handling-and-resilience.md

What was extracted

The "Understand common failure modes" section — a detailed four-part reference covering empty data, tool errors, timeouts, and prompt drift — was extracted into a new optional side quest:

• New file: workshop/side-quest-22-01-failure-modes.md — Agentic Workflow Failure Modes Reference

The side quest includes the original failure-mode table, per-failure deep dives with run-log signals and prevention techniques, the resilience-techniques diagram, and a return link back to step 22.

How routing was updated

• 22-error-handling-and-resilience.md: The verbose explainer section was replaced with the summary table, a brief orienting sentence, and a [!TIP] callout linking to the new side quest. The main path continues without needing the detour.
• workshop/README.md: The new side quest is listed in the Optional Side Quests section, noting it branches from Step 22.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🗺️ Side Quest · 60.3 AIC · ⌖ 6.94 AIC · ⊞ 5.1K · ◷

• expires on Aug 4, 2026, 2:37 PM UTC

---

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-22-failure-modes-df058952b155d9ac': 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 30822777780 -n agent -D /tmp/agent-30822777780

# Fetch the bundle into a temporary ref, then update the local branch
git fetch /tmp/agent-30822777780/aw-side-quest-22-failure-modes.bundle refs/heads/side-quest-22-failure-modes:refs/bundles/create-pr-side-quest-22-failure-modes-df058952b155d9ac-6560f1a3
git update-ref refs/heads/side-quest-22-failure-modes-df058952b155d9ac refs/bundles/create-pr-side-quest-22-failure-modes-df058952b155d9ac-6560f1a3
git checkout side-quest-22-failure-modes-df058952b155d9ac
# 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-22-failure-modes-df058952b155d9ac-6560f1a3

# Push the branch to origin
git push origin side-quest-22-failure-modes-df058952b155d9ac

# Create the pull request
gh pr create --title '[side-quest] feat: extract failure modes reference into optional side quest' --base main --head side-quest-22-failure-modes-df058952b155d9ac --repo githubnext/gh-aw-workshop

[github-actions]

This issue was automatically closed because it expired on 2026-08-04T14:37:16.588Z.

Closed by Workflow