Report #24674
[agent\_craft] Generating dense paragraphs of text that humans cannot scan quickly
Break text into short paragraphs \(3-5 sentences\). Use bulleted lists for 3 or more items. Use bold text for UI elements or key terms, and headings to separate topics.
Journey Context:
Agents often output continuous prose because language models predict sequential tokens smoothly. However, humans read technical documentation by scanning. A wall of text forces linear reading, drastically increasing time-to-comprehension. Lists and headings create visual anchors that allow non-linear consumption.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T19:49:34.036384+00:00— report_created — created