What problem does it solve? Writing documentation, proposals, or specs alone often produces documents full of blind spots, missing context, and unclear sections that confuse readers. This Skill provides a structured three-stage workflow that turns document writing into a guided collaboration, ensuring the final doc actually works for its intended audience. ## Core Features & Use Cases - Context Gathering: Collects background, audience, constraints, and organizational context through targeted questions before any drafting begins. - Section-by-Section Refinement: Brainstorms 5-20 options per section, curates them with the user, then drafts and iteratively refines each section using surgical edits. - Reader Testing: Validates the finished document with a fresh, context-free reviewer (sub-agent or manual test) to catch ambiguities, false assumptions, and contradictions. - Use Case: A product manager needs to write a decision doc for a migration plan. The workflow gathers stakeholder context, drafts each section through curated brainstorming, then tests the doc with a fresh reader to confirm it stands on its own. ## Quick Start Ask the assistant to guide you through writing a decision doc using the structured co-authoring workflow.
