Rulereach

rulereach

**English** · [Русский](docs/README.ru.md) · [简体中文](docs/README.zh-CN.md) · [Español](docs/README.es.md) · [Português](docs/README.pt-BR.md)

[](https://pypi.org/project/rulereach/) [](https://pypi.org/project/rulereach/) [](https://github.com/Topicspot/rulereach/actions/workflows/ci.yml) [](https://github.com/Topicspot/rulereach/blob/main/LICENSE)

Your agent instruction files can be perfectly written and still never reach the agent. A Cursor rule with `globs` as a YAML list never attaches. A `@import` in `CLAUDE.md` that points one directory too high is skipped without a word. A file in `.github/instructions/` without `applyTo` applies to nothing. A nested `AGENTS.md` quietly replaces the root one. None of that shows up as an error anywhere: the agent just works without your rules.

`rulereach` reads the instruction files in a repository, applies each tool's documented loading rules, and reports what will never be loaded.


$ rulereach check
.claude/rules/api.md
  x RR204 [claude] paths pattern 'photos [2024/**' unreadable bracket expression, so it matches nothing
      fix: rewrite the pattern; escape a literal bracket as \[ and keep brace groups small
      docs: https://code.claude.com/docs/en/memory
.cursor/rules/style.mdc
  x RR102 [cursor] globs is a YAML list; Cursor expects one comma-separated string, so the rule never auto-attaches
      fix: write: globs: src/**/*.ts
      docs: https://forum.cursor.com/t/glob-pattern-rules-are-never-respected-by-agent/160133
AGENTS.md
  x RR201 [claude] the repository has AG