ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/tools/markdown
History
Keimpe de Jong 49b97b824f PR #830 - Code Quality & Markdown Tooling 
Tooling Created:
- tools/markdown/check-md-conformance.js - Multi-rule checker with CI exit codes
- tools/markdown/fix-fence-languages.js - Auto-fixer with dry-run support, handles 3+ backtick fences

Configuration Updates:
- eslint.config.mjs - Added .patch/** to global ignores
- package.json - Added 7 markdown check scripts, integrated into pre-release pipeline

Code Quality Fixes:
- 580 Prettier formatting violations fixed across entire codebase
- 11 ESLint violations fixed in markdown tools
 		2025-10-29 06:40:39 +00:00
..
README.md chore(markdown): add conformance tooling, CI, and fix docs (phase 1) 2025-10-29 03:52:46 +00:00
check-md-conformance.js PR #830 - Code Quality & Markdown Tooling 2025-10-29 06:40:39 +00:00
fix-fence-languages.js PR #830 - Code Quality & Markdown Tooling 2025-10-29 06:40:39 +00:00

README.md

Markdown Conformance Checks

A small CommonMark-oriented conformance checker to validate BMAD markdown output for:

  • Blank line before/after bullet and numbered lists
  • Blank line before/after tables
  • Blank line before/after fenced code blocks
  • Bullet marker normalization to -
  • Code fence language presence (e.g., ```bash)

Run

From the repo root:

node tools/markdown/check-md-conformance.js docs/ bmad/ src/ .patch/830
  • Provide one or more files or directories. Directories are scanned recursively for .md files.
  • Exit code is 0 when no violations are found; 1 otherwise.

Notes

  • The checker ignores content inside fenced code blocks.
  • Table detection is heuristic (lines with |); it’s sufficient for CI-style checks.
  • This tool does not fix files; it only reports violations.