.markdownlint.yml

# Markdownlint configuration for StatsClaw for Codex
# See: https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md

default: true

# Allow long lines — agent definitions and AGENTS.md have long table rows and URLs
MD013: false

# Allow duplicate headings — different skill files reuse section names
MD024: false

# Allow HTML — we use <!-- filename: ... --> comments in templates
MD033: false

# Allow trailing punctuation in headings
MD026: false

# Allow multiple top-level headings
MD025: false

# Don't require first line to be a heading — templates may start with frontmatter
MD041: false

# Allow bare URLs
MD034: false

# Code blocks without language specifiers — many blocks are pseudocode or generic config
MD040: false

# Allow code blocks without surrounding blank lines — skill definitions nest code in lists
MD031: false

# Allow headings without surrounding blank lines — compact formatting in skill files
MD022: false

# Allow non-sequential ordered list numbers — we use intentional numbering
MD029: false

# Allow table column count mismatches
MD056: false

# Allow table column style variations
MD060: false

# Allow lists without surrounding blank lines — compact formatting in templates and skills
MD032: false

# Allow bold text as sub-headings — handoff skill uses **bold** for pipeline labels
MD036: false