bmad-os-diataxis

To structure technical documentation using the Diataxis framework, you categorize content into Tutorials, How-to guides, Explanations, References, or Glossaries. This approach ensures documentation matches its specific purpose and user needs.

The best way to remove AI writing patterns from technical drafts is through targeted prose refinement. This process strips filler, rhetorical tics, and robotic phrasing while preserving technical accuracy and enforcing a human-centric style guide.

You fix disorganized documentation by applying structural fixing and prose refinement. This enforces adherence to specific structural templates and eliminates identified AI-writing patterns, ensuring the content matches the project style guide.

You need to categorize content into Tutorials versus How-to guides when aligning documentation with the Diataxis framework. Tutorials teach learning, while How-to guides guide specific task completion, ensuring clear documentation lifecycles.

Yes, you can apply Diataxis alignment to existing reference materials. The skill operates across documentation lifecycles including structural fixing, allowing you to recategorize and refine existing content into the References or Glossaries templates.