Skip to content

docs: fix agent-team uninstall label and add manual re-dispatch examples#83

Draft
github-actions[bot] wants to merge 1 commit intomainfrom
docs/fix-agent-team-labels-and-manual-dispatch-examples-a8ddb0169fa19741
Draft

docs: fix agent-team uninstall label and add manual re-dispatch examples#83
github-actions[bot] wants to merge 1 commit intomainfrom
docs/fix-agent-team-labels-and-manual-dispatch-examples-a8ddb0169fa19741

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

What changed

Two documentation fixes, both related to the agent-team pattern:

1. Wrong label name in uninstall instructions (README.md)

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 /install-agent-team and used by the reviewer — is agent-team:reviewed. The surrounding label count ("seven labels") was correct; only the name was wrong.

Before:

gh label delete state:<name> for each of plan-needed, impl-needed, review-needed, done, blocked, and in-progress

After:

gh label delete agent-team:reviewed, and gh label delete state:<name> for each of plan-needed, impl-needed, review-needed, done, and blocked

2. Concrete manual re-dispatch examples (catalog/agent-team/README.md)

"Kicking off a task" step 4 said users could manually gh workflow run a role to retry a stuck stage, but gave no concrete commands. PR #69 fixed workflow_dispatch input propagation so manual dispatches now work correctly (inputs read via $\{\{ github.event.inputs.* }}). Without examples, users still have to guess the exact -f flag names.

The step now includes copy-paste gh workflow run commands for all four re-dispatch scenarios:

  • Re-plan from an existing spec
  • Re-implement (fresh attempt, no PR yet)
  • Re-implement (kickback with an existing PR)
  • Re-review an existing PR

Test plan

  • Verify agent-team:reviewed appears in SKILL.md label create commands (it does — line 80)
  • Verify agent-team:reviewed appears in catalog/agent-team/README.md prerequisites (it does — line 100)
  • Confirm no occurrence of state:in-progress remains in the repo
  • Confirm gh workflow run input flag names match the workflow_dispatch.inputs keys in each agent .md file

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

Generated by Update Docs ·

To install this agentic workflow, run

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

…examples

- README.md uninstall section listed `state:in-progress` which doesn't
  exist; the correct label created by the install skill is
  `agent-team:reviewed`. Fixes the stale label name.

- catalog/agent-team/README.md step 4 now includes concrete
  `gh workflow run` commands for re-dispatching each agent role manually.
  Each workflow reads inputs via `${{ github.event.inputs.* }}` (fixed in
  PR #69); the examples make the correct `-f` flags explicit so users can
  retry a stuck stage without guessing the input names.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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