Instruction Files¶
Validates AI coding assistant instruction files (AGENTS.md, CLAUDE.md, GEMINI.md, QWEN.md, and Devin-compatible alternatives). Checks encoding, non-emptiness, and that supported @import references resolve to existing files. Enabled automatically when one of those files is present.
| Rule ID | Description | Default Severity | Autofix |
|---|---|---|---|
instruction-file-valid |
Instruction files (AGENTS.md and tool-compatible alternatives) must be valid and non-empty | warning (auto) | - |
instruction-imports-valid |
Import references (@path) in AGENTS.md, CLAUDE.md, GEMINI.md and QWEN.md must point to existing files | warning (auto) | - |
claude-md-agents-import |
CLAUDE.md next to an AGENTS.md should import it so both assistants read one source of truth | info (auto) | auto |