[FR] check-repo-hygiene: flag rule files missing from README
Author: chirag127Created Jul 4, 2026Updated Jul 4, 2026
Use case
scripts/check-repo-hygiene.mjs catches README bullets pointing at missing rule files, but not the reverse: rule files under rules/ that no README section links. Today rules/ has 257 .mdc files while README.md links 214 unique paths (43 orphans).
Proposal
Add a check (under --only readme or rules) that fails when a rules/*.mdc file is not referenced by any rules/...\.mdc link in README.md. Allow an opt-out list for intentionally unlisted internal rules.
Existing art
Mirror of the existing checkReadmeOnlyExternalListings check in scripts/check-repo-hygiene.mjs.
Not-a-bug caveat
Enhancement, not a defect.
Thanks for maintaining PatrickJS/awesome-cursorrules!
Source: PatrickJS/awesome-cursorrules