Enterprise
AI Coding Policy Template
An AI coding policy should state which tools are allowed, which repos are approved, what data must stay out, when human review is required and how incidents are reported. Keep it short enough to follow during a normal workday, and mark each clause as enforced by a control or expected of people.

On this page
Which controls need an owner before rollout?
Four controls decide whether security will sign off: who has access, what the policy allows, how data moves and whether anyone measures adoption. Settle them before the pilot starts, because they apply whichever tool you pick.
- Control
- Identity
- Owner
- IT
- Evidence
- SSOSingle Sign-On. One company login (usually via SAML or OIDC) instead of a separate password per tool. Press Enter for the full definition., SCIMSystem for Cross-domain Identity Management. A standard for automatically creating and removing user accounts when people join or leave. Press Enter for the full definition. or membership source is defined
- Control
- Policy
- Owner
- Engineering leadership
- Evidence
- Allowed repos, tools and review rules are documented
- Control
- Security
- Owner
- Security team
- Evidence
- Data flow, secrets boundary and audit path are reviewed
- Control
- Adoption
- Owner
- DevEx
- Evidence
- Pilot metrics and training path are live
| Control | Owner | Evidence |
|---|---|---|
| Identity | IT | SSOSingle Sign-On. One company login (usually via SAML or OIDC) instead of a separate password per tool. Press Enter for the full definition., SCIMSystem for Cross-domain Identity Management. A standard for automatically creating and removing user accounts when people join or leave. Press Enter for the full definition. or membership source is defined |
| Policy | Engineering leadership | Allowed repos, tools and review rules are documented |
| Security | Security team | Data flow, secrets boundary and audit path are reviewed |
| Adoption | DevEx | Pilot metrics and training path are live |
The owner column matters as much as the controls. A control with no named owner goes unchecked until someone has to answer for it. If nobody owns identity, for example, nobody checks that people who leave lose access.
Security does not own all four. Identity is IT's system of record, and policy is engineering leadership's call about what the team may ship. Adoption belongs to whoever owns developer experience. Security owns the data-flow question and the audit path, and it will ask about both.
Data flow is the question that stalls approvals, so answer it before the review meeting. Write down what the tool can read, what it can change, what leaves your network and where any of it is retained. Most of the answers come from the vendor's documentation and your own configuration. Ask the vendor for anything the documentation leaves out, and note where each answer came from.
The stack below breaks a rollout into layers. Policy comes first because the other layers carry it out. Identity controls who gets access, workflow moves code from prompt to merge, and measurement shows whether the rollout is working.
Interactive diagram. Tab through its regions; each focused region shows its detail in the panel below.
This is covered hands-on in Teams and Enterprise Admin — 6 short Units, free to read.
How should the rollout work?
Start narrow, and expand only when the pilot earns it.
- 1Week 1: pick one team, one repo and three realistic tasks.
- 2Week 2: write the workflow standard from the pilot.
- 3Week 3: train champions and add policy guardrails.
- 4Week 4: expand only after quality, cost and review load are visible.
Treat the four weeks as an order, not a deadline. The first two weeks mostly show you what your standard should say. A pilot too broad to watch closely can't teach you that, so it starts with one team and a few real tasks. Pick the team that will tell you when something breaks, even if another team would produce a better-looking result. Put policy and training in place before the rollout grows, because both are harder to add once people have formed their own habits.
Expansion is the step to slow down. After a good pilot, the pressure to widen access can arrive before the evidence does. Before you add teams, answer three questions with numbers: did review load go up or down, what does a developer cost per month, and did quality hold.
Record the same numbers before the pilot starts, so you have a baseline to compare against. Two more weeks of the same pilot cost less than a rollout you have to walk back, so run them if any answer is still a guess.
What's new in Cursor recently?
Cursor ships often, so advice about it can go out of date. The table summarizes Cursor's recent releases, so you can check this page against the current product. For each release's date and sources, see What's new in Cursor 2026.
- Surface
- Compile 2026
- What to know
- Cursor's June conference (June 16, per press coverage) centered on Origin, larger from-scratch model training and Cursor Mobile.
- Surface
- Origin
- What to know
- Early beta since August 17, 2026, on most paid plans: repos, pull requests with Code Tours, GitHub sync and a CLI. Standalone pricing and self-hosting are still unpublished.
- Surface
- Model and mobile
- What to know
- Composer 2.5The current Composer release, better at long-running tasks and at judging when a job needs a light touch versus deep work. Press Enter for the full definition. is available now. Cursor says it is training a larger model with SpaceXAI. Cursor Mobile now has its own product page.
- Surface
- Automations
- What to know
/automate, Slack emoji triggers, GitHub triggers for issue comments, reviews and workflow runs, computer use, PR defaults and memory cleanup.
- Surface
- Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition.
- What to know
- Guided cloud environment setup, reusable snapshots,
.cursor/environment.json,/in-cloud,/autopilot(formerly/babysit) and local/cloud handoff.
- Surface
- Review
- What to know
- BugbotCursor's automated PR reviewer that posts inline findings and can push fix commits from isolated VMs. Press Enter for the full definition. averages about 90 seconds per review and finds 10% more bugs per review.
/reviewruns it locally before you push. Cursor's June changelog says Composer 2.5The current Composer release, better at long-running tasks and at judging when a job needs a light touch versus deep work. Press Enter for the full definition. now powers Bugbot, and these figures may change.
- Surface
- Design and Canvas
- What to know
- Design ModeA way to point at an element in Cursor's built-in browser and change it directly, instead of describing it in words. Press Enter for the full definition. supports multi-select and voice queueing. Canvases support Design Mode, context reports, Debug with Agent, full-screen sharing and prompt buttons.
- Surface
- SDK and run modes
- What to know
- SDK agents can use custom tools, auto-review, JSONL or custom stores, nested subagents and request IDs. Auto-review Run Mode runs known-safe calls, sandboxes shell commands where it can and sends the rest to a classifier.
- Surface
- Enterprise and pricing
- What to know
- Organizations sit above teams, and groups scope model access, spend and agent permissions. Teams launched with Standard and Premium seats and two usage pools, Cursor ModelsOn legacy Cursor plans, the monthly usage pool for Cursor's own models (Grok 4.7, Grok 4.6, Grok 4.5 and Composer 2.5), kept separate from the third-party Other Models pool. The X Subscription replaces it with one weekly pool. Press Enter for the full definition. and Other ModelsOn legacy Cursor plans, the monthly pool for supported third-party models from providers such as Anthropic, Google and OpenAI, separate from Cursor Models. On The X Subscription third-party models are billed from prepaid credit instead. Press Enter for the full definition.. Those seats are now legacy, and current Teams seats are Premium, Super and Ultra on The X SubscriptionThe subscription Cursor is sold through: one plan for Grok, Cursor and X, with Free, Plus, Premium, Super and Ultra tiers, per-seat Teams, a weekly included pool for Cursor models shared with Grok, and third-party models billed at API list price from prepaid credit. Press Enter for the full definition..
| Surface | What to know |
|---|---|
| Compile 2026 | Cursor's June conference (June 16, per press coverage) centered on Origin, larger from-scratch model training and Cursor Mobile. |
| Origin | Early beta since August 17, 2026, on most paid plans: repos, pull requests with Code Tours, GitHub sync and a CLI. Standalone pricing and self-hosting are still unpublished. |
| Model and mobile | Composer 2.5The current Composer release, better at long-running tasks and at judging when a job needs a light touch versus deep work. Press Enter for the full definition. is available now. Cursor says it is training a larger model with SpaceXAI. Cursor Mobile now has its own product page. |
| Automations | /automate, Slack emoji triggers, GitHub triggers for issue comments, reviews and workflow runs, computer use, PR defaults and memory cleanup. |
| Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition. | Guided cloud environment setup, reusable snapshots, .cursor/environment.json, /in-cloud, /autopilot (formerly /babysit) and local/cloud handoff. |
| Review | BugbotCursor's automated PR reviewer that posts inline findings and can push fix commits from isolated VMs. Press Enter for the full definition. averages about 90 seconds per review and finds 10% more bugs per review. /review runs it locally before you push. Cursor's June changelog says Composer 2.5The current Composer release, better at long-running tasks and at judging when a job needs a light touch versus deep work. Press Enter for the full definition. now powers Bugbot, and these figures may change. |
| Design and Canvas | Design ModeA way to point at an element in Cursor's built-in browser and change it directly, instead of describing it in words. Press Enter for the full definition. supports multi-select and voice queueing. Canvases support Design Mode, context reports, Debug with Agent, full-screen sharing and prompt buttons. |
| SDK and run modes | SDK agents can use custom tools, auto-review, JSONL or custom stores, nested subagents and request IDs. Auto-review Run Mode runs known-safe calls, sandboxes shell commands where it can and sends the rest to a classifier. |
| Enterprise and pricing | Organizations sit above teams, and groups scope model access, spend and agent permissions. Teams launched with Standard and Premium seats and two usage pools, Cursor ModelsOn legacy Cursor plans, the monthly usage pool for Cursor's own models (Grok 4.7, Grok 4.6, Grok 4.5 and Composer 2.5), kept separate from the third-party Other Models pool. The X Subscription replaces it with one weekly pool. Press Enter for the full definition. and Other ModelsOn legacy Cursor plans, the monthly pool for supported third-party models from providers such as Anthropic, Google and OpenAI, separate from Cursor Models. On The X Subscription third-party models are billed from prepaid credit instead. Press Enter for the full definition.. Those seats are now legacy, and current Teams seats are Premium, Super and Ultra on The X SubscriptionThe subscription Cursor is sold through: one plan for Grok, Cursor and X, with Free, Plus, Premium, Super and Ultra tiers, per-seat Teams, a weekly included pool for Cursor models shared with Grok, and third-party models billed at API list price from prepaid credit. Press Enter for the full definition.. |
A summary only. The release tracker linked above gives each release's date and sources.
How do you tell an enforced policy clause from a request?
Ask what happens when someone ignores it. Cursor divides agent safety into two kinds of control. Security controls are deterministic: they block an operation whatever the model suggests. Steering is non-deterministic: it makes good behavior more likely but doesn't guarantee it. A clause that rests on steering is a request, and the template should say so in the clause itself.
- The clause rests on
- Approvals, hooks, sandboxing, file permissions
- Enforced or expected
- Enforced
- Why
- Deterministic. The operation is blocked regardless of what the model proposes. A hook also needs
failClosed: true, or a crash or timeout lets the action through.
- The clause rests on
- Run Mode set to Auto-review
- Enforced or expected
- Partly
- Why
- Runs allowlisted calls and sandboxes shell commands where it can. The rest goes through a best-effort classifier, so Cursor's guidance is to pair it with hooks.
- The clause rests on
.cursorignoreon secrets and regulated paths- Enforced or expected
- Expected
- Why
- Excludes files from agent file reading and context selection, but a user can still open an ignored file, and terminal commands and MCPModel Context Protocol. A standard that lets an AI agent pull in context from outside the repo, like Jira tickets or internal docs. Press Enter for the full definition. tools can still read it.
- The clause rests on
- Team rules
- Enforced or expected
- Expected
- Why
- Instructions the model attempts to follow. Not a guarantee.
| The clause rests on | Enforced or expected | Why |
|---|---|---|
| Approvals, hooks, sandboxing, file permissions | Enforced | Deterministic. The operation is blocked regardless of what the model proposes. A hook also needs failClosed: true, or a crash or timeout lets the action through. |
| Run Mode set to Auto-review | Partly | Runs allowlisted calls and sandboxes shell commands where it can. The rest goes through a best-effort classifier, so Cursor's guidance is to pair it with hooks. |
.cursorignore on secrets and regulated paths | Expected | Excludes files from agent file reading and context selection, but a user can still open an ignored file, and terminal commands and MCPModel Context Protocol. A standard that lets an AI agent pull in context from outside the repo, like Jira tickets or internal docs. Press Enter for the full definition. tools can still read it. |
| Team rules | Expected | Instructions the model attempts to follow. Not a guarantee. |
Word the expected rows as expectations, so no clause reads as enforced when it isn't.
The wording matters most for secrets. A clause that says secrets are excluded through .cursorignore reads like a guarantee that secrets cannot reach a model. It is not one, and Cursor's docs say so: they call .cursorignore a convenience feature, not a security boundary. For paths that must never be read, Cursor points to file system permissions or encryption, and a hook can block the read. Use all three on anything you would have to disclose.
Before you circulate the draft, mark every clause as enforced or expected. That one word tells a reviewer which promises have a control behind them.
Which policy clause can't you back with evidence?
The one that promises a record of what the agent did. Cursor's audit log can't support it, because it covers security events and administrative actions and leaves out prompts, agent responses and generated code. A clause that says AI-assisted changes are logged and reviewable cannot be met from the audit log alone.
Cursor recommends hooks to fill that gap. You attach one to prompt submission and one to the agent's code writes, and each sends a record to your compliance endpoint. Cursor advises logging metadata rather than the full prompt or code.
So build the hook before you write the clause. Whoever builds the hook decides what it records, and that decides what the clause can truthfully claim. If the clause comes first, the policy makes a promise that the logging pipeline has to be bent to keep.
Check your plan before you write the clause, because audit logs are an Enterprise feature. On Enterprise, admins view them in the team dashboard, and Cursor can stream them to a SIEM, a webhook or S3. Without them, the escalation path has to be a named person rather than a query.
What should the policy say about model and repo access?
Start with models. Name the models the org allows, and say whether people may use their own API keys. On Enterprise, admins can turn models off and block personal keys in the team dashboard, so both clauses can be enforced. On other plans, mark them as expected.
Personal keys need their own clause. Cursor's Zero Data Retention policy does not apply to requests made with a personal key, and the provider's own privacy policy governs those requests instead. A policy that enforces Privacy ModeCursor's setting that guarantees code data is not used for training by Cursor or its model providers, and that an admin can enforce org-wide; data-retention terms are a separate, contractual layer. Press Enter for the full definition. across the org but says nothing about personal keys leaves those requests outside the guarantee it relies on.
A few models need data retention with their provider. For Enterprise customers and for teams with Privacy ModeCursor's setting that guarantees code data is not used for training by Cursor or its model providers, and that an admin can enforce org-wide; data-retention terms are a separate, contractual layer. Press Enter for the full definition. on, Cursor already requires admin approval before anyone uses one. So for those teams the approval step already exists, and the policy's job is to say who grants it and on what basis.
A repository blocklist covers the other direction: repos Cursor should not touch. On Enterprise, Cursor refuses to index or work with a blocked repo in the editor and the CLI. The blocklist does not apply to Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition., Automations or BugbotCursor's automated PR reviewer that posts inline findings and can push fix commits from isolated VMs. Press Enter for the full definition., so the clause has to cover those surfaces separately.
Frequently asked questions
Who is this guide for?
Engineering leaders, security teams and developer experience owners who are writing or updating an AI coding policy.
What should I do next?
Draft the clauses from this template, then mark each one as enforced or expected. Build the logging hook before you write any clause that promises a record of what the agent did.
Is .cursorignore enough to keep secrets away from AI models?
No. Cursor calls .cursorignore a convenience feature, not a security boundary. A user can still open an ignored file, and terminal commands and MCP tools can still read it. For paths that must never be read, use file system permissions or encryption, plus a hook that blocks the read and is set to fail closed.
Can an AI coding policy promise a log of everything the agent did?
Not from Cursor's audit log alone, which covers security events and administrative actions and leaves out agent responses and generated code. Build hooks on prompt submission and code writes that send metadata to your compliance endpoint, then write the clause.
Does Cursor's Zero Data Retention policy cover personal API keys?
No. It doesn't apply to requests made with your own API key, and the provider's privacy policy governs those requests instead. Say in the policy whether people may use their own keys.
Sources & last verified
- Cursor teams dashboard
- Cursor privacy and data governance
- Cursor SSO
- Cursor enterprise docs
- Cursor enterprise
- Cursor docs: LLM safety and controls
- Cursor docs: Model and integration management
- Cursor docs: Security and privacy hardening
- Cursor docs: Compliance and monitoring
- Cursor docs: Hooks
Cursor ships frequently. Facts verified against primary sources on October 28, 2026.