bmad-agent-tech-writer

Technical documentation organizes scattered project context into reader-focused output by loading project context, applying audience-aware writing, and producing structured Markdown. This ensures complex systems and workflows are easily understood by new contributors.

Documenting a brownfield codebase requires curating existing project knowledge and applying audience-aware language. Using task-oriented technical writing structures helps explain subsystems clearly to new engineers without overwhelming them with clutter.

Mermaid diagrams are supported to visually explain complex project workflows when visual communication is clearer than prose. Creating or recommending these diagrams helps technical teams understand intricate systems and decisions more effectively.

Validating technical documentation involves reviewing existing content for clarity, structure, and best practices. This document review process ensures design notes and shared knowledge remain accurate and readable before being distributed broadly to teams.

Structured Markdown handling is fully supported for complex knowledge curation. This allows you to capture project context, keep important facts organized, and preserve shared understanding for future contributors using standardized formatting.