LLMS can generate most written content reasonably well now with the proper plumbing and standards. That is to say: not slop.

The problem is that most people don’t have / aren’t aware / don’t use said plumbing, and there is no standard as to what annoys one person but is valued by another. There may not be such a universal standard at a large enough company, or if there is, plenty enough people will disagree with it.

It might need to be targeted to a smaller group (teams). But moving towards a standards-based discussion in an Agents not Account mindset makes this discussion possible, and elevates the work output for everyone, not just agents. Some good examples of items standards discussions should include:

• What understanding from humans is missing? Is it really a documentation gap? Undocumented Tribal knowledge? Has your team just been bad at doc writing? Could someone onboard your team effectively based on your docs alone? Why would an agent?
• Are there agreed upon style/writing guides?
• How verbose? What is too much to bother with? What is absolutely necessary? Helpful? Too much?
• Should it cite traceable sources (commit hash + line)? What sources should be cited and how? Why?
• What constitutes a proper source of truth? What is the “authority” level of sources when they disagree? How and when to escalate? What are your team practices in this regard?