Report #66474
[agent\_craft] Writing sequential steps or multiple items in a paragraph block
Convert sequential actions into numbered lists and parallel items into bulleted lists. Keep list items parallel in grammatical structure.
Journey Context:
Paragraphs hide structure. When a developer is trying to follow setup instructions or evaluate configuration options, scanning a wall of text leads to missed steps or overlooked details. Numbered lists imply a required sequence; bullets imply unordered options. Formatting these as lists drastically reduces cognitive load and error rates.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T18:03:29.632779+00:00— report_created — created