@PawelHuryn: 7 truths about working with coding agents, learned the hard way: 1. /goal is not enough. Explain the why + strategic co…

X AI KOLs Timeline Tools

Summary

An experienced developer shares 7 key insights on effectively working with AI coding agents, emphasizing the need for strategic context, documentation, and human oversight for better outcomes.

7 truths about working with coding agents, learned the hard way: 1. /goal is not enough. Explain the why + strategic context (market segments, value proposition, how you make money, etc.). Progressive disclosure. That's what enables agents to make better, more autonomous decisions. 2. To review code, agents need something to review it against. In particular, it's critical that agents document the intent, for example, roles and permissions. Without it, they may not be able to distinguish a bug from a feature. 3. Documenting the intent is also a prerequisite for reliable tests. 4. Even with browser automation, agents still can't review UX effectively, especially dynamic elements, micro-interactions, window resizing, and so on. Asking the agent to take screenshots and inspect them (exploratory testing) helps a lot, but in 2026, you still need a human eye. 5. Human code review is necessary only in the absence of strategic context and documentation. 6. If you must review something technical, review the architecture and procedures - not the syntax. How can you make your procedures, e.g., release, more deterministic? 7. You will get way better results by letting Astra and Opus/Fable work together. Neither OpenAI nor Anthropic would tell you so.
Original Article
View Cached Full Text

Cached at: 09/16/26, 04:09 PM

7 truths about working with coding agents, learned the hard way:

  1. /goal is not enough. Explain the why + strategic context (market segments, value proposition, how you make money, etc.). Progressive disclosure. That’s what enables agents to make better, more autonomous decisions.

  2. To review code, agents need something to review it against. In particular, it’s critical that agents document the intent, for example, roles and permissions. Without it, they may not be able to distinguish a bug from a feature.

  3. Documenting the intent is also a prerequisite for reliable tests.

  4. Even with browser automation, agents still can’t review UX effectively, especially dynamic elements, micro-interactions, window resizing, and so on. Asking the agent to take screenshots and inspect them (exploratory testing) helps a lot, but in 2026, you still need a human eye.

  5. Human code review is necessary only in the absence of strategic context and documentation.

  6. If you must review something technical, review the architecture and procedures - not the syntax. How can you make your procedures, e.g., release, more deterministic?

  7. You will get way better results by letting Astra and Opus/Fable work together. Neither OpenAI nor Anthropic would tell you so.

Similar Articles

The Real Truth About AI Agents

Reddit r/AI_Agents

An experienced practitioner shares hard-won lessons from deploying 25+ AI agents to production, arguing that memory, orchestration, and auditability matter far more than model choice. The article details common failure modes like context loss and silent cost loops, and recommends a stack including Claude Sonnet 4, Pydantic AI, and dedicated memory layers like Octopodas.