hack-ops/.markdownlint-cli2.jsonc at main · jonathan-vella/hack-ops · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
{
  // Markdownlint configuration for hack-ops
  // Documentation: https://github.com/DavidAnson/markdownlint
  "config": {
    "default": true,

    // Line length configuration - 120 chars for modern displays
    "MD013": {
      "line_length": 120,
      "heading_line_length": 120,
      "code_block_line_length": 120,
      "code_blocks": false,
      "tables": false,
      "headings": true,
      "strict": false,
      "stern": false,
    },

    // === STRUCTURAL RULES (disabled for agent-generated content flexibility) ===

    // MD001: Heading levels should increment by one
    // Disabled: Agent outputs may skip heading levels for visual hierarchy
    "MD001": false,

    // MD022: Headings should be surrounded by blank lines
    // Disabled: Compact formatting in generated artifacts
    "MD022": false,

    // MD024: No duplicate heading text
    // Disabled: CHANGELOG has duplicate version entries, instruction files have repeated sections
    "MD024": false,

    // MD025: Single H1 per document
    // Disabled: Some artifacts use attribution headers before main H1
    "MD025": false,

    // MD041: First line should be H1
    // Disabled: Files may start with YAML front matter or attribution
    "MD041": false,

    // === FORMATTING RULES (disabled for flexibility) ===

    // MD009: No trailing spaces
    // Use <br> for intentional line breaks instead of trailing spaces
    "MD009": true,

    // MD026: No trailing punctuation in headings
    // Disabled: Headings like "Requirements Validation ✅" use emoji
    "MD026": false,

    // MD028: Blank line inside blockquote
    // Disabled: Multi-paragraph blockquotes in documentation
    "MD028": false,

    // MD029: Ordered list item prefix — sequential numbering (1. 2. 3.)
    "MD029": { "style": "ordered" },

    // MD030: Spaces after list markers
    // Disabled: Flexible list formatting
    "MD030": false,

    // MD031: Fenced code blocks should be surrounded by blank lines
    // Disabled: Compact code examples in documentation
    "MD031": false,

    // MD032: Lists should be surrounded by blank lines
    // Disabled: Compact list formatting in artifacts
    "MD032": false,

    // MD036: No emphasis used instead of heading
    // Disabled: **Bold** used for inline emphasis in tables
    "MD036": false,

    // MD037: No spaces inside emphasis markers
    // Disabled: Edge cases in generated content
    "MD037": false,

    // MD046: Code block style (fenced vs indented)
    // Disabled: Both styles used depending on context
    "MD046": false,

    // MD058: Tables should be surrounded by blank lines
    // Disabled: Compact table formatting
    "MD058": false,

    // MD060: Link fragments should be valid
    // Disabled: Cross-file references may not resolve during linting
    "MD060": false,

    // === HTML & RAW CONTENT (disabled intentionally) ===

    // MD033: No inline HTML
    // Disabled: HTML used for badges, anchors, and advanced formatting
    "MD033": false,

    // MD034: No bare URLs
    // Disabled: URLs in code comments and examples
    "MD034": false,

    // MD040: Fenced code blocks should have a language specifier
    "MD040": true,

    // MD051: Link fragments should be valid
    // Disabled: Dynamic links in templates
    "MD051": false,
  },

  // Glob pattern for files to lint
  "globs": ["**/*.md"],

  // Directories and files to ignore
  // Note: .markdownlintignore is NOT used - all ignores defined here
  "ignores": [
    // Package managers and dependencies
    "node_modules/**",
    "**/node_modules/**",

    // Temporary working files (gitignored)
    "Copilot-Processing.md",
    "tmp/**",

    // Python virtual environments
    ".venv/**",
    "venv/**",
    "**/venv/**",
    "**/.venv/**",

    // Build outputs
    "dist/**",
    "build/**",
    "**/*.egg-info/**",
    "__pycache__/**",
    ".pytest_cache/**",
    "coverage/**",

    // Archived content
    "archive/**",
    "mcp/azure-pricing-mcp/.archive/**",

    // Presenter/demo content (intentionally less strict)
    "docs/audit-checklists/**",
    "docs/presenter/**",

    // Agent-generated output (validated by artifact-templates validator)
    "agent-output/**",

    // Plan/prompt input files (authored externally, not deliverables)
    ".github/prompts/plan-*.prompt.md",
  ],
}