[docs] docs: unbloat OrchestratorOps page - #56207
Conversation
github-actions
Bot
added
automation
doc-unbloat
documentation
There was a problem hiding this comment.
Pull request overview
Note
Copilot could not run the full agentic suite for this review because it was automatically requested on a bot-authored pull request. Request a review from Copilot under Reviewers to retry with the full agentic suite. Improved support for bot-authored pull requests is coming soon.
Updates the OrchestratorOps documentation to be more concise and to better distinguish the tradeoffs between dispatch-workflow (async) and call-workflow (in-run), plus adds a link to monitoring guidance.
Changes:
- Rewrites the OrchestratorOps intro and the orchestrator/worker section for clarity and concision
- Improves guidance on when to use
dispatch-workflowvscall-workflow - Updates the Mermaid diagram node names and adds Monitoring with Projects to “Learn More”
Show a summary per file
| File | Description |
|---|---|
| docs/src/content/docs/patterns/orchestration.md | Refines OrchestratorOps narrative, clarifies mode selection, updates diagram labels, and adds monitoring reference |
Review details
💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.
- Files reviewed: 1/1 changed files
- Comments generated: 2
- Review effort level: Lite
| Trigger([Trigger]) --> Orchestrator[Orchestrator\ndecide & dispatch] | ||
| Orchestrator --> WorkerA[Worker A] | ||
| Orchestrator --> WorkerB[Worker B] | ||
| Orchestrator --> WorkerN[Worker N] |
| The compiler validates that each worker declares `workflow_call`, generates a typed MCP tool per worker from its inputs, and emits a conditional `uses:` job. At runtime the worker whose name the agent selected executes as part of the same workflow run — preserving `github.actor` and billing attribution. | ||
|
|
||
| See [`call-workflow` safe output](/gh-aw/reference/safe-outputs/#workflow-call-call-workflow). | ||
| The compiler validates that each worker declares `workflow_call`, generates a typed MCP tool from its inputs, and emits a conditional `uses:` job. At runtime, the selected worker runs inside the same workflow run, preserving `github.actor` and billing attribution. |
|
✅ Test Quality Sentinel completed test quality analysis. No test files were added or modified in this PR. This PR only modifies documentation (docs/src/content/docs/patterns/orchestration.md). Test Quality Sentinel skipped.
|
test