Skip to content

Your First Agent Session

How to run your first Claude Code or AI-agent build session without letting it spiral into a mystery code dump.

11 min readAI-tools, beginners, agent-workflow, hands-on
Copy The Prompt First

Use the lesson prompt before you improvise

This lesson already contains a scoped prompt. Copy it first, replace the task and file paths with your real context, and make the agent stop after one reviewable change.

Matching prompts nearby

7

When you finish this lesson prompt, use the related prompt set to keep the same supervision pattern on the next task.

This lesson promptYour First Agent Session

How to run your first Claude Code or AI-agent build session without letting it spiral into a mystery code dump.

Preview
"I am on my first real AI-agent coding session.
Project: [describe project]
Current goal: [describe one small feature]
Tooling available: [Claude Code / Cursor / Codex / editor agent / terminal agent / browser preview / database / deployment]
Model available: [current model if known]
Before changing code:

This is the moment most beginners either get hooked or get burned.

You open Claude Code, Cursor, Codex, Replit, Bolt, or whatever tool you are using. You have a small idea. You have a project folder. You have a checkpoint. Now what?

Now you run the session like someone in charge, not like someone watching.

Why this matters

The first session teaches your future sessions.

If your first session is vague, sprawling, and unreviewed, you will normalize chaos. If your first session is scoped, reviewed, and tested, you will normalize control.

That difference compounds fast.

The shape of a good first session

A good first session has five moves:

  1. give the agent context
  2. set the goal or ask for a plan first
  3. approve one tiny change
  4. run and test the result
  5. checkpoint before continuing

That is enough.

The beginner Claude Code version

If Claude Code is the tool in front of you, do not start by asking it to build your app. Start by making it orient itself.

Good first commands or requests look like this:

/init
 
Read the project and explain what it does in plain English.
Do not edit files yet.

Then ask:

What are the safest first three changes for a beginner to make in this repo?
For each one, list the files likely to change, the verification step, and the reason it is low risk.
Do not edit files yet.

If the tool supports /model, look at the model before a hard task. Use the strongest available model for architecture, security, tricky debugging, and production reviews. Use cheaper or faster models for simple copy, obvious UI tweaks, and explanation. Do not anchor your workflow to a single label like "5.6" or "Fable." Model names and availability change. The durable habit is choosing the right capability for the risk.

If the tool supports /goal, set one. If it supports /loop, save that for bounded monitoring or verification, not open-ended building. If it supports checkpoints and rewind, learn the recovery path before asking for broad edits.

What Fable-class models change

Frontier models like Claude Fable 5 are better at long-horizon reasoning, multi-file refactors, test generation, browser checks, and complex repo work. That is valuable.

It does not change the beginner rule.

The more capable the model, the more important it is to define:

  • what success means
  • what systems are out of scope
  • what tools it may use
  • when it must stop
  • what proof it must show
  • how you will recover if the change is wrong

A powerful agent with a vague goal can create a bigger mess faster. A powerful agent with a tight goal can save you hours.

Give context, not autobiography

The agent does not need your life story. It does need the immediate truth:

  • what the project is
  • what stack you are using, if already chosen
  • what one thing you want next
  • what the agent must not do

That is context. Everything else is often noise.

Set the goal, then ask for a plan

Beginners should not start with "just do it." Start with:

"Explain the safest approach, list the files you expect to change, and stop for approval."

That one sentence improves the session dramatically because it moves you from reacting to reviewing.

It also gives you a clean moment to say "no" before the tool starts expanding scope on your behalf. That pause is not friction. That pause is the part where you stay in charge.

Modern agents often have explicit planning or goal modes. Use them, but do not treat them as permission to go hands-off. A good goal names the outcome, the boundary, the tests, and the stopping point:

"Goal: add one visible feedback form to this existing page. Success means the form renders, validates empty input, and logs the submitted values locally. Do not add a database, auth, payments, deployment, or new packages. Stop after the first working slice so I can review."

That is much safer than "build the feedback system." It gives the agent a target, and it gives you a way to tell whether the session is done.

If the tool supports long-running goals, subagents, MCP servers, browser control, or external tools, turn those on only when the task actually needs them. More capability is not automatically more safety. The first session should prove that you can supervise one bounded change.

What not to enable first

For a first session, avoid handing the agent broad access to:

  • production databases
  • real Stripe billing
  • DNS changes
  • deployment promotion
  • secret rotation
  • user deletion or bulk data edits
  • uncontrolled background loops
  • repository-wide rewrites

These are normal production tools later. They are not beginner first-session tools.

Approve one tiny change

Examples of good first changes:

  • create a single input and button
  • add a result area
  • save one value locally
  • clean up a layout on one page

Examples of bad first changes:

  • add full authentication
  • set up a database and admin dashboard
  • make the whole product responsive and deploy it
  • integrate three external services

Here is what the rhythm actually looks like. You tell the agent: "Add a button that clears the input field." The agent says it will modify one file, explains the change, and does it. You open the app, type something, click the button, and watch the field clear. It works. You commit. That is one cycle of the loop -- and you just built a real feature.

Test like a beginner, not a hero

You do not need a test lab yet. You do need to click the thing and see if it does what you asked.

Ask:

  • does it load?
  • does the main action work?
  • what happens with bad input?
  • did the agent touch anything unrelated?

That level of testing is enough for the first few sessions.

Stop while you still understand it

This is an underrated beginner skill.

When the app works and you understand the change, stop. Commit. Come back for the next step.

The urge to "keep the momentum going" is how sessions turn into opaque piles of AI output.

Try this now

  • Run one session where the agent is only allowed to add a single visible feature.
  • Require a plan before code.
  • Test the result immediately.
  • Commit if it works.

If you do only that, you will already be ahead of most beginners.

Prompt to give your agent

"I am on my first real AI-agent coding session. Project: [describe project] Current goal: [describe one small feature] Tooling available: [Claude Code / Cursor / Codex / editor agent / terminal agent / browser preview / database / deployment] Model available: [current model if known]

Before changing code:

  1. explain the safest approach in plain English
  2. list the files you expect to change
  3. tell me if this request is still too big
  4. define the exact stopping point for this session
  5. tell me whether this needs a goal, deeper planning, a stronger model, a loop, MCP, a subagent, or browser control -- and justify any yes

Then implement only that one small feature.

Afterward: 6. tell me exactly what changed 7. tell me how to test it in under two minutes 8. run only the agreed verification 9. tell me what you deliberately did not touch 10. stop so I can review before the next step

Do not add auth, deployment, payments, or unrelated cleanup."

What you must review yourself

  • Whether the plan made sense before code was generated
  • Whether the agent changed only what it said it would change
  • Whether the feature actually works when you run it
  • Whether the app is still simple enough that you understand the current state
  • Whether advanced capabilities were necessary or just made the session look more impressive

Common mistakes to avoid

  • Starting with "build the app." That is not a first session. That is surrender.
  • Skipping the planning step. Plans are how beginners catch bad assumptions early.
  • Accepting unrelated cleanup and extras. Side quests are how control slips away.
  • Continuing after confusion starts. The right move is to stop, inspect, and checkpoint.
  • Turning on every agent feature at once. Goals, loops, MCP, hooks, subagents, browser control, and frontier models are useful only when the task calls for them.

Key takeaways

  • A good first session is small, explicit, and reviewable
  • Setting a measurable goal and asking for a plan first are high-leverage beginner habits
  • Testing immediately keeps AI output honest
  • The correct time to stop is while you still understand the project
  • For Claude Code, orientation, memory, model choice, checkpoints, and bounded tool use matter before ambitious implementation

What's next

Your first session should end with a working tiny feature and a checkpoint. Before you show that result to anyone else, you need one final beginner guardrail: a pre-share safety review.