bmad-shard-doc

Splitting Markdown documents into modular files involves parsing level 2 headers and separating content into an organized folder. This Skill processes long-form technical notes or knowledge bases, generating an index.md file to reference all sharded sections for quick navigation and reuse.

Organizing a Markdown knowledge base for easier navigation is achieved by sharding long documents into structured, modular files based on level 2 sections. This approach creates individual files for each section and builds an index.md that references all generated shards for quick overview and reuse.

To shard Markdown files by section, you need the external tool npx @kayvan/markdown-tree-parser explode. The workflow requires a valid Markdown input file and a writable destination folder, halting on errors and reporting results if these prerequisites are not met.

Markdown document sectioning for technical specifications works by deterministically parsing level 2 headers to split the content. The workflow takes a source Markdown file, separates the text at each level 2 section, and outputs individual modular files into a structured destination folder.

If the Markdown sharding workflow encounters an error, it halts immediately and reports the results. It requires a valid Markdown input and a writable destination folder to execute the deterministic parsing and file generation without interruption.