What problem does it solve? Writing documentation, specs, and proposals alone often produces documents that make sense to the author but confuse readers, because the author's context never makes it onto the page. This Skill structures the co-authoring process so context is transferred, sections are refined iteratively, and blind spots are caught before publication. ## Core Features & Use Cases - Three-Stage Workflow: Context Gathering (info dumps and clarifying questions), Refinement & Structure (section-by-section brainstorming, curation, and drafting), and Reader Testing (validating the doc with a fresh, context-free reader). - Document Templates: Includes ready-made templates for technical specifications, decision documents (ADRs), PRDs, and RFCs in the references directory. - Reader Testing Prompts: Provides discovery, comprehension, ambiguity, and consistency-check prompts to verify the document works for its intended audience. - Use Case: A product manager needs to write a decision doc comparing two architectural approaches. The Skill gathers stakeholder context, brainstorms options per section, drafts the doc iteratively, then tests it with a fresh reader to catch unexplained assumptions before sharing with the team. ## Quick Start Ask the assistant to guide you through co-authoring a decision document for an upcoming technical choice, starting with a context dump about the problem and constraints.
