Doc Co-Authoring Workflow

Repository planning gate

When this repository's CLAUDE.md classifies the request as a complex or high-impact document task, the primary agent must invoke plan-tasks before drafting or editing the target document. A subagent must return control to the primary agent rather than create a competing plan or edit target files. Resume this workflow only after an approved docs/plans/PLAN_<descriptive-name>.md maps the relevant A-* to doc-coauthoring, its assigned role, isolation, and reader/quality verification. This workflow's context gathering and outline refine an approved action; they never replace user approval.

This skill provides a structured workflow for guiding users through collaborative document creation. Act as an active guide, walking users through three stages: Context Gathering, Refinement & Structure, and Reader Testing.

When to Offer This Workflow

Trigger conditions:

• User mentions writing documentation: "write a doc", "draft a proposal", "create a spec", "write up"
• User mentions specific doc types: "PRD", "design doc", "decision doc", "RFC"
• User seems to be starting a substantial writing task

Initial offer: Offer the user a structured workflow for co-authoring the document. Explain the three stages: