How to Prompt in Cursor 3.0

Most Cursor prompts fail for a boring reason: they sound like requests to ChatGPT, not instructions for a coding agent. That difference matters more in Cursor 3.0 than most people realize.

Key Takeaways

• The best Cursor 3.0 prompts define scope, files, constraints, and a clear success test.
• Ask mode is for thinking; Agent mode is for acting. Mixing them carelessly creates messy edits.
• Short repo rules beat bloated AGENTS.md files in many real coding tasks.[1]
• Good prompts for agents are really workflow specs, not just questions.
• Before → after prompt rewrites can cut retries fast, especially when you name files and verification steps.

---

Why do Cursor 3.0 prompts need a different style?

Cursor 3.0 prompting works best when you treat the model like an agent with tools, files, and side effects, not like a general chatbot. That means prompts should specify what to change, where to change it, what constraints matter, and how to verify success. Vague prompts waste tokens and create extra editing loops.[2][3]

Here's the big shift I notice with Cursor: the model is not just generating text. It can read files, edit files, inspect structure, and sometimes wander if you give it too much freedom. Lenny's walkthrough on Cursor makes this practical distinction very clear: Ask mode is closer to classic chat, while Agent mode is where Cursor actually touches your project.[2]

That sounds obvious, but it changes how I write prompts. In Cursor, "build me X" is usually worse than "update these files to do X, keep Y intact, and verify with Z."

---

How should you structure a Cursor 3.0 prompt?

A strong Cursor 3.0 prompt should include the objective, the relevant context, the exact scope, hard constraints, and a definition of done. This gives the agent enough direction to act without forcing it to guess hidden requirements or rewrite half your repo.[1][2]

Here's the template I keep coming back to:

Goal:
Add password reset to the existing auth flow.

Scope:
Only modify:
- app/routes/auth.tsx
- app/lib/auth/reset.ts
- app/components/ResetPasswordForm.tsx

Constraints:
- Keep current email/password login unchanged
- Use existing toast component for feedback
- Do not add new dependencies
- Follow current TypeScript patterns in app/lib/auth

Success criteria:
- User can request reset email
- Invalid email shows inline error
- Success shows toast confirmation
- Existing login tests still pass

Verification:
Run the relevant test suite and summarize what changed.

That's not fancy. It's just complete. And complete beats clever.

What's interesting is that this style lines up with what research on coding agents keeps finding: agents do follow instructions, but extra instruction noise often hurts performance and increases cost.[1] So the goal isn't "more prompt." It's "better prompt."

---

What belongs in AGENTS.md for Cursor 3.0?

AGENTS.md in Cursor should contain only the small set of rules that are always useful across tasks, such as build commands, testing commands, forbidden patterns, or non-obvious repo conventions. Keep it lean because long context files can reduce task success and raise cost.[1]

This is the part where a lot of teams overdo it.

The ETH Zurich paper on repository-level context files is one of the most useful reality checks I found. Across multiple coding agents, LLM-generated context files often reduced success rates and increased inference cost by more than 20%.[1] The agent followed the instructions, but that didn't mean the instructions were helping.

So for Cursor 3.0, I'd keep AGENTS.md to things like:

• how to run tests
• which package manager to use
• migration or deployment gotchas
• architecture rules that are not obvious from the code
• things the agent must never do

I would not stuff it with full directory trees, broad style advice, or long philosophical notes about the codebase.

A good rule is this: if the agent can discover it by reading the repo quickly, don't repeat it in AGENTS.md.

---

When should you use Ask mode versus Agent mode?

Use Ask mode when you want Cursor to reason, inspect, compare options, or explain the repo without changing files. Use Agent mode when you want scoped execution: file edits, tool use, and verifiable implementation work.[2]

I like to separate thinking from doing.

If I'm not sure about architecture, I start with Ask mode and say something like:

Review the auth flow and explain the safest place to add password reset without breaking login. Do not edit files yet. Give me 2 implementation options with tradeoffs.

Then, once I pick a direction, I switch to Agent mode with a tighter execution prompt.

This is also consistent with broader agent research. In complex tool-use settings, the main bottleneck is often planning, not raw tool access.[3] So it pays to make planning explicit before you unleash edits.

---

What does a good Cursor 3.0 prompt look like in practice?

A good Cursor 3.0 prompt names the files, limits the blast radius, states the constraints, and ends with a verification request. The agent performs better when the task is concrete, sequential, and grounded in real repo context instead of broad intent alone.[1][2]

Here's a before → after table that shows the difference.

Weak prompt	Better Cursor 3.0 prompt
Add dark mode to this app	Add dark mode to the existing settings-driven theme system. Only modify src/theme.ts, src/components/SettingsPanel.tsx, and the global stylesheet. Reuse current CSS variables. Do not introduce Tailwind or new dependencies. Add a toggle in settings, preserve current light theme behavior, and verify all existing theme-related tests still pass.
Refactor auth	Refactor the auth module for readability only. Do not change behavior or API signatures. Focus on server/auth/session.ts and server/auth/cookies.ts. Extract duplicated logic, improve naming, and add brief comments only where logic is non-obvious. Summarize any behavioral risks before applying edits.
Fix this bug	Investigate why form submission duplicates requests in CheckoutForm.tsx. First explain the likely cause. Then implement the smallest safe fix. Do not modify unrelated checkout files. Verify by describing the reproduction case and confirming the fix path.

Here's what I noticed after using Cursor this way for a while: the words "only modify," "do not," and "verify" do a lot of work.

That matches practical community advice too. One Reddit thread I found made the same point from a different angle: prompts built from the codebase itself tend to outperform vibe-based prompts because they stay aligned with repo reality.[4]

This is also where tools like Rephrase can help. If your first draft is just "add dark mode to this app," a prompt improver can turn that into a structured agent-ready request in seconds.

---

How can you reduce retries and bad edits in Cursor 3.0?

To reduce retries in Cursor 3.0, narrow the task, specify the files, ban unnecessary changes, and require a short plan or verification step. This keeps the agent from over-exploring the repo and helps you catch misunderstandings before they spread.[1][3]

If a task is large, I break it into two prompts. First, plan. Second, execute.

For example:

1. Ask Cursor to propose the implementation plan, impacted files, and risks.
2. Review it.
3. Then tell Agent mode to execute only that plan.

That sounds slower, but it's usually faster than cleaning up a confident wrong answer.

I also recommend giving Cursor explicit stopping conditions. Say "do not add new dependencies," "do not touch tests unless necessary," or "if the root cause is unclear, stop and explain uncertainty." These constraints are cheap and they prevent a lot of chaos.

And if you want more articles on prompt structure, agent workflows, and practical rewrites, the Rephrase blog is a good rabbit hole.

---

Prompting in Cursor 3.0 is less about magic wording and more about operational clarity. Tell the agent what success looks like, where it can work, and what it must protect. That's the whole game.

If you want a shortcut, write your rough request first, then rewrite it into a mini spec before hitting enter. Or let a tool like Rephrase do that rewrite for you when you're moving fast. Either way, the payoff is immediate: fewer retries, cleaner diffs, and a lot less "why did it change that file?"

---

References

Documentation & Research

1. Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents? - The Prompt Report (link)
2. How to build AI product sense - Lenny's Newsletter (link)
3. EnterpriseOps-Gym: Environments and Evaluations for Stateful Agentic Planning and Tool Use in Enterprise Settings - arXiv cs.AI (link)

Community Examples

4. Prompt engineering by codebase fingerprint instead of vibes - r/PromptEngineering (link)