doc-coauthoring¶
Act as an active guide, walking users through Context Gathering, Refinement & Structure, and Reader Testing.
- Area: Foundational
- Category: documents
- Level: beginner
- Input: conversation
- Output: document
- Setup: none
- Roles:
Guide users through a structured workflow for co-authoring documentation -- outline structure, draft sections, iterate on feedback, and refine language.
How you ask¶
- “Help me draft a technical specification document”
- “Co-author a proposal document with me”
- “Help me write an RFC for our new authentication system”
- “Draft a design doc for the migration project”
Inputs¶
- request — The document to write -- type, purpose, and audience -- used to scope Stage 1 context gathering.
- template — Existing template or reference document the user has and wants the new draft's structure to follow.
- request — The revision goal -- what to tighten, restructure, or clarify in the existing draft.
- existing-draft — The draft to revise, read first so edits are targeted rather than a rewrite from scratch.
Outputs¶
- The existing draft with targeted revisions applied, without a full structural rebuild.
- The scaffolded, section-drafted, and reader-tested document produced across all three stages.
- prefer a permanent directory)