What problem does it solve? Writing documentation, proposals, and specs 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 refined iteratively, and blind spots are caught before others read the document. ## Core Features & Use Cases - Three-Stage Workflow: Context Gathering (info dumps plus clarifying questions), Refinement & Structure (section-by-section brainstorming, curation, and drafting), and Reader Testing (validating the doc with a fresh, context-free reviewer). - Iterative Section Drafting: For each section, generates clarifying questions, brainstorms 5-20 candidate points, curates with the user, then drafts and refines via targeted edits. - Reader Testing: Predicts questions real readers would ask and tests the document against a fresh Claude instance or sub-agent to surface ambiguity, false assumptions, and contradictions. - Use Case: A product manager drafting a decision doc for a new architecture uses this workflow to dump context, build each section collaboratively, and verify the final doc answers stakeholder questions before circulating it. ## Quick Start Ask the assistant to guide you through co-authoring a decision doc or technical spec using the structured three-stage workflow.
