How to Describe a Task to a Coding Agent

The quality of what comes back depends far more on the brief than on the tool. A precise task description gives you a result you can review in a minute; a vague one gives you something that looks plausible and is wrong in ways you have to hunt for.

There is no special syntax to learn. You write the task the way you would brief a colleague.

Say three things

  1. The goal. What should be true when this is finished?
  2. What matters. Which files, screens or features are involved — and which ones must stay untouched.
  3. What finished looks like. How you will judge whether it worked.

That is the whole method. Everything below is detail on those three.

Concrete beats vague

The difference is usually not length, it is specificity:

VagueConcrete
“Fix the login.”“The login form on the settings page rejects valid passwords. Find out why and fix it. Do not change the signup flow.”
“Clean up the styles.”“The buttons on the pricing page use three different paddings. Make them consistent with the primary button on the homepage.”
“Improve performance.”“The project list takes several seconds to appear. Find what is slow and tell me what you would change before you change it.”

The right-hand versions share one property: a stranger could tell whether the work is done. That is the test.

Why this matters more with an agent than with a search box

A coding agent does not just answer — it plans, then edits. It explores the relevant files, breaks the task into steps, makes the changes, then checks its own work and reports what it changed.

A vague goal produces a vague plan, and a vague plan produces edits you have to review one by one to find out what it thought you meant. A precise goal shapes the plan before a single file is touched.

You do not need to write code

You do need to be precise about outcomes. “It should stop asking me to log in twice” is a perfectly good brief — it describes behaviour, not code.

If you are unsure what the right fix is, say so in the task. Asking the agent to explain what it would change before it changes anything is a legitimate brief, and often the fastest way to find out whether you and it understand the same problem.

What happens to your files while it works

Worth knowing before you hand over a real project:

  • The agent works inside the workspace folder you opened.
  • Every change comes back to you before it lands. You read the diff and approve or reject it.
  • Anything reaching outside the workspace needs your explicit approval.
  • Irreversible actions are shown to you for review first.
  • Nothing is committed to version control unless you say so.

So a good brief does not remove your control — it makes that review fast.

Where to go next


HarnessLaunch runs DeepSeek Harness on Windows with one click. $4.57, paid once, no subscription. No account, no activation code. If it does not work on your machine, you get every cent back within 14 days.

Download HarnessLaunch · Buy now for $4.57

Leave a Comment