What problem does it solve?
This workflow provides a structured, multi-stage approach to co-authoring documentation, helping teams transfer context, refine content through iteration, and verify reader comprehension before publication.
Core Features & Use Cases
- Structured three-stage process: Context Gathering, Refinement & Structure, and Reader Testing, guiding writers from initial inquiry to final validation.
- Trigger-based activation: Offer this workflow when users mention writing docs, proposals, specs, decision docs, RFCs, or similar documentation tasks.
- Interactive Stage 1: Collect all relevant context via clarifying questions and an optional info dump; Stage 2 builds and iterates on the document section by section; Stage 3 tests the draft with a fresh reader to surface gaps.
- Optional artifacts and scaffolds: Create artifacts or files that provide a working structure with placeholders to accelerate drafting; adapt or skip stages as needed.
- Supports freeform fallback: If the user declines the structured workflow, proceed with freeform drafting.
Quick Start
Offer the structured co-authoring workflow at the start of a writing task and begin Stage 1 with clarifying questions and an initial context dump.