Show HN: Reporails – Linter for AI coding agent instruction files
My instruction files grew to 24 files, 400+ lines each. Claude kept going off-script.
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. 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?