frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

fp.

Open in hackernews

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

1•cleverhoods•1w ago
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.

Comments

cleverhoods•1w 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?