diataxis-documentation-architect

The Diátaxis Framework is a documentation architecture approach that divides content into four distinct modes: tutorials, how-to guides, references, and explanations. This Skill automates documentation design by ensuring each section serves a single, clear purpose without mixing modes.

You structure technical documentation by applying the Diátaxis Framework quadrants: tutorials for learning, how-to guides for tasks, references for information, and explanations for understanding. This Skill provides tailored templates and voice guidelines for each quadrant to automate the design process.

Yes, you can generate a tutorial outline for a software engineering project. This Skill automates the creation of user-facing content outlines and documentation structures specifically tailored to the tutorial quadrant of the Diátaxis Framework.

Yes, the documentation architect supports persona-based interactions. It integrates with a dedicated agent to automate documentation design and creation, ensuring the content structure and voice align with specific user personas within the Diátaxis Framework.

The best way to audit existing documentation is to evaluate its clarity and purpose against the four Diátaxis Framework quadrants. This Skill helps you efficiently audit and design content, ensuring each document fits neatly into tutorials, how-to guides, references, or explanations.

You should not use the Diátaxis Framework for content creation when your documentation requires mixing modes, such as combining a learning tutorial with reference material in a single document. This framework enforces strict separation to maintain clarity and purpose.