{
  "markdown": "# diataxis\n\nA Claude Code plugin that surveys a project, plans a Diátaxis documentation system, and rewrites the approved documents one at a time.\n\n## What is Diataxis?\n\n[Diataxis](https://diataxis.fr) is a framework for classifying documentation by purpose, and using that classification to identify gaps and plan improvements. This plugin implements the Diataxis framework as a structured process for improving your project's documentation.\n\nThis plugin is designed as an orchestrated documentation rewrite. It surveys your project, produces a plan, waits for approval, then rewrites your documentation one document at a time. Each document is validated and routed to the correct type-specific writer based on its Diataxis classification.\n\nFeatures:\n\n- Comprehensive survey of your project's documentation\n- Structured gap analysis and improvement plan based on the Diataxis framework\n- Document-by-document implementation through type-specific Diátaxis writers\n\n## Installation\n\n```bash\nclaude plugin install https://github.com/andrabis/diataxis\n```\n\n## Usage\n\nRun from any project directory:\n\n```\n/diataxis:document\n```\n\nThe plugin reads your codebase, classifies existing documentation, produces a structured plan, and waits for approval before writing. After approval, `diataxis:document` sends each planned document to `diataxis:write-doc`, which validates the document context and routes to the correct writer.\n\n## Skills\n\n| Skill                   | Purpose                                                                                          |\n| ----------------------- | ------------------------------------------------------------------------------------------------ |\n| `diataxis:document`     | Entry point. Survey, plan, request approval, then orchestrate document implementation.           |\n| `diataxis:survey`       | Survey the codebase and write `docs/diataxis/plan.md`. Run standalone if you only want the plan. |\n| `diataxis:write-doc`    | Validate one planned document context and route it to the right writer.                          |\n| `diataxis:tutorial`     | Write beginner-focused tutorials.                                                                |\n| `diataxis:how-to-guide` | Write task-focused how-to guides.                                                                |\n| `diataxis:reference`    | Write neutral, structured reference documentation.                                               |\n| `diataxis:explanation`  | Write conceptual explanation documentation.                                                      |\n",
  "bytes": 2574,
  "sha": "f622c9ce42cd7a9dc7648e2a80d0baddb6e7abd07569177d0b8011a05691c1b0",
  "repo_slug": "hrsandrabi/diataxis",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_hrsandrabi_diataxis_diataxis_b5025834/readme"
}