doc-coauthoring

Collaborative document writing works best through a structured workflow that separates context gathering, refinement, and reader testing. This Skill guides you through each stage systematically, ensuring documentation is complete, coherent, and actually understandable by your intended readers rather than just the authors.

Smart questioning and info-dumping efficiently transfer your knowledge to AI during the context-gathering phase. This approach clarifies what you need to document and surfaces gaps before refinement begins, making the co-authoring process more productive.

Iterative refinement builds documents section by section through brainstorming, curation, and surgical editing stages. This workflow ensures each section is well-reasoned and fits the overall structure, producing specifications and decision documents that are coherent and complete.

This structured workflow applies to documentation, proposals, technical specs, decision docs, RFCs, and similar structured content. The three-stage process—context gathering, refinement, and reader testing—works across all these document types.

Reader testing verifies that your documentation actually works for its audience, not just the authors. This final stage catches clarity issues and structural problems before publication, ensuring your proposal, spec, or decision document communicates effectively.