bmad-shard-doc

You can split a markdown document into smaller files by using this Skill to parse the file structure and explode level 2 sections into individual files within a specified destination folder. It creates a dedicated output folder including an index.md for easy navigation.

The best way to break down a lengthy technical specification is to shard the markdown document by its level 2 sections. This process creates organized, smaller files that make it easier for team members to find and reference specific parts of the documentation.

Yes, you need the markdown-tree-parser tool to shard documents by section. This dependency is required to parse the markdown document structure and explode it into individual files within a specified destination folder.

Yes, the document splitting tool creates an index.md file for the sharded files. When it divides the large markdown document into smaller files based on level 2 sections, it organizes them in a dedicated folder with an index for easy navigation.

No, you cannot divide markdown content based on level 3 headings. The Skill specifically splits large markdown documents into smaller, organized files based exclusively on their level 2 section structure to ensure consistent document sharding.

You shard markdown files to improve content organization and manageability. Dividing large documents into smaller files based on section structure makes it significantly easier to navigate, reference, and access specific parts of the documentation.