Rules

Every rule has an ESLint-style name (madr/<kebab-case>) and supports the error / warn / off severities. Rules are either per-file (pure checks over one ADR) or project (cross-file integrity). Configure severities and options in your config file. A single legitimate exception does not need a config change — silence it inline with a suppression comment. Fixable rules can repair some of their violations mechanically with --fix — see each rule’s page for exactly which violations qualify.

Per-file rules

Rule	Checks	Options	Fixable	Recommended
madr/required-sections	Required heading sections are present	Yes	No	error
madr/status-enum	status is one of the allowed values	Yes	Yes	error
madr/date-iso8601	date is a valid ISO-8601 date	Yes	Yes	error
madr/filename-format	Filename matches the ADR convention	Yes	No	error

Project (cross-file) rules

Rule	Checks	Options	Fixable	Recommended
madr/no-broken-links	Relative links resolve to existing files	No	No	error
madr/no-duplicate-numbering	ADR numbers are unique	No	No	error
madr/no-numbering-gap	ADR numbers are contiguous (no gaps)	No	No	off
madr/supersedes-bidirectional	supersedes / superseded-by links agree	No	Yes	error

madr/no-numbering-gap is a convention-only rule and is off in the recommended preset — enable it if your team treats ADR numbering as a contiguous sequence.

Severity & options recap

madr-lint.config.ts

import { defineConfig } from 'madr-lint';

export default defineConfig({
  extends: ['madr-lint:recommended'],
  rules: {
    'madr/status-enum': 'warn',
    'madr/required-sections': ['error', { sections: ['Context', 'Decision', 'Consequences'] }],
    'madr/no-numbering-gap': 'off',
  },
});

See each rule’s page for its exact options, and Configuration for the severity and options format.