What problem does it solve? Writing documentation, proposals, and technical specs alone often leads to blind spots, unclear structure, and documents that confuse readers. This Skill provides a structured three-stage workflow that turns document creation 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 structured questions and info dumps before any drafting begins. - Section-by-Section Refinement: Brainstorms 5-20 options per section, curates content with the user, drafts, and iterates with surgical edits until each section is polished. - Reader Testing: Validates the finished document with a fresh AI reader (sub-agent or manual testing) to catch ambiguities, false assumptions, and contradictions before publication. - Use Case: A product manager needs to write a decision doc for a new architecture. The Skill gathers context about stakeholders and constraints, drafts each section iteratively, then tests whether a fresh reader can correctly answer questions using only the document. ## Quick Start Ask the assistant to guide you through writing a technical spec or decision doc using the structured co-authoring workflow.
