Skip to content

[side-quest] Add side quest: Design a Multi-Workflow Orchestration Strategy #2534

Description

@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

Summary

Source file mined: workshop/28-orchestrate-workflows.md

Side quest extracted: workshop/side-quest-28-01-orchestration-design.md — a design primer covering the planner-worker split, choosing repository signals, building a routing decision table, and understanding the dispatch-workflow primitive before writing any code.

Changes

  • New file: workshop/side-quest-28-01-orchestration-design.md — self-contained optional detour with What You'll Do, Before You Start, conceptual walkthrough, routing table design activity, and a checkpoint, plus a return link to Step 28.
  • Updated: workshop/28-orchestrate-workflows.md — the conceptual primer and design-your-orchestrator prose is replaced with a compact one-paragraph summary and an optional TIP callout linking to the side quest; the build path (create workflow, compile, run, verify) is fully preserved.
  • Updated: workshop/README.md — new entry added under Optional Side Quests listing the new side quest and its branch point from Step 28.

Learner routing

Learners who want to understand orchestration concepts before building follow the side quest and return to Step 28 for the implementation. Learners who prefer to learn by doing can skip directly to the build steps in Step 28 — nothing is removed from the main path.

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 · 94.2 AIC · ⌖ 6.97 AIC · ⊞ 5.1K ·

  • expires on Aug 8, 2026, 2:18 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/28-01-orchestration-design-f62fb98a4c71ec40': 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 31185484303 -n agent -D /tmp/agent-31185484303

# Fetch the bundle into a temporary ref, then update the local branch
git fetch /tmp/agent-31185484303/aw-side-quest-28-01-orchestration-design.bundle refs/heads/side-quest/28-01-orchestration-design:refs/bundles/create-pr-side-quest-28-01-orchestration-design-f62fb98a4c71ec40-435e4576
git update-ref refs/heads/side-quest/28-01-orchestration-design-f62fb98a4c71ec40 refs/bundles/create-pr-side-quest-28-01-orchestration-design-f62fb98a4c71ec40-435e4576
git checkout side-quest/28-01-orchestration-design-f62fb98a4c71ec40
# 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-28-01-orchestration-design-f62fb98a4c71ec40-435e4576

# Push the branch to origin
git push origin side-quest/28-01-orchestration-design-f62fb98a4c71ec40

# Create the pull request
gh pr create --title '[side-quest] Add side quest: Design a Multi-Workflow Orchestration Strategy' --base main --head side-quest/28-01-orchestration-design-f62fb98a4c71ec40 --repo githubnext/gh-aw-workshop

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions