bmad-agent-tech-writer

Invoke the document-project capability (menu code DP) to run a brownfield analysis that scans the project and produces architecture documentation. The writer persona guides the output structure and depth based on your audience.

Use the Mermaid generation capability (menu code MG) and describe what you want visualized. The skill suggests a diagram type such as flowchart, sequence, class, or ER, then produces a Mermaid diagram in a fenced code block you can refine iteratively.

Yes, customization merges three TOML layers: the skill's customize.toml defaults, team overrides, and personal user overrides. Scalars override, arrays append, and menu items merge by code so you can replace or add capabilities.

Yes, the validate-doc capability (menu code VD) reads a document fully and reviews it against documentation standards, clarity, structure, and audience fit. It returns a prioritized list of specific, actionable improvement suggestions.

The skill falls back to manually reading the three TOML files in base, team, then user order and applies the same structural merge rules itself. Missing files are skipped, so activation continues without the script.