AI Instruction Diagnostics for coding agents. Validates the entire agentic instruction system against 120+ rules across six rule packs (core + per-agent). Supports Claude, Codex, Copilot, Cursor, and Gemini.
Beta phase - moving fast, feedback welcome.
npx @reporails/cli check
# or
uvx --from reporails-cli ails checkNo install, no account. Actionable findings in seconds - fix them, run again, watch the score improve:
Reporails - Diagnostics
┌─ Main (4) 61 directive / 9 constraint · 71% prose
│ CLAUDE.md 10 dir / 1 con / 1 amb · 71% prose
│ Missing tech stack declaration - list languages, frameworks, and runtimes CORE:C:0034
│ Missing MCP documentation - describe MCP server configuration if applicable CORE:C:0027
│ ... and 3 more
│ 4 brief · 1 orphan
│
└─ 181 findings
[⋯ Agents (3) · Skills (10) · Rules (13) +318 findings ⋯]
── Summary ────────────────────────────────────────────────────────
Score: 7.3 / 10 ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░ (3.9s)
Agent: Claude
Scope:
instructions: 277 directive / 448 prose (56%)
75 constraint / 10 ambiguous
Main (4): ▓▓▓▓▓▓▓▓▓▓░░░░░ 6.9 Rules (13): ▓▓▓▓▓▓▓▓▓▓▓▓░░░ 7.9
Skills (10): ▓▓▓▓▓▓▓▓▓▓▓░░░░ 7.2 Agents (3): ▓▓▓▓▓▓▓▓▓▓░░░░░ 6.9
499 findings · 5 errors · 416 warnings · 70 info
2 cross-file conflicts · 7 cross-file repetitions
npx @reporails/cli install
# or
uvx --from reporails-cli ails installPuts ails on your PATH.
Anonymous mode needs no account. Signing in raises the rate / payload caps and unlocks per-finding fix text and exact cross-file conflict locations.
# GitHub Device Flow - authorize in browser
ails auth loginFull breakdown: Tiers and Limits.
Run on every PR so instruction-quality regressions (contradictions, oversized files, weak reinforcement) get caught the same way test or lint regressions do — before merge, not after a teammate's agent has been silently misbehaving for a week.
- uses: reporails/cli/action with: api-key: ${{ secrets.REPORAILS_API_KEY }} # optional - sign-in for full diagnostic detail strict: "true" # exit 1 if any rule fires min-score: "7.0" # exit 1 if score < 7.0
Capture your API key with ails auth token and store it as REPORAILS_API_KEY in your CI secret store. See Configuration → Authentication.
- Getting Started - install, first run, what the output means
- Agent Support - which agents are recognized and what's covered
- Tiers and Limits - anonymous vs signed in, what each mode includes
- Configuration - disabling rules, project / global config, exclude paths
- Score Guide - how the score is built and what it tells you
- FAQ - common questions
BUSL 1.1 - converts to Apache 2.0 three years after each release.