Skip to content

docs: fix agent-team label name + document mid-pipeline recovery#74

Draft
github-actions[bot] wants to merge 1 commit intomainfrom
docs/fix-agent-team-uninstall-labels-and-recovery-071504066ed1809d
Draft

docs: fix agent-team label name + document mid-pipeline recovery#74
github-actions[bot] wants to merge 1 commit intomainfrom
docs/fix-agent-team-uninstall-labels-and-recovery-071504066ed1809d

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Summary

Two documentation fixes surfaced by the #69 dispatch-inputs hardening:

  • Label name bug (README.md uninstall section): state:in-progressagent-team:reviewed. The install skill, E2E tests, and reviewer-agent.md all use agent-team:reviewed as the seventh label. state:in-progress never existed in the pipeline.

  • Mid-pipeline recovery guide (catalog/agent-team/README.md): The "Retrying a blocked task" section previously only described restarting from scratch via the spec agent. After [codex] fix agent-team manual workflow_dispatch inputs #69, planner/implementer/reviewer now fail loudly with 🛑 workflow_dispatch inputs were not propagated instead of silently inferring context. The old "clear state:blocked + re-add agent-team" advice didn't help users recover from this error. The updated section:

    • Splits restart paths: re-run from spec vs. re-dispatch mid-pipeline
    • Adds explicit gh workflow run ... -f CLI commands for planner, implementer, and reviewer
    • Updates the "Input propagation" gotcha entry to explain the error message, label it expected behavior (not a bug), and cross-reference the recovery steps

Files changed

File Change
README.md Uninstall: state:in-progressagent-team:reviewed
catalog/agent-team/README.md Retrying blocked tasks + Input propagation gotcha

Test plan

  • Verify the seven labels listed in README.md uninstall section exactly match those created by skills/install-agent-team/SKILL.md and expected by tests/test-e2e-install-agent-team.sh
  • Verify the gh workflow run commands in the new recovery section match the workflow_dispatch.inputs schemas in the four catalog/agent-team/*.md workflow sources

🤖 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

Two documentation fixes surfaced by the #69 dispatch-inputs hardening:

1. README.md uninstall section: `state:in-progress` → `agent-team:reviewed`.
   The install skill, E2E tests, and reviewer workflow all use
   `agent-team:reviewed` as the 7th label. `state:in-progress` never
   existed in the pipeline.

2. catalog/agent-team/README.md: expand "Retrying a blocked task" to
   cover mid-pipeline re-dispatch after a
   `workflow_dispatch inputs were not propagated` block (the new fail-loud
   behavior added in #69). Old text only described restarting from spec.
   New text adds explicit `gh workflow run` commands for planner/
   implementer/reviewer with all required inputs. Also updates the
   "Input propagation" gotcha entry to explain the error, label it
   expected behavior (not a bug), and cross-reference the recovery steps.

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