Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[workshop-sync] workshop/28-orchestrate-workflows.md: dispatch-workflow example fails to compile — pr-reviewer lacks workflow_dispatch trigger

Open Beginner friendly
  • Is something wrong?
#4,548 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
68/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github-actions
Domain
documentation

Research direction

Start with the on: block of the pr-reviewer example in workshop/14b-pr-reviewer-workflow.md and the dispatch-workflow step in workshop/28-orchestrate-workflows.md. Reproduce the failure by compiling the orchestrator with gh aw compile, which should report that pr-reviewer lacks workflow_dispatch. Pick one of the three fixes in the issue, then recompile; done means the checkpoint's success claim is true and the wording matches the compiled behaviour.

Written by the indexing model from the issue text.

Description

documentation

Workshop file reviewed

workshop/28-orchestrate-workflows.md

Problem

The step instructs learners to build a repo-orchestrator workflow that dispatches the pr-reviewer workflow (built in workshop/14b-pr-reviewer-workflow.md) via the dispatch-workflow safe-output:

safe-outputs:\n dispatch-workflow:\n workflows:\n - daily-status\n - pr-reviewer\n max: 1

The pr-reviewer workflow from step 14b only declares pull_request and slash_command triggers — it has no workflow_dispatch trigger.

Current correct behaviour (verified by reproduction)

I reproduced this locally with gh aw compile (v0.89.21, matching the latest gh-aw release). Compiling an orchestrator that lists a dispatch target without workflow_dispatch in its on: section fails with:

error: dispatch-workflow validation failed: dispatch-workflow: workflow 'pr-reviewer' does not support workflow_dispatch trigger (must include 'workflow_dispatch' in the 'on' section)

This means following the workshop step exactly as written — using the existing pr-reviewer workflow from step 14b as a dispatch target — produces a compile error, not the success state the checkpoint describes ("gh aw compile repo-orchestrator succeeds").

Suggested fix

Either:

  1. Add a note/step in 28-orchestrate-workflows.md instructing learners to add workflow_dispatch: to pr-reviewer's on: section (alongside its existing triggers) before using it as a dispatch target, or
  2. Update workshop/14b-pr-reviewer-workflow.md to include workflow_dispatch: in the on: block from the start so it is dispatch-ready for step 28, or
  3. Use a different pre-built workshop workflow as the dispatch target example that already supports workflow_dispatch.

Reference: gh aw compile-time validation for dispatch-workflow (confirmed via direct reproduction against the installed v0.89.21 CLI).

Generated by 🔍 Workshop Sync Check · copilot · auto · 217.4 AIC · ⌖ 6.44 AIC · ⊞ 9.2K · ◷

  • expires on Oct 14, 2026, 2:56 PM UTC
Dominant language
JavaScript
Stars
53
Forks
35
Avg merge
13h 50m
Merged PRs (30d)
14

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.