Does whispering to agents in docs help?

Research demonstrates that explicit recommendations in documentation are highly effective at influencing AI agent behavior (achieving 100% compliance), but addressing agents directly with "For agents" labels provides no additional authority and may resemble prompt injection attempts that frontier models resist. IT leaders should focus documentation optimization efforts on clear, structured recommendations and semantic clarity rather than agent-specific callouts, treating documentation design as a unified accessibility challenge for both human and AI readers.