Problem
The Docusaurus unit tests (npm run docs:test) are not listed in the PR checklist or any contributor-facing documentation. This means contributors who add artifacts to collection manifests will not know to update docs/docusaurus/src/data/collectionCards.ts, causing CI to fail when adding new skills, agents, or prompts to collections.
Proposed Changes
1. .github/PULL_REQUEST_TEMPLATE.md
Add docs:test to the Required Automated Checks section alongside plugin:generate:
* [ ] Plugin freshness: `npm run plugin:generate`
+* [ ] Docusaurus tests: `npm run docs:test`
2. docs/contributing/ai-artifacts-common.md — "Adding Artifacts to a Collection"
After the existing step 7 (npm run plugin:generate), add step 8:
+8. Update `docs/docusaurus/src/data/collectionCards.ts` to reflect the new artifact count
+ for the affected collection(s) and `metaCollections['hve-core-all']`, then run
+ `npm run docs:test` to verify.
3. docs/contributing/skills.md — Automated Validation section
Add docs:test to the commands list:
+npm run docs:test # Validate Docusaurus artifact counts
Acceptance Criteria
Related
- Follow-up: long-term YAML-driven count derivation (see related issue)
Problem
The Docusaurus unit tests (
npm run docs:test) are not listed in the PR checklist or any contributor-facing documentation. This means contributors who add artifacts to collection manifests will not know to updatedocs/docusaurus/src/data/collectionCards.ts, causing CI to fail when adding new skills, agents, or prompts to collections.Proposed Changes
1.
.github/PULL_REQUEST_TEMPLATE.mdAdd
docs:testto the Required Automated Checks section alongsideplugin:generate:* [ ] Plugin freshness: `npm run plugin:generate` +* [ ] Docusaurus tests: `npm run docs:test`2.
docs/contributing/ai-artifacts-common.md— "Adding Artifacts to a Collection"After the existing step 7 (
npm run plugin:generate), add step 8:3.
docs/contributing/skills.md— Automated Validation sectionAdd
docs:testto the commands list:+npm run docs:test # Validate Docusaurus artifact countsAcceptance Criteria
npm run docs:testin Required Automated Checksdocs/contributing/ai-artifacts-common.mdcollection registration steps include thecollectionCards.tsupdate instructiondocs/contributing/skills.mdAutomated Validation section includesnpm run docs:testnpm run lint:mdRelated