Skip to content

v0.5.0

Latest

Choose a tag to compare

@github-actions github-actions released this 24 Feb 02:36
37468c4

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.mddocs/pattern-guide.md. Backbone key
rules.patterns.opengreprules.patterns.patterns_yml.

Schema changes

  • Added context_quality category (letter X) to coordinate patterns and
    category enums
  • Normalized agent override severity enum syntax; added critical value
  • Added pattern validation to agent config excludes items
  • Added internal source type to sources schema
  • Sources schema version corrected from stale 1.0.0 to 0.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.yml for 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-rules skill 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-cli 0.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