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

1 point

4 months 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.

1 comment