docs(agent-team): document input propagation errors and manual re-dispatch#108
Draft
github-actions[bot] wants to merge 1 commit intomainfrom
Draft
Conversation
…patch Commit d688265 hardened all three dispatch agents to fail loudly on missing workflow_dispatch inputs instead of silently inferring from label state. Reflect this in the user-facing README: - Expand step 4 with exact `gh workflow run --field` commands for each role (planner, implementer, reviewer) so operators know the required inputs for manual re-dispatch. - Expand the "Input propagation" gotcha with the verbatim error message users will see on the issue (`🛑 agent-team: workflow_dispatch inputs were not propagated`) and the recovery steps (clear state:blocked, re-dispatch with explicit --field arguments). - Clarify the pr_number optional/kickback semantics inline: omit on first dispatch, include on reviewer kickback to update the existing PR branch. 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
catalog/agent-team/README.md— two targeted updates driven by commit d688265 (fix agent-team manual workflow_dispatch inputs).1. Manual re-dispatch commands (step 4 of "Kicking off a task")
Replaced the vague prose about
gh workflow runwith exact--fieldinvocations for each role:The commit added loud failure on missing inputs, making these commands more important — operators must now pass explicit fields or the workflow will block rather than guess.
2. "Input propagation" gotcha (Limits and gotchas)
Expanded from one sentence to a full recovery guide:
🛑 agent-team: workflow_dispatch inputs were not propagated. Re-dispatch with valid inputs.)pr_numberoptional semantics: omit on first implementer dispatch (new PR), include on reviewer kickback (push to existing PR branch)Why
The hardened input-validation logic (d688265) changed the observable failure mode for operators — workflows now block loudly instead of silently continuing with inferred state. Without updated docs, users hitting this error have no guidance on what the message means or how to recover.
No breaking changes
Documentation only. No workflow source files were modified.
🤖 Generated with [Claude Code]((claude.com/redacted)