feat: add markdown lint infrastructure

.github/workflows/docs-analysis.yml

@@ -0,0 +1,51 @@
+name: 'docs-analysis'
+
+on:
+  push:
+    paths:
+      - 'CHANGELOG.md'
+      - '.claude/**/*.md'
+      - 'docs/**/*.md'
+      - 'package.json'
+      - 'pnpm-lock.yaml'
+      - '.markdownlint-cli2.yaml'
+      - '.github/workflows/docs-analysis.yml'
+
+    branches-ignore:
+      - release
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint-markdown:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+
+    steps:
+      - name: checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 1
+
+      - uses: jdx/mise-action@1648a7812b9aeae629881980618f079932869151 # v4.0.1
+
+      - uses: pnpm/action-setup@b307475762933b98ed359c036b0e51f26b63b74b # v5.0.0
+
+      - name: get pnpm store path
+        id: pnpm-store
+        run: echo "path=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
+        id: pnpm-cache
+        with:
+          path: './node_modules'
+          key: pnpm-${{ hashFiles('pnpm-lock.yaml') }}
+
+      - name: install dependencies
+        if: steps.pnpm-cache.outputs.cache-hit != 'true'
+        run: pnpm install
+
+      - name: lint markdown
+        run: pnpm run lint:markdown

.gitignore

@@ -78,3 +78,5 @@ app.*.map.json
 !*/extension/devtools/build/.gitkeep
 
 .mcp.json
+
+node_modules

.markdownlint.jsonc

@@ -0,0 +1,14 @@
+{
+  // Unordered list indentation
+  "MD007": {
+    "start_indented": true
+  },
+  // Dollar signs used before commands without showing output
+  "MD013": false,
+  // Line Length
+  "MD014": false,
+  // Multiple headings with the same content
+  "MD024": false,
+  // First line in a file should be a top-level heading
+  "MD041": false
+}

.pubignore

@@ -5,6 +5,12 @@ analysis_options.yaml
 devtools_options.yaml
 panache.iml
 renovate.json
+mise.toml
+package.json
+pnpm-lock.yaml
+CLAUDE.md
 
 test/
 resources/
+node_modules/
+docs/

CHANGELOG.md

@@ -29,4 +29,4 @@
 
 ## 0.0.1-dev.1
 
-* Initial release. This package is under construction.
+  - Initial release. This package is under construction.

mise.toml

@@ -0,0 +1,2 @@
+[tools]
+node = "25.9.0"

package.json

@@ -0,0 +1,20 @@
+{
+  "name": "panache",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "lint": "npm run lint:markdown",
+    "lint:fix": "npm run lint:markdown:fix",
+    "lint:markdown": "markdownlint-cli2 docs/**/*.md .claude/**/*.md CHANGELOG.md",
+    "lint:markdown:fix": "markdownlint-cli2 --fix docs/**/*.md .claude/**/*.md CHANGELOG.md"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "packageManager": "pnpm@10.11.1",
+  "devDependencies": {
+    "markdownlint-cli2": "0.22.0"
+  }
+}