Document dispatch-workflow MCP tool generation and input handling

[Copilot]

Users were confused about how dispatch-workflow safe output works and how to properly define inputs for target workflows.

Changes

Documentation (docs/src/content/docs/reference/safe-outputs.md)

• Added "How It Works" section explaining automatic MCP tool generation from workflow_dispatch inputs
• Added "Defining Workflow Inputs" section with complete target workflow example
• Added "Best Practices" (explicit inputs, descriptive descriptions, choice types, defaults)
• Added "Troubleshooting" for 4 common failure modes
• Fixed max value (3 → 50)

Example workflow (.github/workflows/test-dispatcher.md)

• Rewrote to explain MCP tool auto-generation and calling patterns

Template (pkg/cli/templates/create-agentic-workflow.md)

• Added "Dispatching Other Workflows" section with proper input definition guidance

Key clarification

The compiler reads target workflow's workflow_dispatch inputs and auto-generates MCP tools:

# Target workflow: deploy-app.md
on:
  workflow_dispatch:
    inputs:
      environment:
        description: "Target deployment environment"
        required: true
        type: choice
        options: [staging, production]
      version:
        required: true
        type: string

Generates deploy_app MCP tool with matching schema. Agent calls it directly - no manual output formatting needed.

Impact

• ~330 lines of new documentation
• 7 code examples
• 4 troubleshooting scenarios with solutions

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• telemetry.astro.build
  • Triggering command: /opt/hostedtoolcache/node/24.13.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Review dispatch-workflow safe output implementation and update the docs and prompting instructions

Custom agent used: technical-doc-writer
AI technical documentation writer for GitHub Actions library using GitHub Docs voice

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.