bmad-shard-doc

To split a large Markdown document, you provide the source file path and the document is sharded by level-2 sections into individual files within a destination folder. An index.md file is also generated to provide an overview and entry point.

The best way to modularize long-form documentation is by sharding the Markdown source into level-2 sections. This process creates individual files for each section and an index.md overview, improving navigation and reuse.

Yes, you can break down a README by level-2 sections using the markdown-tree-parser. The workflow runs the parser's explode command on the source document to generate per-section files and an index.md in the destination folder.

No, you do not need to manually create an index file when sharding Markdown design notes. The workflow automatically generates an index.md in the destination folder to provide an overview and entry point for the modularized content.

Yes, sharding Markdown into separate files works for specification sheets. The workflow applies a deterministic process to split the document by level-2 sections, creating individual files and an index.md for easier navigation and reuse.