What problem does it solve? Writing documentation, specs, and proposals alone often produces documents that make sense to the author but confuse readers. This Skill structures the co-authoring process so context is fully transferred, each section is deliberately refined, and blind spots are caught before others read the document. ## Core Features & Use Cases - Three-Stage Workflow: Context Gathering with clarifying questions, section-by-section Refinement with brainstorming and curation, and Reader Testing with a fresh context-free reviewer. - Iterative Section Drafting: Brainstorms 5-20 options per section, curates based on user feedback, and drafts into an artifact or markdown file using surgical edits. - Reader Testing: Predicts questions real readers would ask and validates the document against them using sub-agents or a fresh conversation to expose ambiguity and assumed knowledge. - Use Case: Draft a technical decision doc by dumping project context, curating brainstormed points for each section, then verifying a fresh reader can answer key questions correctly before sharing with the team. ## Quick Start Help me write a decision doc for our migration plan using the structured co-authoring workflow.
