diataxis-explanation
Write, expand, or audit explanation — understanding-oriented documentation in the Diátaxis sense: discursive discussion that deepens the reader's grasp of a topic, read away from the work itself. Use whenever the user wants an architecture overview, design-rationale or "why did we build it this way" doc, concept guide, background or theory piece, ADR-style context, a "philosophy of X" or "about X" article, or asks to capture the reasoning behind a decision — even if they never say "explanation". Also loaded by the diataxis router when the compass points to cognition + acquisition: the reader wants to *understand*, as *study*. If the content is facts to consult mid-work, that's diataxis-reference; if it directs a task, that's diataxis-how-to. When the type is in doubt or mixed, consult the diataxis skill first.
Pinned to revision a943fbd893c9, so it is the text this page describes rather than whatever the author pushed since.
Files
Every link opens the file at its source, pinned to the revision this page describes.