Cleanup Writing

Edit and improve a piece of writing section by section — fixing information order, improving clarity, and tightening prose — then deliver the full revised document.

Process

1. Structure the document

Divide the writing into sections based on its headings. If no headings are present, propose a logical division based on content and flow.

Before confirming the structure, check the information ordering: readers need concept A before concept B can land, so no section should assume knowledge that hasn't been introduced yet. Think of this as a dependency chain — earlier sections must establish everything that later sections rely on. Reorder or flag any sections that violate this.

2. Confirm the plan

Present the proposed section breakdown and order to the user. If the user disagrees, revise the structure before rewriting anything — rewriting in the wrong structure wastes effort.

3. Rewrite each section

For each section in order: