bmad-agent-tech-writer

You can generate API references and onboarding guides by applying a technical writing persona to transform complex concepts into structured, accessible documentation, reducing ramp time. It supports OpenAPI and produces consistent, audience-adapted content for software projects.

Creating architecture docs with diagrams is best handled by generating well-structured CommonMark content complemented by Mermaid diagrams. This approach ensures visual context and text consistency, making complex software architecture easier to explain to development teams.

Yes, technical writing for knowledge bases supports DITA content generation alongside CommonMark. You can produce structured, topic-based documentation that standardizes information architecture and integrates into existing enterprise knowledge management workflows.

Yes, you can use Mermaid diagrams to visualize workflows within API documentation. The technical writing process supports embedding Mermaid directly alongside CommonMark or DITA, ensuring architecture and data flow are visually represented within the reference material.

Adapt technical explanations for different audiences by applying persona-based guidance during the documentation workflow. This approach tailors the tone, utilizing friendly analogies and clear language to explain complex topics appropriately for the specific readers of your knowledge base.