the-rewrite-room

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: the-rewrite-room
description: Use when auditing docs vs code drift, syncing docs after changes, optimizing CLAUDE.md or SKILL.md for AI consumption, validating GLFM and Markdown, or summarizing files/URLs/images — routes each task to the correct specialist agent via /rwr:audit, /rwr:optimize, or /rwr:author
allowed-tools: Read, Grep, Glob, Bash, Task, Write, Edit
---

# The Rewrite Room

Routes documentation, authoring, and optimization tasks to the correct specialist agents. Does not rewrite source agents or skills — orchestrates them. Governs authoring, docs, prompts, and summaries — not product code.

## Non-Negotiable Writing Standard

Any prose that this plugin authors, rewrites, or materially restructures MUST follow the anti-slop rules in `plugins/the-rewrite-room/the-rewrite-room/references/stop-slop-rules.md`.

Apply that reference to:

- user-facing docs produced via `/rwr:author`
- AI-facing prompts and skill prose improved via `/rwr:optimize`
- citation-driven writing produced via `/rwr:cite`
- generated skill prose produced via `/rwr:doc-to-skill`

Exception: preserve source wording inside direct quotes and do not distort extractive summaries just to satisfy house style.

## Quick Start

```text
/rwr:audit "check if kaizen plugin docs match the code"
/rwr:optimize "plugins/plugin-creator/skills/add-doc-updater/SKILL.md"
/rwr:author "summarize plugins/summarizer/skills/summarizer/SKILL.md"
```

## Command Reference

| Command | Entry Agent | Use When |
|---------|-------------|----------|
| `/rwr:audit <task>` | rewrite-room-auditor | Docs vs code drift, doc sync after changes, freshness tracking |
| `/rwr:optimize <file>` | rewrite-room-optimizer | CLAUDE.md, SKILL.md, agent .md improvement |
| `/rwr:author <task>` | rewrite-room-author | User-facing docs, GLFM validation, summarization |
| `/rwr:cite <source URL> [key points] [content type]` | rewrite-room-cite | Source-attributed content writing with hyperlinked citations from URLs |
| `/rwr:doc-to-skill <docs_path> <output_plugin> <output_skill>` | rewrite-room-doc-converter | Convert user-facing docs directory into a Claude Code skill |

Each command loads the corresponding workflow file and follows its numbered steps.

## Workflow Index

```mermaid
flowchart TD
    User([User invokes /rwr:*]) --> Q{Which command?}
    Q -->|/rwr:audit| Audit[rewrite-room-auditor\nLoads: plugins/the-rewrite-room/the-rewrite-room/workflows/audit.md]
    Q -->|/rwr:optimize| Opt[rewrite-room-optimizer\nLoads: plugins/the-rewrite-room/the-rewrite-room/workflows/optimize.md]
    Q -->|/rwr:author| Auth[rewrite-room-author\nLoads: plugins/the-rewrite-room/the-rewrite-room/workflows/author.md]
    Q -->|/rwr:cite| Cite[rewrite-room-cite<br>Source-attributed content with citations]
    Q -->|/rwr:doc-to-skill| DocSkill[rewrite-room-doc-converter<br>Loads: plugins/the-rewrite-room/skills/user-docs-to-ai-skill/SKILL.md]
    Audit --> A1[development-harness:doc-drift-auditor]
    Audit --> A2[development-harness:service-docs-maintainer]
    Audit --> A3[doc-freshness-guardian]
    Opt --> O1[plugin-creator:ai-doc-optimizer]
    Opt --> O2[plugin-creator:subagent-refactorer]
    Auth --> B1[gitlab-docs-expert]
    Auth --> B2[documentation-expert]
    Auth --> B3[summarizer:file-summarizer / summarizer:url-summarizer / summarizer:image-summarizer]
```

## Workflow Files

Each command agent loads the corresponding workflow file at runtime:

- Audit workflow: `plugins/the-rewrite-room/the-rewrite-room/workflows/audit.md`
- Optimize workflow: `plugins/the-rewrite-room/the-rewrite-room/workflows/optimize.md`
- Author workflow: `plugins/the-rewrite-room/the-rewrite-room/workflows/author.md`

Workflow files contain numbered steps, conditional branching, explicit agent spawn instructions, structured return handling, and output contracts.

## Adding New Workflows

Every rwr command requires four components. All four are mandatory — there are no exceptions. A command that exists in the