Skip to content

docs: fix test harness claim and workflow count in CONTRIBUTING.md#30

Closed
github-actions[bot] wants to merge 1 commit intomainfrom
docs/fix-contributing-test-harness-and-workflow-count-47d8d03fa627125c
Closed

docs: fix test harness claim and workflow count in CONTRIBUTING.md#30
github-actions[bot] wants to merge 1 commit intomainfrom
docs/fix-contributing-test-harness-and-workflow-count-47d8d03fa627125c

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

What

Two factual inaccuracies in CONTRIBUTING.md, both introduced in the initial commit:

1. Testing section claimed no test harness exists

"There is no automated test harness for skills — they are instruction sets interpreted by Claude Code, not code with unit tests."

tests/ contains a full prompt-based suite (run-tests.sh, test-helpers.sh, test-discover-workflows.sh, test-install-workflow.sh) with its own README.md. The old text actively misled contributors into thinking manual testing was the only option.

Fix: Replaced the denial with the actual run commands, a link to tests/README.md, and guidance on when to run tests and how to add new ones.

2. Workflow count said seven, should be eight

"The .github/workflows/ directory contains seven dogfooded workflows."

The README workflow table lists eight: daily-repo-status, repo-assist, daily-plan, update-docs, q, markdown-linter, pr-nitpick-reviewer, weekly-research.

Fix: seveneight.

Testing

  • Diff-reviewed: no logic or instructions changed, only facts corrected.
  • Cross-checked against tests/README.md and the README workflow table.

Generated by Update Docs ·

To install this agentic workflow, run

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

The Testing section incorrectly stated there was no automated test
harness; tests/ contains a full prompt-based suite with runner, helpers,
and two test files. Replaced the denial with actual run commands and a
link to tests/README.md.

Also fixed "seven" → "eight" dogfooded workflows to match the README
workflow table count.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions bot added automation documentation Improvements or additions to documentation labels Apr 20, 2026
@verkyyi
Copy link
Copy Markdown
Owner

verkyyi commented Apr 20, 2026

Closing — the update-docs workflow fired on every push during a heavy development session, producing ~17 overlapping drift PRs. Switching the trigger to a daily schedule (see commit on main) to prevent this pattern. Any genuine drift will reappear on tomorrow's scheduled run.

@verkyyi verkyyi closed this Apr 20, 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.

1 participant