writing-plan-documents
Installation
SKILL.md
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.
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.