Skip to content

docs(install-agent-team): document manual re-dispatch input requirement#89

Draft
github-actions[bot] wants to merge 1 commit intomainfrom
docs/manual-dispatch-input-contract-7d5207e7645038b9
Draft

docs(install-agent-team): document manual re-dispatch input requirement#89
github-actions[bot] wants to merge 1 commit intomainfrom
docs/manual-dispatch-input-contract-7d5207e7645038b9

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot commented May 1, 2026

What changed and why

PR #69 hardened planner, implementer, and reviewer agents to fail loudly when workflow_dispatch inputs are missing or arrive as unresolved template literals ($\{\{ github.event.inputs.* }}). The catalog/agent-team/README.md was updated in that PR, but skills/install-agent-team/SKILL.md still listed escape hatches without mentioning the input contract — meaning a user reading only the skill file after install wouldn't know that a manual gh workflow run must include explicit --field arguments.

Changes

skills/install-agent-team/SKILL.md — 2 additions, 1 replacement:

  1. Step 8 "Summarize" — new "Manual re-dispatch" bullet added to the install-completion summary the agent presents to the user. Includes the required --field flags and notes the fail-loud behaviour.

  2. User journey "Escape hatches" — the one-liner escape-hatch description now includes the manual re-dispatch command pattern and the fail-loud note, so users who refer back to the journey section get the same guidance.

No other files were changed — the agent .md files and pattern README were already updated in #69.

Testing notes

  • tests/test-invariants.sh already checks for $\{\{ github.event.inputs.issue_number }} in the agent files (added in [codex] fix agent-team manual workflow_dispatch inputs #69). No new invariants needed for this prose-only SKILL.md update.
  • Run bash tests/run-tests.sh (tier-1 + tier-2) to confirm no regressions.

🤖 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

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 <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels May 1, 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