bmad-agent-tech-writer

To generate API documentation, provide the OpenAPI specification and define your target audience. The Skill translates complex technical concepts into accessible, structured documentation, applying CommonMark and DITA best practices for clear developer handbooks.

Yes, you can create Mermaid diagrams by providing a text description of your architecture or workflow. The Skill generates visual diagrams based on your descriptions, integrating them directly into your structured knowledge bases and design specs.

The best way to write technical documentation for mixed audiences is to clearly define the audience and scope upfront. The Skill produces clear technical explanations and examples, ensuring clarity and consistency across API docs, manuals, and knowledge bases.

Yes, this technical writing approach explicitly supports DITA and CommonMark formats. It writes documents following documentation best practices and validates the output against these standards to ensure structured, accessible knowledge curation.

You validate existing documentation by submitting it for a standards review. The Skill validates documentation against best practices and standards, checking for clarity and consistency in your architectural specs and knowledge bases.

Yes, you can scan existing projects to generate brownfield architecture documentation. The Skill performs architecture scanning and brownfield analysis to produce comprehensive project documentation and architectural specs for engineering teams.