bmad-shard-doc

To split a large markdown document, shard it into smaller files using level-2 heading boundaries. This process validates the source path, creates a destination folder, and generates section-organized files including an index.md for easier navigation.

Markdown document sharding explodes a monolithic .md file into smaller, section-organized files grouped by level 2 sections. It produces an organized output structure including an index.md, making files easier to navigate, index, and reuse.

Yes, section splitting uses npx @kayvan/markdown-tree-parser explode to deterministically generate shard files and an index.md. After verifying the generated files, you can optionally delete the original document or move it to an archive folder.

Yes, you can restructure a sprawling markdown file for retrieval-based workflows by sharding it into smaller files. This process organizes content by level-2 heading boundaries, creating an indexed structure optimized for easier navigation and retrieval.

After document sharding, the original markdown file can be deleted, moved to an archive, or kept in place. If you keep the original document, explicit warnings are applied to prevent confusion with the newly generated shard files.