For AI agents: a documentation index is available at /llms.txt — markdown versions of all pages are available by appending index.md to any URL path.

Microblog

I have taken tomorrow off, so today is my Friday

AIAgents

I have taken tomorrow off, so today is my Friday and here's what I'm thinking about in agent experience this week:

Making your product good for agents is a team sport. It's not just a todo item for one function or role. You need:

  • Product managers to understand and communicate effectively about their products; who it's for, what purpose it serves
  • Engineers to build agent-friendly APIs with clear documentation inline and recoverable details in error messages
  • Documentarians to create clear written assets about how to use the product - maybe it's docs, maybe it's in the repo, or wherever you write about it
  • Product marketing to align messaging with product managers, engineers, and documentarians, because marketing drives some discoverability axes and it's important to communicate consistently about what the product is and does across all channels
  • Agent-focused team members to think about what an agent may need across all the available agent primitives; skills, plugins, MCP, or harness- and model-specific mitigations

To get all these folks working together on this, you have to communicate effectively about what each role is responsible for, and create a coherent strategy across the roles. You need them to understand why it's important and why they should add more todo items to their already busy workloads. And you need a higher-level message that's easy for executive stakeholders to understand; it's more than "just add a skill."

All microblog posts · RSS