Show HN: Reporails – Linter for AI coding agent instruction files
1 comments
Built this after too many hours debugging why Claude kept ignoring my instructions.
36 universal rules, 6 Claude-specific. OpenGrep handles the deterministic checks, LLM fills in the semantic gaps.
Adding rules is easy - slash commands walk you through it.
What breaks your instruction files?
36 universal rules, 6 Claude-specific. OpenGrep handles the deterministic checks, LLM fills in the semantic gaps.
Adding rules is easy - slash commands walk you through it.
What breaks your instruction files?
Asked Claude to review and fix them. It made things different, not better.
So I built a linter. 42 rules covering structure, content, efficiency, governance, maintenance. Deterministic checks first, semantic validation for the rest.
Currently supports CLAUDE.md. Cursor, Copilot, Codex adapters coming.
v0.0.1. Open source.
CLI + MCP: https://github.com/reporails/cli Rules (CC BY 4.0): https://github.com/reporails/rules
Early days. Looking for feedback, bug reports, and contributors.