writing-plan-documents

Writing Plan Documents

Apply this prose layer within the task's chosen planning workflow. Inherit the active model and reasoning effort.

• Write for someone who has not seen the conversation. Lead with the goal and decisions; follow with the rationale needed to assess them.
• Use plain language, concrete actions and accurate uncertainty. Remove filler, inflated adjectives, theatrical reveals, contrastive setups and summaries that repeat the preceding text.
• Include only sections that help the reader act: scope, approach, dependencies, risks, unresolved decisions and acceptance criteria as relevant. Preserve another workflow's required structure.
• For an unresolved decision, name the choice, viable options and tradeoffs, then recommend an option when evidence supports it. Do not invent alternatives for settled or trivial choices.
• Sequence milestones by dependencies and outputs. Preserve real deadlines or a requested schedule; label uncertain estimates and separate coding time from review or rollout elapsed time. Do not fabricate calendar commitments.
• Keep lists for parallel items and prose for relationships. A heading or paragraph must add information.
• For a long document, write a skeleton first, then add or edit one section per write so no single response approaches the output limit.

Examples: “To” replaces “In order to facilitate.” “The content is the problem” replaces “This isn't a checkout problem. It's a content problem.” Preserve technical terms and domain-specific constraints that matter.