bmad-index-docs

To generate a markdown index for a documentation folder, scan the directory contents to group files by type or subdirectory, read content for brief descriptions, and output a relative-link index.md. This automates navigation and documentation discovery.

Organizing markdown files for repository navigation is best handled by scanning visible contents and producing a grouped index.md with relative links. This provides a clean folder overview and accurate file summaries without manual work.

To automatically create descriptions for files in a directory index, read the actual content of each document to write concise, accurate summaries. This content-aware approach ensures the generated index.md reflects true file contents.

You can update an existing index.md with relative links by scanning the target workspace directory for new markdown files and regenerating the sorted listings. This maintains accurate documentation discovery without manual edits.

Directory scanning for documentation indexes works without external dependencies, directly reading visible contents and markdown files to generate grouped listings. This ensures quick folder overviews in any repository environment.