doc-coauthoring

name	doc-coauthoring
description	Co-author substantial proposals, specifications, RFCs, and decision documents through context, structure, and reader-focused review.
metadata	{"xopc":{"emoji":"🤝","requires_tools":["read_file","write_file"]}}

Document co-authoring

Use this workflow for substantial documentation, proposals, specifications, or decision records. Offer it as a structured option; if the user prefers a direct draft, work directly.

1. Establish context

Identify the document type, primary readers, intended decision or effect, deadline, required format, and known constraints. Invite an unstructured context dump and separate facts, assumptions, open questions, and stakeholder concerns.

2. Build the document

Propose an outline before writing long sections. Develop one section at a time, keeping alternatives and rejected options visible where they affect the decision. Use concrete ownership, dates, criteria, and dependencies instead of vague future promises.

3. Reader review

Predict the questions a reader without the author's context will ask. Check that the document answers them, that terms are defined, and that the recommendation follows from the evidence. A separate-agent reader test is optional and requires the user's approval before delegation.

Completion

Deliver a clean draft plus a short list of unresolved facts, decisions, and requested review. Do not invent citations, commitments, estimates, or approvals.

Use references/reader-review.md when performing the final reader-focused pass.