Skip to content

docs: fix agent-team label, testing guide, and workflow count in CONTRIBUTING#125

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-label-and-contributing-gaps-39cc9a936c157e0f
Draft

docs: fix agent-team label, testing guide, and workflow count in CONTRIBUTING#125
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-label-and-contributing-gaps-39cc9a936c157e0f

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Three documentation gaps found by reviewing the agent-team dispatch-input hardening (d688265) against existing docs.

Changes

README.md — Uninstall section

Listed state:in-progress as the 7th label to delete when uninstalling agent-team. That label doesn't exist. The real 7th label created by /install-agent-team is agent-team:reviewed (confirmed in skills/install-agent-team/SKILL.md:80, catalog/agent-team/reviewer-agent.md:64, and catalog/agent-team/README.md:100). Users following the old instructions would silently skip deleting agent-team:reviewed and try to delete a label that was never there.

CONTRIBUTING.md — Testing section

Claimed "There is no automated test harness for skills". The repo now has a full 3-tier test suite under tests/ with CI integration via ci-tests.yml. Replaced the stale claim with the actual tier breakdown:

  • Tier 2 (invariants, <1 s) — always run, wired into CI
  • Tier 1 (skill tests, ~4–5 min) — run on skill/catalog changes, wired into CI
  • Tier 3 (E2E, 5–35 min, destructive) — run manually before agent-team logic changes

CONTRIBUTING.md — Workflow files + Publishing sections

  • "seven dogfooded workflows" → three (the set was trimmed in b3f6341; five workflows were dropped and the invariant tests enforce they stay absent).
  • Broken link to README.md#publishing (section was removed in 83bdd43 during the end-user focus compaction) → replaced with the Releases page and plugin listing links.

Test plan

  • Tier-2 invariants still pass: bash tests/test-invariants.sh (the check_required for README.md label section was not added as an invariant — that's intentional per the "add only on caught regression" policy)
  • No broken links introduced — all URLs point to existing anchors or external pages
  • catalog/agent-team/README.md:100 and skills/install-agent-team/SKILL.md:80 both confirm agent-team:reviewed as the correct label name

Generated by Update Docs ·

To install this agentic workflow, run

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

Three documentation gaps surfaced by reviewing the agent-team dispatch
input fix (d688265) against the existing docs:

1. README.md Uninstall: listed `state:in-progress` as the 7th label to
   delete, but that label doesn't exist. The real 7th label created by
   /install-agent-team is `agent-team:reviewed` (SKILL.md:80,
   reviewer-agent.md:64, catalog/agent-team/README.md:100).

2. CONTRIBUTING.md Testing: claimed "There is no automated test harness"
   but the repo has a full 3-tier suite under tests/ with CI integration
   (ci-tests.yml). Replaced with the actual tier-2/1/3 breakdown, run
   commands, and when to use each tier.

3. CONTRIBUTING.md Workflow files: said "seven dogfooded workflows" (the
   old count before b3f6341 trimmed the set). Now three gh-aw workflows
   are dogfooded. Also fixed a broken link to README.md#publishing
   (that section was removed in 83bdd43).

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 18, 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