← ClaudeAtlas

diataxis-planlisted

Plan documentation architecture for a project using the Diátaxis framework. Use when organizing documentation for a new project, restructuring existing documentation, or designing a documentation strategy.
jrjsmrtn/diataxis-skills · ★ 1 · Data & Documents · score 75
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