docs(agent-team): document dispatch input propagation failure and recovery#104
Draft
github-actions[bot] wants to merge 1 commit into
Draft
Conversation
…overy Expand the "Input propagation" gotcha bullet to describe the exact failure mode introduced by PR #69: agents check for unresolved ${{ github.event.inputs.* }} literals (not just empty strings), post a specific 🛑 error comment when inputs are missing, and surface the recovery path. Add a new Troubleshooting section with concrete gh workflow run commands for manually re-dispatching a stalled planner, implementer, or reviewer, and a note explaining how the implementer distinguishes a first-attempt blank pr_number from a kickback real PR number. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
github-actions
Bot
added
automation
documentation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
Expands
catalog/agent-team/README.mdto mirror the hardening introduced in PR #69 (fix(agent-team): fail loud on missing dispatch inputs+fix(agent-team): harden optional implementer pr_number).Two additions:
"Input propagation" gotcha (expanded) — the existing one-liner now describes:
$\{\{ github.event.inputs.* }}literals, not just empty stringsissue_numberis resolvable:🛑 agent-team: workflow_dispatch inputs were not propagated. Re-dispatch with valid inputs.missing_data/report_incompletewhenissue_numberitself is missingNew "Troubleshooting" section — covers the most common stuck state:
gh workflow runcommands to manually re-dispatch a stalled planner, implementer, or reviewer with correct inputspr_number(first impl attempt → new branch) from a real numericpr_numberforwarded by the reviewer on kickbackWhy this matters
Before this PR, the README said "fail loudly" without specifying what that looks like in practice or how to recover. A user who sees
state:blockedwith the propagation error message would have no documented recovery path.Files changed
catalog/agent-team/README.md— 37 lines added, 1 line replaced