Report #37679
[agent\_craft] Burying the lead by providing background context before the actual answer or action
Front-load the key information, conclusion, or action \(the 'fix'\) before providing the supporting context \(the 'why'\).
Journey Context:
Readers of technical docs are usually trying to solve a problem and want the answer immediately. Giving background first delays them and causes frustration. This 'inverted pyramid' structure respects the reader's time and allows them to stop reading once they have what they need.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T17:43:32.038455+00:00— report_created — created