.markdownlint.jsonc

{
  // markdownlint configuration for CopilotAtelier.
  //
  // Codifies the repository's deliberate markdown house style so the editor,
  // the markdownlint CLI, and CI all lint consistently and cleanly. The repo
  // predates any lint config and intentionally uses long descriptive lines,
  // compact pipe tables, bare code fences for diagrams / trees / command
  // output, and **bold** lead-ins. Rather than reformat thousands of lines,
  // the stylistic rules the repo does not follow are disabled here; the
  // trailing-newline rule is kept and enforced.

  // -- Prose & whitespace layout (intentional) --
  "MD013": false, // line-length: long single-line changelog / memory-bank entries
  "MD012": false, // multiple consecutive blank lines
  "MD022": false, // blanks around headings (tight heading/content layout in skills)
  "MD028": false, // blank line inside blockquote
  "MD031": false, // blanks around fenced code blocks
  "MD032": false, // blanks around lists
  "MD058": false, // blanks around tables

  // -- Tables & code fences (the authoring style) --
  "MD060": false, // table-column-style: compact delimiter rows (|---|---|), 1200+ across the repo
  "MD040": false, // fenced-code-language: bare fences for ASCII diagrams / trees / output

  // -- Headings, lists, emphasis, links (house conventions) --
  "MD001": false, // heading-increment: intentional level jumps in some agent/skill docs
  "MD024": false, // duplicate headings: generic section names ("Best Practices", "Examples", changelog release types) recur by design
  "MD026": false, // trailing punctuation in headings (":" / "?")
  "MD029": false, // ordered-list-prefix: mixed / historical numbering (memory-bank decision log)
  "MD033": false, // inline HTML (README logo <picture>, etc.)
  "MD034": false, // bare URLs
  "MD036": false, // emphasis used as a heading (**bold** lead-ins)
  "MD049": false, // emphasis-style consistency (* vs _)

  // -- Low-value / shell-doc rules the repo trips by design --
  "MD009": false, // trailing spaces
  "MD014": false, // $ before shell commands without shown output
  "MD038": false, // spaces inside code spans

  // -- Correctness rules disabled to keep the baseline clean and consistent
  //    with the editor's current lenient behaviour. Flagged for a future
  //    correctness pass (real bugs, not house style): MD051 link fragments,
  //    MD056 table column count, MD041 first-line heading. --
  "MD041": false,
  "MD051": false,
  "MD056": false

  // MD047 (single trailing newline) is intentionally left enabled and is
  // auto-fixed across the repo, so trailing newlines stay consistent.
}