Document Coauthoring

Overview

Document coauthoring is a structured workflow for creating high-quality technical documentation, proposals, specifications, and decision documents through iterative collaboration. This skill should be invoked when users want to write documentation, proposals, specs, or decision docs that require careful structuring and multiple rounds of refinement.

Core Principles

• Iteration Over Perfection: Build documents incrementally through multiple drafts rather than attempting perfection in one pass
• Reader-Centric: Always write with the target audience in mind - their expertise level, goals, and potential questions
• Structured Organization: Use clear headings, logical flow, and visual hierarchy to make documents scannable
• Testable Output: Documents should be testable by having fresh readers validate comprehension

Preparation Checklist

• Identify the document type (spec, proposal, decision doc, tutorial)
• Define the target audience and their expertise level
• Clarify the purpose - what decision should this document enable?
• Gather existing context, references, and requirements