harness-shard-doc

Split a large markdown document by sharding it based on level 2 (##) heading sections. The process decomposes the single file into smaller organized files and generates an index.md to summarize and link the sharded output.

Breaking down huge markdown documentation into ordered section files prevents hard-to-browse content and makes it easier for an AI coding agent to focus on the right sections. It deterministically shards the file by level-2 headings.

Shard a markdown file by validating the source path and extension, creating the destination directory, and executing the explode command. This produces smaller organized files and an index.md in the destination folder for navigation.

Yes, you can delete or archive the original markdown file after sharding. Optional original-document handling lets you remove or archive the source to avoid duplicated conflicting content once the section files are generated.

Yes, the sharding process requires executing npx with the markdown-tree-parser explode command. This dependency handles the decomposition of the source file into smaller organized files based on level 2 sections.

Shard markdown documentation when a single file becomes too huge to browse easily or when an AI coding agent needs to focus on specific sections. Splitting by level-2 headings decomposes the content for easier review and AI-context loading.