https://github.com/reporails/rules
Rules for validating AI coding agent instructions. Evidence-backed, scored for trust. Used by reporails-cli
https://github.com/reporails/rules
ai-coding claude-code code-quality developer-tools llm validation
Last synced: about 11 hours ago
JSON representation
Rules for validating AI coding agent instructions. Evidence-backed, scored for trust. Used by reporails-cli
- Host: GitHub
- URL: https://github.com/reporails/rules
- Owner: reporails
- License: other
- Created: 2026-01-21T16:29:49.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2026-02-10T01:03:21.000Z (8 days ago)
- Last Synced: 2026-02-10T06:00:43.199Z (8 days ago)
- Topics: ai-coding, claude-code, code-quality, developer-tools, llm, validation
- Language: Python
- Homepage:
- Size: 639 KB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Reporails Rules
Validation rules for AI agent instruction files (CLAUDE.md, .cursorrules, copilot-instructions.md).
Community-maintained.
**Version:** 0.4.1
### Pre-1.0 — moving fast, API still evolving, feedback welcome.
## Quickstart
```bash
npx @reporails/cli install
```
This registers the MCP server with Claude Code. Then ask Claude:
```
> What ails claude?
```
Or run directly without MCP:
```bash
npx @reporails/cli check
```
## What's here
```
core/
structure/ # 3 rules: File presence, nesting, format
content/ # 5 rules: Context, commands, architecture, constraints
governance/ # 1 rule: Cross-agent compatibility
maintenance/ # 2 rules: Reference integrity, glob validation
agents/
claude/ # 3 rules: Claude Code specific
codex/ # 1 rule: OpenAI Codex specific
copilot/ # 2 rules: GitHub Copilot CLI specific
schemas/ # Rule, agent, and config schemas
registry/ # Capabilities, levels, coordinate map
docs/ # Capability levels, sources
```
17 rules. For additional recommended rules, see [reporails/recommended](https://github.com/reporails/recommended).
> **Tombstones**: Old coordinate slots from pre-0.4.0 rules will be backfilled in `registry/tombstones.yml` after 0.5.0.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md)
Supported agents: **Claude Code**, **Codex**, **Copilot CLI**
## Documentation
- [Capability Levels](docs/capability-levels.md) — L1-L6 capability model
- [Rule Schema](schemas/rule.schema.yml) — How rules are structured
## License
[CC BY-SA 4.0](LICENSE)