bmad-shard-doclisted

# Shard Document **Goal:** Split large markdown documents into smaller, organized files based on level 2 sections using `npx @kayvan/markdown-tree-parser`. ## CRITICAL RULES - MANDATORY: Execute ALL steps in the EXECUTION section IN EXACT ORDER - DO NOT skip steps or change the sequence - HALT immediately when halt-conditions are met - Each action within a step is a REQUIRED action to complete that step ## EXECUTION ### Step 1: Get Source Document - Ask user for the source document path if not provided already - Verify file exists and is accessible - Verify file is markdown format (.md extension) - If file not found or not markdown: HALT with error message ### Step 2: Get Destination Folder - Determine default destination: same location as source file, folder named after source file without .md extension - Example: `/path/to/architecture.md` --> `/path/to/architecture/` - Ask user for the destination folder path (`[y]` to confirm use of default: `[suggested-path]`, else enter a new path) - If user accepts default: use the suggested destination path - If user provides custom path: use the custom destination path - Verify destination folder exists or can be created - Check write permissions for destination - If permission denied: HALT with error message ### Step 3: Execute Sharding - Inform user that sharding is beginning - Execute command: `npx @kayvan/markdown-tree-parser explode [source-document] [destination-folder]` - Capture command output and any errors - If