doc-coauthoring

A structured co-authoring workflow guides teams through collaborative document creation using three stages: Context Gathering, Refinement & Structure, and Reader Testing to ensure clear, readable documentation.

Start collaborative writing for technical specs by initiating Stage 1 Context Gathering, where you share your document context, goals, and initial questions with your team to transfer necessary background.

A three-stage writing process improves document readability by iteratively refining content structure in Stage 2 and verifying clarity through dedicated reader testing in Stage 3 to catch blind spots.

Yes, you can use this co-authoring workflow for decision documents and RFCs, as it automatically triggers and proposes the structured writing process when users mention writing specs, proposals, or RFCs.

The structured writing process relies on YAML frontmatter for discovery and a designated SKILL.md entry point, meaning teams must follow the strict three-stage workflow without skipping context gathering or reader testing steps.