bmad-shard-doc

Splitting large Markdown documents involves breaking them into smaller, organized files based on level-2 sections using the markdown-tree-parser. This process creates modular, section-based files for easier navigation and versioning.

Markdown sharding is the process of breaking large documents into modular, section-based files. It automatically generates an index.md to document the shard structure, allowing large product docs or internal specifications to be managed without losing context.

To shard a Markdown file, provide the source document and run the shard tool to generate a folder of sectioned files. The process validates the source, creates the destination, executes the command, verifies the output, and reports completion.

Yes, the Markdown shard workflow automatically generates an index.md file to document the shard structure. This index provides a quick reference for navigating the newly created modular, section-based files.

Yes, you can use Markdown sharding for large project specifications. It breaks long internal specifications into manageable, modular chunks based on level-2 sections, making them easier to navigate and version without losing context.

The primary limitation is that sharding relies strictly on level-2 sections to split the Markdown document. Content not organized under level-2 headings will not be separated into individual modular files, potentially affecting the final structure.