What problem does it solve? Writing substantial documents like specs, RFCs, and decision docs alone often produces drafts full of blind spots, missing context, and assumptions that confuse readers. This Skill structures the co-authoring process so the final document actually works for its intended audience. ## Core Features & Use Cases - Three-Stage Workflow: Walks through Context Gathering, Refinement & Structure, and Reader Testing with clarifying questions at each step. - Section-by-Section Drafting: Brainstorms 5-20 options per section, curates them with the user, then drafts and iteratively refines using surgical edits. - Fresh-Reader Testing: Validates the finished document with a context-free reader (sub-agent or manual test) to catch ambiguity and hidden assumptions. - Use Case: A engineer needs to write a decision doc for a migration plan. The Skill gathers organizational context, scaffolds sections from the decision-doc template, drafts each part iteratively, then tests whether a fresh reader can explain the decision back accurately. ## Quick Start Ask the assistant to help you co-author a decision doc using the structured doc-coauthoring workflow, starting with context gathering.
