151
AI joys: AGENTS.md (blog.ffff.lt)
submitted 4 months ago by [M] to c/aicoding@programming.dev
152
153
154
 
 

Let’s sum it up

  1. Place documentation where both human developers and AI agents can expect it. For example, in README.md, not AGENTS.md.
  2. Prefer exposing functionality as command-line tools and APIs, which are well accessible to developers and AI agents alike, over GUI and MCP tools.
  3. Avoid parameters (command-line, environment, etc.) that segregate workflows between humans and AI agents, for example, avoid AI=true, prefer --quiet or—even better!—design your tools with limited context/mental-overload in mind.
  4. In general, avoid making workflows that are available to AI but hard to access for humans, and vice-versa.
155
 
 

Developers need the dopamine hit of creation. That’s not a perk, it’s what keeps good engineers engaged, learning, retained, and prevents burnout. The joy of coding is probably what allowed them to become experienced devs in the first place. Replace creation with oversight and you get faster burnout, not faster shipping. You’ve turned engineering, the creative work, into the worst form of QA. The AI does all the art, the human folds the laundry.

156
 
 

The most useful thing you can do right now is hold two ideas in tension simultaneously. Coding has changed dramatically. Software engineering, at its core, has not.

157
158
159
160
 
 

TL;DR: A good mental model is to treat AGENTS.md as a living list of codebase smells you haven’t fixed yet, not a permanent configuration. Auto-generated AGENTS.md files hurt agent performance and inflate costs by 20%+ because they duplicate what agents can already discover. Human-written files help only when they contain non-discoverable information - tooling gotchas, non-obvious conventions, landmines. Every other line is noise.

161
 
 

AI scales the groundwork; teams that successfully adopt AI typically already have solid foundational practices in place, while those lacking them struggle to get value from their AI investments.

162
163
You are not left behind (www.ufried.com)
submitted 5 months ago by [M] to c/aicoding@programming.dev
164
165
166
167
168
169
Harness Engineering (martinfowler.com)
submitted 5 months ago by [M] to c/aicoding@programming.dev
170
171
172
173
174
The AI Vampire (steve-yegge.medium.com)
submitted 5 months ago by [M] to c/aicoding@programming.dev
175
view more: ‹ prev next ›