Summary
Major catalog expansion from 17 to 102 rules. Agent-specific rules migrated to
their own namespaces (CLAUDE:, CODEX:, COPILOT:), new context_quality
category added, and all OpenGrep references removed in favor of native regex
pattern matching.
438 files changed — 8,938 insertions, 2,499 deletions.
Highlights
Rule catalog: 17 → 102
| Category | Count |
|---|---|
| Structure | 36 |
| Content | 32 |
| Context Quality (new) | 7 |
| Efficiency | 5 |
| Governance | 9 |
| Maintenance | 1 |
| Agent — Claude | 8 |
| Agent — Codex | 2 |
| Agent — Copilot | 2 |
Agent namespace migration
Agent-specific rules now live under their own coordinate namespaces instead of
being mixed into CORE:. Hook and skill rules migrated from core to
CLAUDE:S:, CODEX:S:, and COPILOT:S:.
New category: Context Quality (X)
Rules that evaluate whether instruction files provide sufficient project
context for effective agent work — architecture overviews, tech stack
declarations, directory layouts, path scoping, and priority ordering.
OpenGrep removal
All references to OpenGrep/Semgrep replaced with native regex pattern
matching. docs/opengrep-guide.md → docs/pattern-guide.md. Backbone key
rules.patterns.opengrep → rules.patterns.patterns_yml.
Schema changes
- Added
context_qualitycategory (letterX) to coordinate patterns and
category enums - Normalized agent override severity enum syntax; added
criticalvalue - Added pattern validation to agent config
excludesitems - Added
internalsource type to sources schema - Sources schema version corrected from stale
1.0.0to0.1.0 - Rule schema bumped to
0.1.1 - Check ID format canonicalized to
NAMESPACE.CATEGORY.SLOT.descriptive-name
Other changes
- Generic agent — new
agents/generic/config.ymlfor running core rules
without agent-specific config - Bootstrap skill — redesigned to synthesize project context (navigation,
operations, constraints) instead of counting files - Test harness — added
/test-rulesskill for docker compose local
harness - Pre-commit hook — enforces UNRELEASED.md is staged when touching core/,
agents/, schemas/, registry/, or docs/ - CI — test harness disabled in CI/release workflows pending
reporails-cli0.5.0 compatibility
Removed rules
Deprecated and removed from 0.4.x:
- Core: avoid-generic-placeholder-content, boundary-constraints,
include-project-context, project-architecture-documentation,
verification-build-commands, cross-agent-compatibility,
valid-glob-patterns-in-frontmatter, valid-internal-references,
monorepo-nested-instruction-files, root-instruction-file-presence,
structured-markdown-format - Agent: CLAUDE import-syntax, path-scoped-rules, rules-directory; CODEX
combined-instruction-size-limit; COPILOT copilot-instructions-placement,
copilot-path-specific-instructions
Upgrade notes
- Coordinate map fully rebuilt — any tooling referencing 0.4.x coordinates
must update - Agent configs now use arrays for
main_instruction_file - Check IDs use new canonical format
(NAMESPACE.CATEGORY.SLOT.descriptive-name)
Full Changelog: 0.4.1...0.5.0