[side-quest] Add Side Quest: Hint vs Fusion — Choosing How Your Workflow Applies a Skill

[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/29-skills-and-domain-knowledge.md

What was extracted

The step contained a detailed strategy comparison section — a comparison table, full code examples for the hint and fusion patterns, and an explanation of the inline skill option. This is a focused, self-contained primer on one concept (how to reference a skill from a workflow brief) that can stand alone without the rest of the step.

New side quest

workshop/side-quest-29-01-hint-vs-fusion.md — Hint vs Fusion — Choosing How Your Workflow Applies a Skill

Covers all three strategies (hint, fusion, inline) with a comparison table, worked code examples for each, a predict-and-choose scenario exercise, and a compile-and-validate action step. Ends with a return link back to step 29.

Routing update

• Step 29 now has a short one-paragraph summary of the three strategies in place of the long walkthrough, plus a > [!TIP] callout linking to the side quest.
• workshop/README.md lists the new side quest in the Optional Side Quests section, noting it branches from Step 29.

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 · 65.2 AIC · ⌖ 6.98 AIC · ⊞ 5.1K · ◷

• expires on Aug 17, 2026, 1:54 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-29-01-hint-vs-fusion-d2c3bf4c097c9657': 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 31950774091 -n agent -D /tmp/agent-31950774091

# Fetch the bundle into a temporary ref, then update the local branch
git fetch /tmp/agent-31950774091/aw-side-quest-29-01-hint-vs-fusion.bundle refs/heads/side-quest-29-01-hint-vs-fusion:refs/bundles/create-pr-side-quest-29-01-hint-vs-fusion-d2c3bf4c097c9657-0e28d4e3
git update-ref refs/heads/side-quest-29-01-hint-vs-fusion-d2c3bf4c097c9657 refs/bundles/create-pr-side-quest-29-01-hint-vs-fusion-d2c3bf4c097c9657-0e28d4e3
git checkout side-quest-29-01-hint-vs-fusion-d2c3bf4c097c9657
# 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-29-01-hint-vs-fusion-d2c3bf4c097c9657-0e28d4e3

# Push the branch to origin
git push origin side-quest-29-01-hint-vs-fusion-d2c3bf4c097c9657

# Create the pull request
gh pr create --title '[side-quest] Add Side Quest: Hint vs Fusion — Choosing How Your Workflow Applies a Skill' --base main --head side-quest-29-01-hint-vs-fusion-d2c3bf4c097c9657 --repo githubnext/gh-aw-workshop