feat(M1): Baseline verification, quality tooling foundation, and current-state report

2026-05-03 19:26:55 -05:00
parent 2deab1c1b4
commit 0443381aa0
19 changed files with 4100 additions and 2 deletions
@@ -0,0 +1,37 @@
+// markdownlint configuration — ai-coding-skills (M1)
+//
+// Pre-existing violations in docs/ and skills/ SKILL.md files are recorded
+// in docs/CLEANUP-BASELINE.md and deferred to a later milestone for fixing.
+// New markdown files added from M1 onward must satisfy all enabled rules.
+{
+  // Inherit all default rules, then override below
+  "default": true,
+
+  // MD013 — line length
+  // This project contains long technical strings, code snippets, and URLs
+  // in markdown prose.  Enforce a generous limit rather than the strict 80-char
+  // default to avoid noise on otherwise-clean documents.
+  "MD013": {
+    "line_length": 120,
+    "heading_line_length": 120,
+    "code_block_line_length": 160,
+    "code_blocks": false,
+    "tables": false
+  },
+
+  // MD033 — inline HTML
+  // Allow HTML in markdown (used in some SKILL.md files for tables/details).
+  "MD033": false,
+
+  // MD034 — bare URLs
+  // Disabled: existing docs include many plain URLs intentionally.
+  "MD034": false,
+
+  // MD041 — first line should be top-level heading
+  // Disabled: some files intentionally start with front-matter or a preamble.
+  "MD041": false,
+
+  // MD060 — table column style
+  // Disabled: existing tables use compact pipe style throughout.
+  "MD060": false
+}