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 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 and info dumps before drafting begins. - Section-by-Section Refinement: Brainstorms 5-20 options per section, curates content with the user, and iteratively drafts using artifacts or markdown files. - Reader Testing: Validates the finished document with a fresh AI reader (sub-agent or new conversation) to catch ambiguity, false assumptions, and contradictions. - Use Case: A product manager needs to write a decision doc for a new architecture. The Skill gathers stakeholder context, drafts each section through brainstorming and curation, then tests the doc with a fresh reader to verify it stands on its own. ## Quick Start Ask the assistant to guide you through writing a technical spec or decision doc using the structured co-authoring workflow.
