diataxis-planlisted
Install: claude install-skill jrjsmrtn/diataxis-skills
# Diátaxis Documentation Planner
Design a documentation architecture for a project organized around the [Diátaxis](https://diataxis.fr/) framework's four quadrants.
## Diátaxis Compass
```
Practical Theoretical
+----------------+------------------+
Study | TUTORIALS | EXPLANATION |
| (learning) | (understanding) |
+----------------+------------------+
Work | HOW-TO | REFERENCE |
| (problem) | (information) |
+----------------+------------------+
```
## When to Use
- Starting documentation for a new project
- Restructuring existing documentation into Diátaxis quadrants
- Planning a documentation strategy or roadmap
- Deciding what documentation to write first
## Required Inputs
1. **Project context**: What the project does, who uses it
2. **Existing documentation** (optional): Current state to build from
3. **Audience profiles** (optional): Who reads the documentation and what they need
## Workflow
### Phase 1: Understand the Project
Read CLAUDE.md, README, and any existing documentation to understand:
- What the project does
- Who the primary audiences are
- What the current documentation state is
- What the project's complexity level is
### Phase 2: Identify Documentation Needs per Quadrant
For each quadrant, determine what documents are needed:
**Tutorials** — What do new users need to learn?
- Getting started experience
- Key workflows that need guided lear