Wrote an example that fits only some of the readers

Writing

Situation
Asking an AI to explain an internal procedure. The readers include head-office staff and branch staff, whose rules differ.
What the AI did
It wrote the example using only the head-office deadline. Branch readers got an example that didn't apply to them.
How to ask next time (the site author's example)
"When you write an example, check whether it applies to each type of reader. If it doesn't fit some readers, remove it or give one per type."
One question to ask
What types of people read this?
Check it yourself
Read each example as someone from each reader group (another office, country, or role) and ask whether it is true for them. Dates, cutoffs, and holidays often differ by country, state, or office.
AI used (month)
Claude Code (2026-09)
Times this mistake was recorded
once
Source
The site author's notes from their own work (the original task was replaced with a different one)

Japanese version · All notes