bmad-shard-doc

To split a large Markdown document, provide a valid .md source path and a writable destination folder. The skill shards the file into smaller files organized by level 2 sections, generating section files and an index.md for navigation.

Organizing unwieldy Markdown documentation is achieved through sharding, which splits monolithic files into clean section files. This process uses a deterministic document structure to ensure the output layout remains consistent and navigable.

Yes, the Markdown sharding tool creates an index.md file in the destination folder. This sharded index creation ensures there is a preserved entry point for navigating the newly generated section files.

After sharding, you should handle the original Markdown document by deleting, archiving, or keeping it. This original document handling step prevents duplicate-content confusion in your documentation repository.

The level 2 section splitting mechanism works by parsing the Markdown document tree and extracting content under each ## heading. It executes a markdown-tree-parser to explode the source file into individual section files and an index.

You need a valid .md source path and a writable destination folder to shard Markdown documents. The process validates output presence in this destination folder after generating the section files and index.