bmad-shard-doc

To split a large markdown document, this skill parses level 2 headings using the npx @kayvan/markdown-tree-parser tool to generate individual section files. It breaks down unwieldy project documentation into manageable, editable chunks to prevent slow load times and merge conflicts.

Markdown document sharding is the process of dividing a large file into smaller organized files based on section headings. You need it when extensive product requirements or technical specifications become unwieldy to navigate, edit, and collaborate on.

Yes, you need npx to run the @kayvan/markdown-tree-parser tool, which automatically parses the markdown structure. This dependency is required to generate indexed section files without any manual formatting.

You navigate a sharded markdown project using the central index.md file that is automatically generated during the splitting process. This index file links to all sharded sections, providing easy navigation across the newly created individual files.

No, this skill specifically splits markdown files into organized files based on level 2 section headings. It does not mention support for parsing other heading levels for document sharding.