Atlas
Plain EnglishHow-to

How to Run a First AI Coding Agent Pilot: A Plain Guide

Thinking of trying an AI coding agent? Pick the right first project, set a pass/fail test, cap the risk and decide after two weeks. A plain-English guide.

The short version

  • Run your first AI coding agent project as a small, time-boxed pilot with a written pass/fail test, not as a company-wide bet.
  • Pick a first task that is useful but low-stakes, easy to describe and easy to check, such as an internal tool or a small improvement to an existing product.
  • Write down before you start what 'done' looks like as checks the agent can run, because an agent stops when the work merely looks finished.
  • Keep the risk small: use test data instead of real data, and keep a person in charge of anything that goes live, spends money or deletes things.
  • At the end, judge the pilot on working software you could verify, your own time spent, and what it cost, then decide to stop, repeat or widen it.
On this page
  1. The short version
  2. What is an AI coding agent pilot?
  3. How do I pick the first project?
  4. How do I write down what "done" means?
  5. Should the agent ask me questions first?
  6. How do I keep the risk low?
  7. What will it cost, and how much of my time?
  8. How do I judge the pilot?
  9. Where does Atlas fit?
  10. Conclusion
  11. Questions people ask

If you are deciding whether to try an AI coding agent, do not start with your most important product. Start with a small pilot: one real but low-stakes task, a clear test for "done", a fixed time box of about two weeks, and a decision at the end. That gives you evidence from your own work instead of someone else's demo.

This guide is for people who do not write code: founders, product owners, analysts, testers, managers and agency owners. It walks through how to choose the first project, how to brief it, how to keep the risk low and how to judge the result.

What is an AI coding agent pilot?

An AI coding agent is a program that does more than answer questions. Anthropic's documentation says Claude Code can read your files, run commands, make changes and work through problems on its own while you watch, redirect or step away.

A pilot is a deliberately small trial of that. You are not buying a result yet. You are finding out three things:

  • Can it produce work you can verify?
  • How much of your own time does it need?
  • What does it cost, and is the cost predictable?

Treat it like trying a new contractor on a small job before giving them a big one.

How do I pick the first project?

The best first project sits in the middle. It should matter enough that you care about the result, and be small enough that a bad result costs you little.

Good first projects:

  • An internal tool. A page that turns a spreadsheet into a weekly report, or a small form that replaces an email chain. Only your own staff use it, so mistakes are cheap.
  • A small improvement to something that exists. A new field on a form, a clearer error message, a filter on a list.
  • Tests for something that has none. Anthropic lists writing tests for untested code among the tedious tasks Claude Code takes on. It is also a fairly safe task, because tests do not change what your customers see.
  • A prototype you will throw away. The point is to learn what you want, not to ship.

Poor first projects:

  • Anything that handles payments, sign-in or personal data on day one.
  • A rewrite of your core product.
  • Anything where you cannot say in two sentences what "finished" means.

A useful rule from the documentation: if you could describe the change in one sentence, it is small enough to just ask for. If you are unsure of the approach, or the change touches many files, a planning step first is worth the overhead.

How do I write down what "done" means?

This is the most important step, and it is the one most people skip.

Anthropic's best-practice guide says Claude "stops when the work looks done". Without a check it can run, "looks done" is the only signal it has, and you become the person who has to notice every mistake. Give it something that returns pass or fail and it can do the work, run the check, read the result and try again by itself.

You do not need to write the checks yourself. You need to state the outcomes in plain words:

  • "A customer who enters an invalid email sees a message and cannot continue."
  • "The weekly report totals match this spreadsheet to the cent."
  • "The new page looks like this screenshot."

Each of those can become an automatic test (a small script that reports pass or fail) or a screenshot comparison. The documentation's own example does this for an email check: it lists a few addresses that should pass and a few that should fail, and asks the agent to run the tests after building.

Ask for evidence, not assurances. The guide suggests having the agent show the test output, the command it ran and what came back, or a screenshot of the result.

Should the agent ask me questions first?

For anything bigger than a tweak, yes. The documentation suggests letting the agent interview you before it builds. It asks about technical choices, screens, edge cases (unusual situations) and trade-offs you may not have considered, then writes a specification. The guide says time spent making the spec precise pays off more than time spent watching the work.

For a non-coder this is a gift. Answering questions in your own words is easier than writing requirements from nothing, and you get a written document you can read, correct and keep.

The same guide recommends separating planning from building: let the agent read and propose a plan first, with no changes made, and approve it before it starts. Read the plan the way you would read a quote.

How do I keep the risk low?

Pilots go wrong when they are trusted too early. A few simple rules cover most of the risk.

  1. Use copies, not the real thing. Give the agent test data, not your live customer list.
  2. Keep a person in charge of the irreversible. Putting something live, spending money, deleting data and sending messages outside the company should wait for a human yes.
  3. Keep a way back. The documentation says every prompt you send that starts a turn creates a checkpoint, a saved point you can rewind to. But checkpoints only track changes made through the agent's file editing. Changes made by other commands are not captured, and the documentation says checkpoints are not a replacement for git, the standard tool for keeping a project's version history. Keep normal backups too.
  4. Do not ship what you cannot verify. The documentation names a failure pattern: the agent produces a plausible-looking result that does not handle edge cases. Its fix: always provide verification, and if you cannot verify it, do not ship it.
  5. Get a second pair of eyes. The guide notes that a reviewer starting from a fresh context is not biased toward code it just wrote, so it recommends a separate reviewer for important work. The agent that wrote something is not the best judge of it.

What will it cost, and how much of my time?

Two costs matter: the tool's cost and your attention.

The tool's cost depends on how you pay. Claude Code can be used with a Claude subscription or with an Anthropic Console account, and the two bill differently. Check your own plan's limits before you start. For a pilot, decide a ceiling in advance and look at the usage after the first few days, not at the end.

Your attention is the cost people forget. Expect to spend time on three things: answering the agent's questions, reading the plan, and checking the result. If a pilot "works" but needs you for four hours a day, that is information too.

One practical habit from the documentation saves both time and money. If you have corrected the agent more than twice on the same issue in one session (one running conversation), stop. The conversation is now cluttered with failed attempts. Clear it and start fresh with a more specific brief that includes what you learned. The guide says a clean session with a better prompt almost always does better than a long one full of corrections.

How do I judge the pilot?

Before you start, write down your yardstick. At the end of two weeks, ask:

  • Did it work? Does the software do what you listed under "done", and did you see the evidence (test results, screenshots) rather than only being told it works?
  • Could someone check it? Did a person other than the builder look at it?
  • What did it take from you? Hours spent, number of times you had to correct it.
  • What did it cost? In money or plan usage, compared with what the same work would have cost another way.
  • What surprised you? Surprises, good and bad, tell you where to be careful next time.

Then make one of three decisions: stop, repeat on another small project, or widen to something that matters more. Widening gradually is usually the safer choice.

Where does Atlas fit?

Atlas is a software team of AI engineers built on Claude Code. You talk to one of them, PA, your project assistant, in plain words, and PA shares the work out to specialists who design, build, test and security-check it. Atlas needs your own Claude account (Claude Pro or Max), and its price never includes Claude.

Several of its habits suit a pilot. One project is free on your Mac. Work is not called done until it is on the main copy of the code or queued to be, a screen has its test cases and screenshots, and the product's rules pass. Decisions such as production go-lives, spending and deleting data are never made for you. An optional daily budget warns at 50% and 80% and pauses the team at 100%.

What Atlas does not do today is choose your pilot or sum it up at the end as a trial. A one-page pilot summary, built into Atlas with nothing to set up, is something that is coming to Atlas. Until then, use the yardstick above and keep your own notes on hours, corrections and plan usage.

Conclusion

A good pilot is small, real and checkable. Pick a low-stakes task, say what "done" means in plain words, keep a person in charge of anything irreversible, cap the spend and the time, and judge the result on evidence. Two weeks of that tells you more than any demo, and it leaves you with a written record to base the bigger decision on.

Questions people ask

What is a good first project for an AI coding agent?

A small, low-stakes task that is easy to describe and easy to check, such as an internal tool, a small improvement to an existing product, or tests for code that has none. Avoid payments, sign-in or personal data on day one.

How long should an AI coding agent pilot last?

About two weeks is a sensible time box, though that is our suggestion, not a rule from any vendor. What matters is that you set the end date, the budget ceiling and the pass/fail test before you start.

How do I know the AI's work is correct if I can't read code?

Ask for evidence instead of assurances: test results, the command it ran and its output, or screenshots. Anthropic's guidance is that if you cannot verify the work, you should not ship it, and a separate reviewer starting fresh helps.

What should I do if the agent keeps getting it wrong?

Anthropic's guide says that after two failed corrections on the same issue you should clear the conversation and start again with a better, more specific brief. It says a clean session with a better prompt almost always does better than a long one full of corrections.

Sources

  1. Best practices for Claude Code
  2. Claude Code overview

Researched and drafted with Claude, then checked against the sources above. Atlas is an independent product, not affiliated with Anthropic or OpenAI. Claude and Claude Code are trademarks of Anthropic; Codex is a product of OpenAI.