bmad-shard-doc

To split a large markdown document, this Skill sections the file by level 2 headings and generates smaller files in a destination folder along with an index.md for navigation. It uses the npx @kayvan/markdown-tree-parser explode command to perform the breakdown.

Organizing a long markdown knowledge base is done by sharding the document into focused, section-based files using level 2 headings as boundaries. This process creates a destination folder with an index.md file, enabling targeted reuse and faster review of individual subsections.

Sharding markdown files in a BMAD workflow involves validating the source path, creating a destination folder, and running npx @kayvan/markdown-tree-parser explode with the provided paths. The Skill then verifies the output files and prompts for a delete or archive decision for the original document.

No, this markdown sharding tool does not delete the original document automatically. It forces an explicit user choice to delete, archive, or keep the original file after verifying the sharded output, ensuring operational safety and preventing duplicated sources.

Yes, you can use npx @kayvan/markdown-tree-parser explode via this Skill to refactor documentation into individual sections. It splits the source markdown by level 2 headings, outputs the focused files into a confirmed destination folder, and generates an index.md for easy navigation.

A limitation of sharding markdown by level 2 sections is that content is strictly divided by level 2 headings as boundaries. It requires validating the source markdown extension and path beforehand, and any content not under a level 2 heading may not be optimally organized into the destination folder.