Skip to content

docs: fix agent-team label name and add manual dispatch examples#117

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-label-name-and-manual-dispatch-examples-a0dc3dd304986c43
Draft

docs: fix agent-team label name and add manual dispatch examples#117
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-label-name-and-manual-dispatch-examples-a0dc3dd304986c43

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Follow-up documentation for #69 (fix agent-team manual workflow_dispatch inputs).

Changes

README.md — fix incorrect label name in Uninstall section

The Uninstall section listed state:in-progress as one of the seven agent-team labels to delete. That label does not exist. The actual seventh label, created by the install skill and used by the reviewer workflow, is agent-team:reviewed. Updated to match.

catalog/agent-team/README.md — two improvements

1. Manual dispatch examples (step 4 of "Kicking off a task")

Step 4 previously said "Manual dispatches must pass the required workflow_dispatch inputs" without showing the commands. Since #69 enforces strict input validation (missing inputs immediately block the issue), users need to know the exact -f flags. Added a code block with ready-to-paste gh workflow run commands for each of the three dispatch-receiving roles, including the optional pr_number case for implementer kickbacks.

2. "Input propagation" gotcha — describe implemented behaviour

The bullet previously said the workflows "must fail loudly" (spec language). It now describes what actually happens after #69: the workflow adds state:blocked and posts the exact error message, plus a recovery path (clear state:blocked, re-dispatch with valid inputs).

Test plan

  • Verify agent-team:reviewed label exists in the install skill (skills/install-agent-team/SKILL.md step 6) — confirmed ✅
  • Verify state:in-progress label does not appear in the install skill or any workflow — confirmed absent ✅
  • Verify error message text matches reviewer/planner/implementer agent markdown sources — confirmed ✅

🤖 Generated with [Claude Code]((claude.ai/redacted)

Generated by Update Docs ·

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/update-docs.md@96b9d4c39aa22359c0b38265927eadb31dcf4e2a

- README.md Uninstall: replace `state:in-progress` with `agent-team:reviewed`
  to match the actual label created by the install skill
- catalog/agent-team/README.md: add concrete `gh workflow run` examples for
  manual re-dispatch (planner/implementer/reviewer) so users know the exact
  `-f` flags required after the strict input validation added in #69
- Expand "Input propagation" gotcha to include the actual error message and
  recovery steps, reflecting the behaviour now enforced in the workflow sources

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels May 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants