Skip to content

ci: enforce the README example count in validate-counts#64

Merged
TMHSDigital merged 1 commit into
mainfrom
ci/enforce-example-count
Jul 19, 2026
Merged

ci: enforce the README example count in validate-counts#64
TMHSDigital merged 1 commit into
mainfrom
ci/enforce-example-count

Conversation

@TMHSDigital

Copy link
Copy Markdown
Owner

The validate-counts job enforced the skills/rules/templates/snippets counts in README.md but not the examples count, so the "20 examples" figure could silently go stale when example #21 lands (flagged in the README QoL pass, #63).

  • Counts examples/<dir>/ directories that contain a README.md (robust against stray non-example dirs), mirroring how skills are counted by SKILL.md presence.
  • Adds the same substring check the other counts use: "{n} examples" must appear in README.md.
  • AGENTS.md's description of the job updated to the durable form (names the five content types instead of hard-coding numbers).

Proven to fail: the check logic was run locally against the real README (pass, 20 counted) and against a README with "20 examples" edited to "19 examples" (fails with the expected error message).

🤖 Generated with Claude Code

The job enforced skills/rules/templates/snippets but not examples, so the
'20 examples' figure in the README could silently go stale when example 21
lands. Counts example directories by README.md presence (robust against
stray dirs), mirrors the existing substring check, and was proven to fail
on a deliberate mismatch before shipping.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation ci labels Jul 19, 2026
@TMHSDigital
TMHSDigital merged commit 1ac2458 into main Jul 19, 2026
9 checks passed
@TMHSDigital
TMHSDigital deleted the ci/enforce-example-count branch July 19, 2026 01:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant