What problem does it solve? Writing documentation, proposals, and 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 for co-authoring documents with an AI, ensuring the final doc actually works for its intended audience. ## Core Features & Use Cases - Context Gathering: Collects background, constraints, and organizational context through targeted questions and info dumps 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 reader (via sub-agents or a manual fresh conversation) to catch ambiguities, false assumptions, and contradictions. - Use Case: A product manager needs to write a decision doc for a migration plan. The Skill gathers stakeholder context, drafts each section through brainstorming and curation, then tests whether a fresh reader can correctly answer likely questions about the doc. ## Quick Start Ask the assistant to guide you through the doc co-authoring workflow to draft a technical design doc for your upcoming project.
