Documenter Coauthoring

Structured coauthoring workflow for large docs. Pair this with documenter when the task needs sustained collaboration instead of a direct draft/update.

Core Workflow

1. Gather context efficiently:

• ask for audience, desired outcome, constraints, deadline, and template
• invite a raw context dump; do not force the user to pre-organize it
• read linked local files and existing docs before asking avoidable questions

1. Propose a structure before drafting the full doc when scope is still fuzzy

or the document is large.

1. Draft the sections with the most uncertainty first. Summary sections usually

come last.

1. Refine with surgical edits instead of reprinting the whole document on every

iteration.

1. Before finishing, do a reader test:

• check whether a reader without hidden context can follow the decision,

procedure, or reference entry

• look for missing assumptions, undefined terms, and filler that adds little

value

Decision Rules

• prefer this skill only for substantial docs; small edits should stay with

documenter alone

• defer baseline doc-type, hygiene, style, and validation rules to

documenter; this skill adds collaboration workflow

• when a template exists, align to it early instead of drafting against a

guessed structure

• ask for approval on the outline when the document shape materially affects the

content

• keep summary sections until late, after the decision and evidence are clear
• capture user preference from feedback and apply it to later sections

Exit Criteria

• the full document has a coherent structure
• section order matches reader needs
• important assumptions are stated explicitly
• repeated or low-value text has been removed
• a fresh reader can follow the document without hidden context

Examples

• Coauthor this architecture proposal with me section by section -> use

documenter plus this companion, agree on an outline, then iterate.

• Update this README command because the flag changed -> use documenter

alone; coauthoring would add process without value.