R011 EmptySections
- Applies to
- Rules files (CLAUDE.md, AGENTS.md, .mdc, .cursorrules, Copilot instructions, GEMINI.md, .windsurfrules)
- Severity
- Warning (−4 per finding, max −30)
- Summary
- A heading has no content.
- Flags
- A heading followed by a heading of the same or higher level, or end of file, with only blank lines or comments between. Content: a deeper heading; a level-1 heading after it whose section has content (wrapper for an embedded document). Exempt: the file's first heading when it is level 1; a heading that is an instruction of four or more words or contains inline code; headings after a line ending in ":" (examples); in .cursorrules and .windsurfrules, adjacent heading lines of the same level (comment block).
- Measured false-positive rate
- 0% (0 of 7) and 0% (0 of 7), two judges, ruleset v4. Methodology
- Fixable
aibysitter fixdeletes the empty heading and the blank lines after it. CLI
Before
# Rules
## Testing
## Style
- Use tabs.
After
# Rules
## Testing
- Run `dotnet test`.
## Style
- Use tabs.
Fix
- Add the rules for this section, or delete the heading.