bmad-shard-doc

You can split a large markdown document into smaller organized files using level 2 headings as breakpoints. This process validates the source path, creates a destination folder, generates section files, and verifies an index file is produced.

The best way to organize long markdown manuals is section-based sharding, which breaks the source file into linked pieces by level 2 headings. This workflow ensures easier navigation and verifies output files before guiding you on archiving the original.

Yes, splitting markdown files by level 2 headings works for long-form notes, policy docs, and planning briefs. It validates the source path, confirms the destination folder, and breaks the document into manageable linked sections for easier maintenance.

Yes, you can specify a destination folder when sharding a markdown file. The workflow validates the source path, confirms the destination folder creation, splits the document by level 2 headings, and verifies the resulting output files.

After splitting a markdown file into smaller sections, the workflow guides you through handling the original file. You can choose to delete, archive, or keep the original document based on your file management preferences.

Yes, you need npx @kayvan/markdown-tree-parser to execute the explode workflow. This dependency splits the source markdown into organized section files, requires path validation, and verifies the generated index file.