bmad-shard-doc

You can shard large Markdown files by running the markdown-tree-parser explode command via npx, which generates an index.md file and breaks the document into level-2-based section files within a new folder.

The best way to break down long wiki-style documentation is document sharding, which splits the content into level-2-based chunks. This process generates an index.md file and individual section outputs, significantly improving navigation and maintenance.

Yes, you can control the original file after sharding by choosing to delete it, move it to an archive folder, or keep it in place. The Skill enforces explicit warnings during this cleanup control process.

No dependencies are required because the Skill executes the markdown-tree-parser explode package dynamically via npx. It validates inputs and verifies index.md creation without requiring prior package installations.

Splitting Markdown documentation into level-2-based chunks solves the problem of large files being hard to navigate, search, and maintain. It transforms a single long document into smaller knowledge units, enabling easier indexing and reuse across wiki-style content.