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 deliberately refined, and blind spots are caught before others read the doc. ## Core Features & Use Cases - Three-Stage Workflow: Context Gathering with clarifying questions, section-by-section Refinement & Structure with brainstorming and curation, and Reader Testing with a fresh AI instance to catch ambiguities. - Iterative Section Drafting: For each section, generates clarifying questions, brainstorms 5-20 candidate points, curates with the user, then drafts and refines through surgical edits. - Reader Testing: Predicts questions real readers would ask and validates the document against them using sub-agents or a fresh conversation, surfacing assumed knowledge and contradictions. - Use Case: A product manager needs to write a decision doc for a technical migration. The Skill gathers project context, drafts each section through structured iteration, then tests the finished doc with a context-free reader to ensure it stands on its own. ## Quick Start Ask the assistant to help you write a decision doc or technical spec using the structured co-authoring workflow.
