development

Giving an agent a job it can finish

Using agentic AI at work has made me notice how many decisions I leave out of a task description because they seem obvious to me.

"Sort this out" could mean fixing a bug, changing the design or replacing the implementation. Before handing it over, I need to say which behaviour is wrong and what should happen instead. An existing example in the codebase helps explain what I have in mind.

Then I need a way to check it. Describing the expected result makes the diff easier to review, especially if the agent has written more code than I expected.

I find it tempting to expand the job while it's running. It could tidy this, rename that, update something nearby. I do the same when I'm writing the code myself, and it makes the review harder either way.

Before the change is ready, I want to be able to explain it to someone who hasn't read the conversation with the agent. If I still need that conversation to understand why the code looks this way, there's context missing from the change.