Working with coding agents, organically teaching your colleagues has been replaced by systems thinking.

Coding models don’t learn (yet), but you can build the lessons you want to teach into the model’s developer experience, context engineering, workflow orchestration, instructions, and so on. All of that stuff makes up your “agent” and most of it is radically improveable.

I see people are flooding projects with markdown files (sure, I have some too 😂), but it feels like a local optima to me:
– There are better ways for coding agents to learn
– There are more impactful ways to improve your agent’s own DX
– There are even better ways to document your software

I’m happy we are speed-running the journey to good software engineering practices (it gets faster every time!), but that also means rehashing some of the old debates – debates that were already settled in my circles.