Show HN: Reporails – Linter for AI coding agent instruction files

1 pointscleverhoods1mo ago1 comments

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.

1 comments

cleverhoodsOP1mo ago

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?

j / k navigate · click thread line to collapse