revision-framework

The 3-column revision method maps each issue into Problem/Diagnosis/Fix columns, guiding you through structure, style, and mechanics edits top-down. Start by identifying structural problems, then refine style and wording, finally polish mechanics like grammar and punctuation.

Revision levels progress from Structure (organization and flow) through Style (clarity and voice) to Mechanics (grammar, punctuation, weak verbs, passive voice). Apply them sequentially to move from macro issues down to micro-level wording problems.

Yes, the 3-column revision method applies to any prose requiring revision—drafts, proposals, reports, articles, and similar text. The Problem/Diagnosis/Fix template and checklist work across content types and complexity levels.

The framework includes a checklist of common prose problems—weak verbs, passive voice, redundancy, filler—with diagnostic categories and corresponding fixes. Map each issue to the revision level where it belongs, then apply the recommended fix.

TK marks incomplete or uncertain content during drafting and revision. Use it as a flag in the Problem column when content needs verification, then resolve all TK markers before finalizing, ensuring no gaps remain in your revised text.

Yes, the framework includes house-rulebook alignment for enforcing consistent style across markdown formatting and links. Apply these rules in the Style and Mechanics levels to ensure uniform voice and presentation.