Split large markdown documents into smaller, organized files based on level 2 sections using @kayvan/markdown-tree-parser tool MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER DO NOT skip steps or change the sequence HALT immediately when halt-conditions are met Each action xml tag within step xml tag is a REQUIRED action to complete that step Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution This task ONLY supports automated sharding via @kayvan/markdown-tree-parser The tool automatically handles: section splitting, heading level adjustment, code block detection, index generation All markdown formatting is preserved during sharding Check if @kayvan/markdown-tree-parser is installed globally Run: npm list -g @kayvan/markdown-tree-parser Inform user that tool needs to be installed Run: npm install -g @kayvan/markdown-tree-parser HALT with error message about npm/node requirements Ask user for the source document path if not provided already Verify file exists and is accessible Verify file is markdown format (.md extension) HALT with error message 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) Use the suggested destination path Use the custom destination path Verify destination folder exists or can be created Check write permissions for destination HALT with error message Inform user that sharding is beginning Execute command: md-tree explode [source-document] [destination-folder] Capture command output and any errors HALT and display error to user Check that destination folder contains sharded files Verify index.md was created in destination folder Count the number of files created HALT with error message Display completion report to user including: - Source document path and name - Destination folder path - Number of section files created - Confirmation that index.md was created - Any tool output or warnings Inform user that sharding completed successfully HALT if @kayvan/markdown-tree-parser cannot be installed HALT if Node.js or npm is not available HALT if source document does not exist or is inaccessible HALT if source document is not markdown format (.md) HALT if destination folder cannot be created HALT if user does not have write permissions to destination HALT if md-tree explode command fails HALT if no output files were created @kayvan/markdown-tree-parser md-tree explode [source-document] [destination-folder] npm install -g @kayvan/markdown-tree-parser Node.js installed npm package manager Global npm installation permissions Automatic section splitting by level 2 headings Automatic heading level adjustment Handles edge cases (code blocks, diagrams) Generates navigable index.md Preserves all markdown formatting