bmad-shard-doc

To split a large Markdown document, this Skill divides content automatically by level-2 headings into a destination folder and generates an index.md to provide a consolidated entry point for the shards.

Yes, sharding Markdown files requires a Node.js-based workflow using npx @kayvan/markdown-tree-parser to explode the source document and produce the section-level files in the destination folder.

The best way to organize long-form technical guides for navigation is sharding them into focused sub-files based on level-2 sections, which allows users to browse and version the documentation incrementally.

Yes, you can use this Markdown organization approach for knowledge bases, design docs, and long-form specifications that must be browsed or versioned incrementally by sharding them into section-based files.

The generated index.md works as a consolidated entry point that links to the individual section-based shard files produced when the Markdown document is exploded by level-2 headings into the destination folder.