{ "id": "ai-code-review-rules", "type": "loadout", "title": "AI code review rules", "summary": "Review-only rule files for Claude Code Review, Cursor Bugbot and Copilot, built from one list: severity, a nit cap, what to skip and what to always check.", "description": "AI code review went mainstream this autumn, and teams found each reviewer reads its own file: Claude Code Review reads\nREVIEW.md from the default branch (never from the PR), Bugbot reads .cursor/BUGBOT.md and ignores .cursor/rules, and Copilot\nuses instruction files with applyTo and excludeAgent. This loadout gives your agent the map of who reads what, rules for\nwriting review instructions that cut noise, and a skill that writes all three files from one evidence-based list.\n", "highlights": [ "Who reads what: REVIEW.md, .cursor/BUGBOT.md, Copilot instruction files", "Severity, nit cap, do-not-report and always-check sections", "Rules come from evidence: past false positives and real misses", "Reminder that REVIEW.md changes apply only after merging to a protected default branch", "Copilot review-only file with excludeAgent" ], "version": "1.0.0", "license": "MIT", "author": { "name": "Agent Loadout", "url": "https://loadout.jnw-it.com" }, "credits": [ { "title": "@Cisco_research: Code Review reads REVIEW.md from the default branch", "url": "https://x.com/Cisco_research/status/2111019382038012147" }, { "title": "@FastfixAI: .cursor/BUGBOT.md for Bugbot", "url": "https://x.com/FastfixAI/status/2096752814303174784" }, { "title": "Claude Code docs: customise Code Review", "url": "https://code.claude.com/docs/en/code-review-customize" }, { "title": "Cursor docs: Bugbot", "url": "https://cursor.com/docs/bugbot" } ], "categories": [ "workflow", "ai-agents" ], "stacks": [ "github" ], "files": [ { "path": "AGENTS.md", "role": "instructions", "description": "Where AI reviewers read rules and how to write them.", "skill": null, "agent": null, "install_to": { "claude-code": "AGENTS.md", "codex": "AGENTS.md", "cursor": "AGENTS.md", "gemini-cli": "AGENTS.md", "antigravity-cli": "AGENTS.md", "copilot": "AGENTS.md" }, "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/AGENTS.md", "raw_latest_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/latest/AGENTS.md", "bytes": 1891, "lang": "markdown", "content": "# AGENTS.md: rules for AI code reviewers\n\nThis repository is reviewed by AI reviewers (Claude Code Review, Cursor Bugbot, GitHub Copilot code review) as well as people.\nReview rules live in review-only files, separate from coding instructions, and are kept short and testable.\n\n## Which file each reviewer reads\n| Reviewer | Reads | Notes |\n|---|---|---|\n| Claude Code Review (service) | `REVIEW.md` (root, plus subdirectory files) and CLAUDE.md files | Read from the base or default branch, never from the PR. Merge rule changes first. Protect the default branch or subdirectory files and severity overrides are ignored |\n| Claude Code `/code-review` (local) | CLAUDE.md only | Does not read `REVIEW.md` |\n| Cursor Bugbot | `.cursor/BUGBOT.md` (root always; nested ones for changed paths) | `.cursor/rules` does not apply to Bugbot |\n| Copilot code review | `.github/copilot-instructions.md`, `.github/instructions/*.instructions.md` | Use `excludeAgent: \"coding-agent\"` for review-only instruction files |\n\n## Writing review rules\n- Define severity for this repo: what counts as blocking (wrong behaviour, data leak, unsafe migration) and what is a nit at most.\n- Cap nits (for example \"at most five per review\").\n- List what not to report: anything CI enforces (lint, format, types), generated paths, lockfiles, vendored code.\n- List what to always check, as concrete, checkable rules (\"new API routes have an integration test\").\n- Require evidence: behaviour claims must cite `path:line`, not infer from names.\n- One rule per line. No style essays. Under ~60 lines per file.\n- When a reviewer is repeatedly wrong about something, add a rule; when a rule never fires, delete it.\n\n## When you are the author\nBefore opening a PR, read the review files above and check your diff against the \"always check\" rules yourself.\nUse the `set-up-review-rules` skill to create or change these files.\n" }, { "path": "CLAUDE.md", "role": "adapter", "description": "Imports AGENTS.md for Claude Code.", "skill": null, "agent": "claude-code", "install_to": { "claude-code": "CLAUDE.md", "codex": null, "cursor": null, "gemini-cli": null, "antigravity-cli": null, "copilot": null }, "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/CLAUDE.md", "raw_latest_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/latest/CLAUDE.md", "bytes": 380, "lang": "markdown", "content": "# CLAUDE.md\n\n@AGENTS.md\n\n## Claude Code notes\n- Skills from this loadout live in `.claude/skills/`: `set-up-review-rules`. Use them when their description matches the task.\n- Follow AGENTS.md above; where this file and AGENTS.md disagree, AGENTS.md wins.\n\n\n" }, { "path": "GEMINI.md", "role": "adapter", "description": "Imports AGENTS.md for Gemini CLI.", "skill": null, "agent": "gemini-cli", "install_to": { "claude-code": null, "codex": null, "cursor": null, "gemini-cli": "GEMINI.md", "antigravity-cli": null, "copilot": null }, "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/GEMINI.md", "raw_latest_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/latest/GEMINI.md", "bytes": 381, "lang": "markdown", "content": "# GEMINI.md\n\n@./AGENTS.md\n\n## Gemini CLI notes\n- Skills from this loadout live in `.agents/skills/`: `set-up-review-rules`. Use them when their description matches the task.\n- Follow AGENTS.md above; where this file and AGENTS.md disagree, AGENTS.md wins.\n\n\n" }, { "path": "skills/set-up-review-rules/SKILL.md", "role": "skill", "description": "Write review files for each reviewer from one rule list.", "skill": "set-up-review-rules", "agent": null, "install_to": { "claude-code": ".claude/skills/set-up-review-rules/SKILL.md", "codex": ".agents/skills/set-up-review-rules/SKILL.md", "cursor": ".agents/skills/set-up-review-rules/SKILL.md", "gemini-cli": ".agents/skills/set-up-review-rules/SKILL.md", "antigravity-cli": ".agents/skills/set-up-review-rules/SKILL.md", "copilot": ".agents/skills/set-up-review-rules/SKILL.md" }, "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/SKILL.md", "raw_latest_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/latest/skills/set-up-review-rules/SKILL.md", "bytes": 1563, "lang": "markdown", "content": "---\nname: set-up-review-rules\ndescription: Create or tune review-only instruction files for Claude Code Review, Cursor Bugbot and Copilot code review from one rule list. Use when setting up AI code review or when reviews are noisy or miss team rules.\n---\n\n# Set up review rules\n\n1. **Collect evidence.** Read the last 10–20 AI review comments if available (`gh pr list --state merged --limit 20`,\n then `gh pr view --comments`). Note false positives, noise categories and real misses.\n2. **Write one rule list** with four sections: severity definitions, nit cap, do not report, always check.\n Start from `references/review-rules-template.md`. Every rule must come from evidence or a known team requirement.\n3. **Generate the files** for the reviewers the team uses:\n - Claude Code Review: root `REVIEW.md`; subdirectory `REVIEW.md` only for path-specific checks.\n - Cursor Bugbot: `.cursor/BUGBOT.md` with the same content.\n - Copilot: `.github/instructions/code-review.instructions.md` using `references/copilot-review-instructions.md`.\n4. **Keep coding rules out.** Rules that also apply while writing code belong in `AGENTS.md`, not in review files.\n5. **Land it.** Open a PR with only these files. Remind the human that Claude Code Review reads `REVIEW.md` from the\n default branch, so the new rules apply to PRs opened after the merge, and that branch protection is needed for\n subdirectory files and severity overrides to count.\n6. **Re-check** after a week of reviews: delete rules that never fired, sharpen rules that were misapplied.\n" }, { "path": "skills/set-up-review-rules/references/review-rules-template.md", "role": "reference", "description": "Shared review rule template.", "skill": "set-up-review-rules", "agent": null, "install_to": { "claude-code": ".claude/skills/set-up-review-rules/references/review-rules-template.md", "codex": ".agents/skills/set-up-review-rules/references/review-rules-template.md", "cursor": ".agents/skills/set-up-review-rules/references/review-rules-template.md", "gemini-cli": ".agents/skills/set-up-review-rules/references/review-rules-template.md", "antigravity-cli": ".agents/skills/set-up-review-rules/references/review-rules-template.md", "copilot": ".agents/skills/set-up-review-rules/references/review-rules-template.md" }, "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/review-rules-template.md", "raw_latest_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/latest/skills/set-up-review-rules/references/review-rules-template.md", "bytes": 838, "lang": "markdown", "content": "# Review instructions\n\n## What blocking means here\nBlocking: incorrect logic, unscoped database queries, secrets or personal data in code, logs or errors, migrations that are not\nbackward compatible, removed authorisation checks. Style, naming and refactoring suggestions are nits at most.\n\n## Cap the nits\nReport at most five nits per review.\n\n## Do not report\n- Anything CI already enforces: lint, formatting, type errors, spelling\n- Generated files under `` and lockfiles\n- Test code that deliberately breaks production rules\n\n## Always check\n- \n- \n- \n\n## Evidence\nBehaviour claims need a path:line citation from the source, not an inference from a name.\n" }, { "path": "skills/set-up-review-rules/references/copilot-review-instructions.md", "role": "reference", "description": "Copilot review-only instruction file.", "skill": "set-up-review-rules", "agent": null, "install_to": { "claude-code": ".claude/skills/set-up-review-rules/references/copilot-review-instructions.md", "codex": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md", "cursor": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md", "gemini-cli": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md", "antigravity-cli": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md", "copilot": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md" }, "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/copilot-review-instructions.md", "raw_latest_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/latest/skills/set-up-review-rules/references/copilot-review-instructions.md", "bytes": 382, "lang": "markdown", "content": "# Copilot review-only instructions\n\nSave as `.github/instructions/code-review.instructions.md`. `applyTo` limits which files the rules attach to;\n`excludeAgent: \"coding-agent\"` keeps the file away from the Copilot coding agent so it is used for review only.\n\n```markdown\n---\napplyTo: \"**\"\nexcludeAgent: \"coding-agent\"\n---\n\n\n```\n" } ], "requires": { "tools": [ "gh" ], "env": [], "mcp": [] }, "tested": { "status": "untested", "last_run": null, "fixture": null, "per_agent": { "claude-code": "untested", "codex": "untested", "cursor": "untested", "gemini-cli": "untested", "antigravity-cli": "untested", "copilot": "untested" } }, "security": { "scanned": true, "scanner": "intake-precheck/1", "verdict": "clean", "network": false, "scripts": [] }, "featured": false, "deprecated": false, "last_checked": "2026-10-17", "published": "2026-10-17", "updated": "2026-10-17", "compatibility": { "claude-code": "native", "codex": "native", "cursor": "native", "gemini-cli": "native", "antigravity-cli": "native", "copilot": "native" }, "counts": { "rules": 1, "skills": 1, "mcp": 0 }, "url": "https://loadout.jnw-it.com/loadouts/ai-code-review-rules/", "api_url": "https://loadout.jnw-it.com/api/loadouts/ai-code-review-rules.json", "verification": { "level": "verified-install", "status": "verified", "label": "Verified install", "verified": true, "checked_at": "2026-10-17T07:47:06Z", "commit": "316f4bcae9d3c1f64f8f5e32a12e27e0c36f13b5", "content_current": true, "agent_tests": "not-run", "counts": { "pass": 8, "fail": 0, "skip": 0, "not_applicable": 2 }, "meaning": "Level 1: automated checks on the files (parse, install paths, MCP config, safety scan, references, size, licence, starter build). No AI agent was run.", "checks": [ { "id": "listing", "name": "Listing", "status": "pass", "summary": "Schema valid; 6 files declared, none missing or extra", "details": [ "tested.status: untested (agent tests are separate from Level 1)" ] }, { "id": "parse", "name": "Files parse", "status": "pass", "summary": "All 6 files parse; front matter valid", "details": [] }, { "id": "adapters", "name": "Adapters", "status": "pass", "summary": "CLAUDE.md and GEMINI.md import AGENTS.md and are up to date", "details": [ "CLAUDE.md: matches the generator", "GEMINI.md: matches the generator" ] }, { "id": "install-paths", "name": "Install paths", "status": "pass", "summary": "Correct paths for all 6 agents; layouts re-discovered", "details": [ "Claude Code: 5 files, 1 skill in .claude/skills/", "Codex CLI: 4 files, 1 skill in .agents/skills/", "Cursor: 4 files, 1 skill in .agents/skills/", "Gemini CLI: 5 files, 1 skill in .agents/skills/", "Antigravity CLI: 4 files, 1 skill in .agents/skills/", "GitHub Copilot: 4 files, 1 skill in .agents/skills/" ] }, { "id": "mcp", "name": "MCP config", "status": "n/a", "summary": "No MCP servers in this loadout", "details": [] }, { "id": "safety", "name": "Safety scan", "status": "pass", "summary": "Clean: no credentials, risky shell or hidden text", "details": [ "Scanner intake-precheck/1: verdict clean; network no (listing says no)" ] }, { "id": "references", "name": "References", "status": "pass", "summary": "4 references between files resolve for every agent", "details": [] }, { "id": "size", "name": "Size limits", "status": "pass", "summary": "6 files, 5.3 KB total; largest AGENTS.md 1.8 KB", "details": [ "Limits: 30 files, 32 KB per file, 128 KB total, 500 lines per skill or rule" ] }, { "id": "licence", "name": "Licence", "status": "pass", "summary": "MIT, by Agent Loadout; text in the repository LICENSE", "details": [] }, { "id": "starter-build", "name": "Starter build", "status": "n/a", "summary": "Not applicable: review-rule templates for hosted reviewers", "details": [ "The rules are read by hosted services (Claude Code Review, Cursor Bugbot, Copilot code review) on real pull requests; there is nothing to build locally.", "Every other Level 1 check still runs on this loadout." ] } ] }, "install": { "claude-code": { "files": [ { "path": "AGENTS.md", "target": "AGENTS.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/AGENTS.md", "role": "instructions" }, { "path": "CLAUDE.md", "target": "CLAUDE.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/CLAUDE.md", "role": "adapter" }, { "path": "skills/set-up-review-rules/SKILL.md", "target": ".claude/skills/set-up-review-rules/SKILL.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/SKILL.md", "role": "skill" }, { "path": "skills/set-up-review-rules/references/review-rules-template.md", "target": ".claude/skills/set-up-review-rules/references/review-rules-template.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/review-rules-template.md", "role": "reference" }, { "path": "skills/set-up-review-rules/references/copilot-review-instructions.md", "target": ".claude/skills/set-up-review-rules/references/copilot-review-instructions.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/copilot-review-instructions.md", "role": "reference" } ], "manual_steps": [], "zip_url": "https://loadout.jnw-it.com/download/ai-code-review-rules/claude-code.zip" }, "codex": { "files": [ { "path": "AGENTS.md", "target": "AGENTS.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/AGENTS.md", "role": "instructions" }, { "path": "skills/set-up-review-rules/SKILL.md", "target": ".agents/skills/set-up-review-rules/SKILL.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/SKILL.md", "role": "skill" }, { "path": "skills/set-up-review-rules/references/review-rules-template.md", "target": ".agents/skills/set-up-review-rules/references/review-rules-template.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/review-rules-template.md", "role": "reference" }, { "path": "skills/set-up-review-rules/references/copilot-review-instructions.md", "target": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/copilot-review-instructions.md", "role": "reference" } ], "manual_steps": [], "zip_url": "https://loadout.jnw-it.com/download/ai-code-review-rules/codex.zip" }, "cursor": { "files": [ { "path": "AGENTS.md", "target": "AGENTS.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/AGENTS.md", "role": "instructions" }, { "path": "skills/set-up-review-rules/SKILL.md", "target": ".agents/skills/set-up-review-rules/SKILL.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/SKILL.md", "role": "skill" }, { "path": "skills/set-up-review-rules/references/review-rules-template.md", "target": ".agents/skills/set-up-review-rules/references/review-rules-template.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/review-rules-template.md", "role": "reference" }, { "path": "skills/set-up-review-rules/references/copilot-review-instructions.md", "target": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/copilot-review-instructions.md", "role": "reference" } ], "manual_steps": [], "zip_url": "https://loadout.jnw-it.com/download/ai-code-review-rules/cursor.zip" }, "gemini-cli": { "files": [ { "path": "AGENTS.md", "target": "AGENTS.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/AGENTS.md", "role": "instructions" }, { "path": "GEMINI.md", "target": "GEMINI.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/GEMINI.md", "role": "adapter" }, { "path": "skills/set-up-review-rules/SKILL.md", "target": ".agents/skills/set-up-review-rules/SKILL.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/SKILL.md", "role": "skill" }, { "path": "skills/set-up-review-rules/references/review-rules-template.md", "target": ".agents/skills/set-up-review-rules/references/review-rules-template.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/review-rules-template.md", "role": "reference" }, { "path": "skills/set-up-review-rules/references/copilot-review-instructions.md", "target": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/copilot-review-instructions.md", "role": "reference" } ], "manual_steps": [], "zip_url": "https://loadout.jnw-it.com/download/ai-code-review-rules/gemini-cli.zip" }, "antigravity-cli": { "files": [ { "path": "AGENTS.md", "target": "AGENTS.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/AGENTS.md", "role": "instructions" }, { "path": "skills/set-up-review-rules/SKILL.md", "target": ".agents/skills/set-up-review-rules/SKILL.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/SKILL.md", "role": "skill" }, { "path": "skills/set-up-review-rules/references/review-rules-template.md", "target": ".agents/skills/set-up-review-rules/references/review-rules-template.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/review-rules-template.md", "role": "reference" }, { "path": "skills/set-up-review-rules/references/copilot-review-instructions.md", "target": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/copilot-review-instructions.md", "role": "reference" } ], "manual_steps": [], "zip_url": "https://loadout.jnw-it.com/download/ai-code-review-rules/antigravity-cli.zip" }, "copilot": { "files": [ { "path": "AGENTS.md", "target": "AGENTS.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/AGENTS.md", "role": "instructions" }, { "path": "skills/set-up-review-rules/SKILL.md", "target": ".agents/skills/set-up-review-rules/SKILL.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/SKILL.md", "role": "skill" }, { "path": "skills/set-up-review-rules/references/review-rules-template.md", "target": ".agents/skills/set-up-review-rules/references/review-rules-template.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/review-rules-template.md", "role": "reference" }, { "path": "skills/set-up-review-rules/references/copilot-review-instructions.md", "target": ".agents/skills/set-up-review-rules/references/copilot-review-instructions.md", "raw_url": "https://loadout.jnw-it.com/raw/ai-code-review-rules/1.0.0/skills/set-up-review-rules/references/copilot-review-instructions.md", "role": "reference" } ], "manual_steps": [], "zip_url": "https://loadout.jnw-it.com/download/ai-code-review-rules/copilot.zip" } }, "source_zip_url": "https://loadout.jnw-it.com/download/ai-code-review-rules/source.zip" }