e535f94325
Style Guide Additions: - Add Reference Structure section with 6 document types (Index, Catalog, Deep-Dive, Configuration, Glossary, Comprehensive) - Add Glossary Structure section with table-based format leveraging Starlight's right-nav for navigation - Include checklists for both new document types Reference Docs Updated: - agents/index.md: Catalog format, universal commands tip admonition - configuration/core-tasks.md: Configuration format with admonitions - configuration/global-config.md: Table-based config reference - workflows/index.md: Minimal index format - workflows/core-workflows.md: Catalog format - workflows/document-project.md: Deep-dive with Quick Facts admonition - workflows/bmgd-workflows.md: Comprehensive format, removed ~30 hr rules Glossary Rewritten: - Converted from 373 lines with ### headers to 123 lines with tables - Right nav now shows 9 categories instead of 50+ terms - Added italic context markers (*BMGD.*, *Brownfield.*, etc.) - Alphabetized terms within categories - Removed redundant inline TOC All Docs: - Remove horizontal rules (---) per style guide - Remove "Related" sections (sidebar handles navigation) - Standardize admonition usage - Archive deleted workflow customization docs Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.3 KiB
title
| title |
|---|
| Core Tasks |
Reusable task definitions that can be invoked by any BMad module, workflow, or agent.
Contents
- Index Docs — Generate directory index files
- Adversarial Review — Critical content review
- Shard Document — Split large documents into sections
Index Docs
Generates or updates an index.md file documenting all files in a specified directory.
Use it when:
- You need navigable documentation for a folder of markdown files
- You want to maintain an updated index as content evolves
How it works:
- Scan the target directory for files and subdirectories
- Group content by type, purpose, or location
- Read each file to generate brief (3-10 word) descriptions
- Create or update index.md with organized listings
Output: Markdown index with sections for Files and Subdirectories, each entry containing a relative link and description.
Adversarial Review
Performs a cynical, skeptical review of any content to identify issues and improvement opportunities.
Use it when:
- Reviewing code diffs before merging
- Finalizing specifications or user stories
- Releasing documentation
- Any artifact needs a critical eye before completion
How it works:
- Load the content to review (diff, branch, document, etc.)
- Perform adversarial analysis — assume problems exist
- Find at least ten issues to fix or improve
- Output findings as a markdown list
:::note[Unbiased Review] This task runs in a separate subagent with read access but no prior context, ensuring an unbiased review. :::
Shard Document
Splits large markdown documents into smaller files based on level 2 (##) sections.
Use it when:
- A markdown file has grown too large to work with effectively
- You want to break a monolithic document into manageable sections
- Individual sections need to be edited independently
How it works:
- Confirm source document path (must be markdown)
- Determine destination folder (defaults to folder named after document)
- Execute sharding via
npx @kayvan/markdown-tree-parser - Verify output files and index.md were created
- Handle original document — delete, move to archive, or keep
:::caution[Original File] After sharding, delete or archive the original to avoid confusion. Updates should happen in the sharded files only. :::