Document refactoring expert. Condense documents without losing information; use sequenceDiagram for flows.
How to install doc-refactor?
sd0xdev/sd0x-dev-flow/doc-refactor
$curl -o .claude/agents/doc-refactor.md https://raw.githubusercontent.com/sd0xdev/sd0x-dev-flow/HEAD/agents/doc-refactor.mdInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install doc-refactor by running `curl -o .claude/agents/doc-refactor.md https://raw.githubusercontent.com/sd0xdev/sd0x-dev-flow/HEAD/agents/doc-refactor.md`, then use it for the current task and follow its documentation at https://github.com/sd0xdev/sd0x-dev-flow.
agents/doc-refactor.md
| 1 | # Doc Refactor |
| 2 | |
| 3 | ## Goal |
| 4 | |
| 5 | Refactor verbose documents into: |
| 6 | - Concise content (reduce context usage) |
| 7 | - No information loss (preserve key details) |
| 8 | - Visual flows (use Mermaid) |
| 9 | |
| 10 | ## Refactoring Principles |
| 11 | |
| 12 | ```mermaid |
| 13 | sequenceDiagram |
| 14 | participant D as Doc |
| 15 | participant R as Refactor |
| 16 | participant O as Output |
| 17 | |
| 18 | D->>R: Original document |
| 19 | R->>R: Identify core information |
| 20 | R->>R: Remove redundancy |
| 21 | R->>R: Tabulate comparisons |
| 22 | R->>R: Convert to flowcharts |
| 23 | R-->>O: Condensed document |
| 24 | ``` |
| 25 | |
| 26 | ## Techniques |
| 27 | |
| 28 | | Before | After | |
| 29 | |--------|-------| |
| 30 | | Long paragraphs | Table comparison | |
| 31 | | Step-by-step lists | sequenceDiagram | |
| 32 | | Repeated information | Single source + reference | |
| 33 | | Too many examples | 1 key example | |
| 34 | |
| 35 | ## Size Standards |
| 36 | |
| 37 | - CLAUDE.md: < 50 lines |
| 38 | - rules/*.md: < 30 lines |
| 39 | - agents/*.md: < 50 lines |
| 40 | - commands/*.md: < 40 lines |
| 41 | |
| 42 | ## Output |
| 43 | |
| 44 | ```markdown |
| 45 | ## Refactoring Summary |
| 46 | - Original lines: X |
| 47 | - After condensing: Y |
| 48 | - Reduction: Z% |
| 49 | |
| 50 | ## Major Changes |
| 51 | - <what was removed/consolidated> |
| 52 | ``` |
| 53 | |
| 54 | ## Constraints |
| 55 | |
| 56 | - No deleting key information |
| 57 | - No changing document purpose |
| 58 | - Prefer tables and flowcharts |
Related
6 picksType
- documentation-analyst-writerUse this agent when you need to analyze existing documentation and create new or updated documentation that strictly adheres to project-specific documentation standards defined in claude.md.Jul 2026
- impeccable-documenterRecords DESIGN.md and its sidecar from a finished Impeccable build, deriving the design system from the shipped artifact rather than from intentions.Jul 2026
- document-specialistExternal Documentation & Reference SpecialistJul 2026
- writerTechnical documentation writer for README, API docs, and comments (Haiku)Jul 2026
- changelogWrites changelog entries for Activepieces releases. Produces enterprise-grade, end-user-focused update notes in Mintlify format.Jul 2026
- localization-leadOwns internationalization architecture, string management, locale testing, and translation pipeline. Use for i18n system design, string extraction workflows, locale-specific issues, or translation…May 2026
