An agent needs an outcome and room to inspect

A coding agent is most useful when it can move beyond autocomplete: inspect the repository, run tools, make a bounded change, and verify the result. The task should define the outcome and constraints while allowing the agent to discover the implementation path from evidence.

Too little context creates guesswork. Too much procedural instruction forces the agent to follow a plan that may conflict with the code it finds. Start with the user-visible problem, relevant constraints, and the definition of done.

Use four explicit phases

Discovery maps the request to the current system. Implementation changes the smallest coherent set of files. Review checks meaning, security, and maintainability. Verification produces evidence through tests, builds, and direct product inspection.

The phases can happen in one working session, but keeping them explicit makes failures easier to locate. A build failure is different from a misunderstood requirement, and each needs a different correction.

  • Discover: inspect instructions, routes, dependencies, and nearby patterns.
  • Implement: keep the change coherent and preserve unrelated work.
  • Review: read the diff as a maintainer and as the affected user.
  • Verify: run checks that exercise the behavior and deployment target.

Parallelize research, serialize decisions

Independent investigation can happen in parallel: one agent can inspect tests while another studies deployment configuration. Mutations that touch the same boundary should stay ordered so one decision does not silently invalidate another.

The coordinating developer remains responsible for combining findings, resolving disagreement, and deciding whether the evidence is strong enough to ship.

Leave a reviewable trail

A good agentic run ends with a focused diff, meaningful commit message, validation results, and known limitations. If an external action such as deployment follows, the repository should already contain the exact change being approved or triggered.

Agentic work is not hands-off work. It is a tighter feedback loop in which tools handle more execution while people keep ownership of intent, risk, and acceptance.

What I would carry into the next build

Let agents investigate and execute within clear boundaries. Keep decisions ordered, demand direct evidence, and make the final change easy for another person to review.

Further reading

GitHub agentic workflows