From 4be9fde974ca95d61fba01e4132d3682aef23f23 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 1 May 2026 11:01:59 +0000 Subject: [PATCH] docs(install-agent-team): document manual re-dispatch input requirement PR #69 hardened all three dispatch-receiving agents (planner, implementer, reviewer) to fail loudly when workflow_dispatch inputs are missing or arrive as unresolved template literals. The catalog README was updated in that PR, but the install-agent-team SKILL.md still listed escape hatches without mentioning the input contract. Add a "Manual re-dispatch" bullet to the step-8 install summary and extend the user-journey escape-hatch line to include the required --field flags and the fail-loud behaviour, so users reading only the skill file get the full picture before attempting a manual gh workflow run. Co-Authored-By: Claude Sonnet 4.6 --- skills/install-agent-team/SKILL.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/skills/install-agent-team/SKILL.md b/skills/install-agent-team/SKILL.md index 7a26c1e..8ff06a5 100644 --- a/skills/install-agent-team/SKILL.md +++ b/skills/install-agent-team/SKILL.md @@ -100,6 +100,7 @@ Show the user, in this order: - Seven labels created (or "N already existed, skipped") - **How to dispatch a task**: *"Open an issue describing what you want built. Add the `agent-team` label. Done."* - Reminder: `gh aw compile` reverts the OAuth tweak. Re-apply on every recompile. `gh aw validate` is safe. +- **Manual re-dispatch**: if you need to retry a stuck stage with `gh workflow run `, you must pass all required `workflow_dispatch` inputs explicitly (e.g. `--field issue_number=42 --field iteration=1`). The agents read inputs via `${{ github.event.inputs.* }}` and will **fail loudly** rather than infer missing values from labels or recent activity. Then ask whether to commit and push. Do not commit without explicit confirmation. @@ -124,7 +125,7 @@ After install, the entire per-task journey is: 6. Reviewer posts a verdict on the PR → `state:done` (approve) or back to `state:impl-needed` (kickback, max 3 rounds). 7. User reviews the approved PR and merges. Agents never merge. -Escape hatches at any time: remove a state label to pause, edit a comment to steer the next agent, add `state:blocked` to halt. +Escape hatches at any time: remove a state label to pause, edit a comment to steer the next agent, add `state:blocked` to halt. To manually re-dispatch a stuck stage: `gh workflow run --field issue_number= --field iteration=` — all required inputs must be passed; the agents fail loudly on missing inputs rather than guessing from labels. ## Out of scope for v0.1