Make the task observable

An agent can produce a convincing answer to a vague request. That is useful for exploring an idea, but it makes a poor contract for changing a working system. Before implementation begins, the brief needs to make the intended result observable. What should someone be able to do when the work is finished? What evidence would show that it works?

A useful brief can fit on one page. Its value comes from the decisions it records: the problem being solved, the limits of the change and the checks that will determine whether it is complete.

Describe the problem before the solution

Consider a hypothetical customer portal where staff keep exporting a spreadsheet to find overdue invoices. A request to add an AI dashboard leaves too much unresolved. A clearer brief says that staff need to identify overdue invoices, see the latest payment status and prepare a follow-up without switching tools.

That description leaves room for a sensible implementation. It also makes exclusions easier to state: this change does not collect payments, alter accounting records or send messages automatically. Boundaries give the agent useful freedom inside a defined problem.

Write checks another person could run

Acceptance checks should describe behavior, including the cases that make the task awkward. Replace phrases such as works correctly with a sequence someone can follow. A screenshot can show the intended layout; a click path can show what must happen.

  • Open an overdue invoice and confirm its amount and latest payment status are visible.
  • Record a payment in the sample data and confirm the invoice leaves the follow-up queue.
  • Prepare a reminder and confirm it remains a draft until reviewed.
  • Remove access to the payment source and confirm the page explains what could not be checked.

Keep the feedback loop short

Break the work into changes small enough to inspect. After each change, run its checks and look at the actual result before expanding the scope. This catches misunderstandings while they are still cheap to correct.

Then separate implementation from verification. Give a fresh review pass the brief and the changes, and ask it to look for failures. For visible software, include a browser walkthrough. Automated checks and a successful build provide evidence, but neither demonstrates every interaction a person will encounter.

Leave a useful record

Keep the brief beside the delivered work, with the checks performed and the important decisions made along the way. When the system changes again, that record explains why it behaves as it does.

The first agent tool is often a short document that gives the work a clear destination. Better instructions reduce the distance between a plausible result and a result someone can depend on.

A note from Route6.
A starting point for the next useful conversation.

Talk through your system ↗