Does whispering to agents in docs actually help?

· Posts on passo.uno · Aug. 17, 2026, 1:53 p.m.
Summary
The blog post explores the trend of addressing agents directly in documentation and README files, questioning its effectiveness and examining user experiences. The author shares experiments conducted to analyze whether this communication style is beneficial or merely awkward, especially when instructions are also visible to human readers.
AUTHOR
Sponsored
Zulip logo Zulip
Organized team chat for people who take work seriously. Topic-based threading keeps conversations focused.
Try Zulip
Become a sponsor →
BLOG POST FEATURED ON

Add this plugin to your blog