State the goal, scope, and definition of done
Tell the Agent what to achieve, where to make changes, and how to tell when it is done. Compare:- “Fix the login page.”
- “Fix the misaligned input fields on the login page in Safari. Only change the login page styles and leave other pages alone. When you’re done, run the existing tests and add a test that covers Safari.”
Provide relevant files and links
- Choose the right project first so the Agent works in the correct code and environment.
- Name the relevant files, folders, error messages, or documentation links in the task.
- For UI issues, attach a screenshot or use Take a screenshot in the input box. Send logs, design files, and similar material as attachments. See Start a session.
- Save any secrets the Agent will need to the project’s secrets and environment variables in advance, so it does not have to stop and ask you for them. See Projects and environment setup.
Split large tasks
A session usually works best when it focuses on one thing. Split a large request into several sessions, for example ask the Agent to research options first, then start the implementation based on its findings.- When parts of a task are independent, say which parts can run in parallel. For complex tasks, the Agent can start subagents to work on them at the same time and combine the results automatically when they all finish.
- To try a different approach, Fork a new session from a reply. The original session is not affected.
- When the Agent goes off track, you do not have to wait for it to finish. Use Steer to correct it right away, or edit an earlier message and run it again. See Work with the Agent.
Choose the right permissions
New sessions default to Full access, so the Agent does not ask you about each step. This suits tasks you want it to complete on its own on the cloud server. Sessions on the cloud server never touch your computer. Switch to Ask for approval or Approve for me in these cases:- The session runs on your own computer and involves important files or system settings.
- The project has secrets you do not want the Agent to use freely. With Full access, the Agent can read all secrets in the project.
- The task connects to external services or websites, and you want to confirm before it acts.