bmad-agent-tech-writer

Technical documentation for complex engineering projects is transformed into clear, task-oriented guides, README files, and API references. The process applies structured writing, audience-aware simplification, and standards like CommonMark, DITA, and OpenAPI to ensure precision and readability for product and engineering teams.

Explaining a technical concept with diagrams uses visual communication standards like Mermaid to replace dense prose. This approach generates concept explanations with examples and visual aids when diagrams communicate complex mechanisms more clearly than text alone.

Reviewing an existing README for clarity and audience fit is fully supported through documentation review and refinement. The process validates documents against best-practice alignment, ensuring technical accuracy while optimizing precision and readability for the intended audience.

OpenAPI and DITA standards are supported alongside CommonMark and Mermaid. This allows the skill to generate structured project documentation, API references, and visual diagrams that align with established technical writing and knowledge management workflows.

Task-oriented documentation for project knowledge workflows is needed when teams require structured guides, specifications, or concept explanations drafted from raw technical artifacts. It turns complex project context into usable documentation for product, engineering, and project management purposes.