Building Enterprise-Ready AI Development Infrastructure from Day One

windsurf · Tech · 2024 · source Agentic: yes · promotional bias: med · source-backed · extracted with prompt 0.5.5 (schema v2)

Generated from extraction.json — do not edit by hand. Every claim cites verbatim source evidence; stated means the quote directly asserts the claim, implied means it supports it indirectly.

Problem

Domain: Enterprise AI IDE and agentic software development infrastructure

Codeium/Windsurf needed to turn AI coding assistance from autocomplete into enterprise-ready agentic software development. The hard problem was not only model capability; it was building infrastructure that works across enterprise source control and IDE fragmentation, captures developer trajectories, retrieves distributed code context, evaluates multi-step code changes, supports secure deployment, and still produces a product developers love enough for enterprise adoption.

Constraints:

Architecture

Windsurf combines broad enterprise infrastructure with a first-party IDE and agentic workflow. Codeium kept cross-IDE and source-control compatibility for enterprise customers, while building Windsurf to escape VS Code API limits and capture richer trajectory data. Cascade uses human trajectories, AI trajectories, knowledge retrieval, tools such as terminal execution, third-party planning models, and proprietary fast retrieval/code-application systems. Custom models serve low-latency autocomplete and SuperComplete, while eval harnesses turn open-source commits with tests into planning/retrieval/execution benchmarks. Preference data from accepted, edited, or deleted suggestions feeds future model improvement.

Diagram confidence: reconstructed (reconstructed from prose).

flowchart LR
  enterprise-customers[Enterprise customers] --> enterprise-ready-infrastructure[Enterprise-ready infrastructure]
  enterprise-customers --> deployment-engineers[Deployment engineers]
  enterprise-customers --> codeium-extensions[Codeium extensions]
  enterprise-customers --> windsurf-ide[Windsurf IDE]
  enterprise-ready-infrastructure --> source-control-adapters[Source control adapters]
  enterprise-ready-infrastructure --> deployment-engineers
  enterprise-ready-infrastructure --> codeium-extensions
  enterprise-ready-infrastructure --> windsurf-ide
  source-control-adapters --> codeium-extensions
  source-control-adapters --> windsurf-ide
  deployment-engineers --> enterprise-ready-infrastructure
  deployment-engineers --> enterprise-customers
  codeium-extensions --> custom-autocomplete-models[Custom autocomplete models]
  codeium-extensions --> preference-data-loop[Preference data loop]
  windsurf-ide --> cascade-agent[Cascade agent]
  windsurf-ide --> human-trajectory-tracker[Human trajectory tracker]
  windsurf-ide --> developer-review-ux[Developer review UX]
  cascade-agent --> human-trajectory-tracker
  cascade-agent --> ai-trajectory-tracker[AI trajectory tracker]
  cascade-agent --> knowledge-retrieval-system[Knowledge retrieval system]
  cascade-agent --> third-party-planning-model[Third-party planning model]
  cascade-agent --> code-application-system[Code application system]
  cascade-agent --> tool-execution-layer[Tool execution layer]
  cascade-agent --> developer-review-ux
  human-trajectory-tracker --> cascade-agent
  ai-trajectory-tracker --> cascade-agent
  knowledge-retrieval-system --> custom-retrieval-models[Custom retrieval models]
  knowledge-retrieval-system --> evaluation-harness[Evaluation harness]
  custom-retrieval-models --> cascade-agent
  custom-retrieval-models --> evaluation-harness
  third-party-planning-model --> cascade-agent
  third-party-planning-model --> code-application-system
  code-application-system --> developer-review-ux
  code-application-system --> evaluation-harness
  tool-execution-layer --> cascade-agent
  developer-review-ux --> preference-data-loop
  custom-autocomplete-models --> codeium-extensions
  custom-autocomplete-models --> windsurf-ide
  custom-autocomplete-models --> preference-data-loop
  evaluation-harness --> cascade-agent
  evaluation-harness --> knowledge-retrieval-system
  evaluation-harness --> code-application-system
  preference-data-loop --> custom-autocomplete-models
  preference-data-loop --> cascade-agent
Drag to pan · scroll or use +/− to zoom · reconstructed from the source's described component topology

Components

Component Role Interacts with
Enterprise customers Large organizations with heterogeneous IDEs, source control systems, deployment constraints, and tens of thousands of developers. Enterprise-ready infrastructure, Deployment engineers, Codeium extensions, Windsurf IDE
Enterprise-ready infrastructure Containerized, security-conscious, compliance-aware infrastructure built early for on-prem, VPC, and enterprise-scale deployment. Source control adapters, Deployment engineers, Codeium extensions, Windsurf IDE
Source control adapters Support for GitLab, Bitbucket, Gerrit, Perforce, CVS, Mercurial, and other enterprise source-control systems. Codeium extensions, Windsurf IDE
Deployment engineers Technical customer-facing engineers who help deploy Codeium and feed enterprise product needs back into development. Enterprise-ready infrastructure, Enterprise customers
Codeium extensions Cross-IDE assistant surface for meeting enterprise developers in their existing tools. Custom autocomplete models, Preference data loop
Windsurf IDE First-party IDE built to control APIs, UI, trajectory capture, and agentic workflow experience. Cascade agent, Human trajectory tracker, Developer review UX
Cascade agent Agentic coding system that combines human trajectory, AI trajectory, retrieval, planning, tool use, and code execution. Human trajectory tracker, AI trajectory tracker, Knowledge retrieval system, Third-party planning model, Code application system, Tool execution layer, Developer review UX
Human trajectory tracker Captures developer intent from opened files, edits, terminal commands, and other editor actions. Cascade agent
AI trajectory tracker Tracks what the AI has proposed or done so Cascade can reason over its own trajectory. Cascade agent
Knowledge retrieval system Retrieval layer over large codebases and distributed software knowledge. Custom retrieval models, Evaluation harness
Custom retrieval models Proprietary high-powered LLM retrieval models and distributed systems for codebase-scale retrieval beyond embeddings. Cascade agent, Evaluation harness
Third-party planning model External frontier planning model used for high-level reasoning in Cascade. Cascade agent, Code application system
Code application system Proprietary system that applies high-level plans to codebases quickly and accurately. Developer review UX, Evaluation harness
Tool execution layer Terminal command and tool execution capabilities that allow Cascade to move beyond passive suggestions. Cascade agent
Developer review UX Diff, streaming, terminal, and review interface for inspecting and accepting AI-generated code changes. Preference data loop
Custom autocomplete models First-party models for low-latency keystroke-level autocomplete and SuperComplete features. Codeium extensions, Windsurf IDE, Preference data loop
Evaluation harness Open-source commit/test and retrieval-at-50 evaluation system for planning, retrieval, and multi-step execution. Cascade agent, Knowledge retrieval system, Code application system
Preference data loop Learning loop from acceptances, edits, deletions, trajectories, synthetic data, and final developer outputs. Custom autocomplete models, Cascade agent

Data flow

Developers work across Codeium extensions or Windsurf. In Windsurf, Cascade observes editor actions, opened files, edits, terminal commands, and AI actions. The system retrieves relevant code from large codebases, uses high-level planning models for reasoning, and applies code through proprietary retrieval and code-application systems. Open-source commit/test harnesses evaluate whether the system can retrieve snippets, plan, iterate, and pass tests. In production, acceptance, post-acceptance edits, deletions, and final developer output provide preference data for improving SuperComplete and future trajectory-aware models.

5 supporting quotes
“Cascade because that's the first time you brought it up. Yeah. Varun [00:09:16]: So Cascade is the product that is the actual agentic part of the product, right? That is capable of. Of. Of taking information from both these human trajectories and these AI trajectories, what”article, stated
“taking information from both these human trajectories and these AI trajectories, what the human ended up doing, what the AI ended up doing”article, stated
“the high-level planning that is going on in the model is actually getting done with products like the cloud. But the extremely fast retrieval, as well as the ability to, like, take the high-level plan and actually apply it to the code base, is proprietary”article, stated
“the extremely fast retrieval, as well as the ability to, like, take the high-level plan and actually apply it to the code base, is proprietary systems”article, stated
“after accepting it, you deleted three or four items in there. We can see that. So that actually lets us get to even better than acceptance as a metric.”article, stated

Why this architecture

Windsurf's architecture reflects two simultaneous requirements: meet enterprise customers where they already work, and build a first-party agentic IDE where deeper trajectory-aware workflows are possible. Cross-IDE/source-control support preserved enterprise reach, while Windsurf removed VS Code API limits and enabled richer product UX. First-party models and infrastructure were kept where latency, FIM, retrieval, and code application were differentiating; third-party frontier models were used where planning quality was strongest. Custom evals and preference data closed the loop because public benchmarks and simple acceptance metrics were not enough.

4 supporting quotes
“software. We have customers where over 70% of their developers use JetBrains. And because of that, we wanted to provide a great experience wherever the developer was. But one thing that we found was lacking was, you know, we were running into the limitations of building within the VS Code”article, stated
“if we launch this agentic product on top of a system that we didn't have a lot of control over, it's just going to limit the value of the product”article, stated
“there are certain things that it's really important to first party. Like autocomplete. You have a really specific application that you can't just prompt engineer your way out of”article, stated
“The stuff that's coming out for the third model providers like Cascade and Windsurf would not have been possible if it wasn't for the rapid improvements with 4.0 and 3.5.”article, stated

Models used: Custom autocomplete models · SuperComplete · Custom retrieval models · Cascade · Claude · OpenAI GPT-4o · Claude 3.5 · ChatGPT · SWE-Bench · HumanEval

Scale

Alternatives considered (roads not taken)

Stay entirely within VS Code extensions for the agentic product.

Rejected because: VS Code's APIs and UX limits constrained SuperComplete display, refactor experiences, trajectory capture, and Cascade's agentic workflow ceiling.

“we were running into the limitations of building within the VS Code ecosystem on the VS Code platform. And I think we felt that there was an opportunity for us to build a premier sort of experience. And that was within the reach of the team. Right? The team”article, stated
“the feature. We had the feature for a while. Problem was actually even to show the feature VSCode would not expose an API for us to do this. So what we actually ended up doing. Was dynamically generating PNGs to actually go out and showcase this. It was not really”article, stated

Use a fully specified task prompt or PRD as the primary agent interface.

Rejected because: Windsurf believed real software development evolves through partial intent, trajectories, and iterative discovery rather than a complete prompt.

“we don't believe in this sort of modality where you just write a task and it just goes out and does it. Right? It's good for zero to one apps. And I think people have been seeing Windsurf is capable of doing that. And I'll let Anshul talk about that a little”article, stated
“developers will never completely pose the problem statement, right? Because the problem statement lives in their head.”article, stated

Depend entirely on third-party frontier models.

Rejected because: The team saw first-party models as essential for autocomplete and proprietary retrieval/code-application systems, while still using third-party models for high-level planning.

“things like autocomplete and supercomplete that run on every keystroke are entirely, like, our own models. And, by the way, that is still because properties like FIM, fill-in-the-middle capabilities, are still quite bad with the current... Non-existent.”article, stated
“the high-level planning that is going on in the model is actually getting done with products like the cloud. But the extremely fast retrieval, as well as the ability to, like, take the high-level plan and actually apply it to the code base, is proprietary”article, stated

Optimize against public coding benchmarks as the main target.

Rejected because: The team judged SWE-Bench, HumanEval, and similar benchmarks as poor proxies for professional software development and built task-specific evals instead.

“most evals and benchmarks, that exist out there for software development is kind of bogus. There's not really a better way of putting it. Like, okay, you have Swybench, that's cool. No actual professional work looks like Swybench. Like, human eval, same”article, stated
“There's not really a better way of putting it. Like, okay, you have Swybench, that's cool. No actual professional work looks like Swybench. Like, human eval, same thing. Like, these things are just a little kind of broken. So when you're trying to optimize against a metric that's a little”article, stated

Ship a simple MVP and add enterprise readiness later.

Rejected because: The source argues that security, compliance, personalization, usage analytics, latency budgets, and scale need to be part of the system from the start or they force a different product later.

“Unlike many startups that rush to market with minimal features and add enterprise capabilities later, Codeium invested heavily in enterprise-ready infrastructure from the start.”article, stated
“if you actually build for like security, compliance, personalization, usage analytics, latency budgets, and scale from the start then you're going to pay that cost now”article, stated

Patterns

tool-use-orchestration (agent workflow)

Cascade coordinates retrieval, editor trajectory, terminal/tool execution, planning, code application, and developer review rather than acting as a one-shot chat assistant.

“all the different tools that we could give it access to so they can go, like, do that kind of terminal execution”article, stated
“propose changes and actually execute code to finally get you the final work output”article, stated

retrieval-ranking (context engineering)

Windsurf built high-powered custom retrieval models and evals over large codebases because embeddings and retrieval-at-one did not capture distributed software knowledge.

“being able to use high-powered LLMs to be able to do much higher-quality retrieval across the code base”article, stated
“instead of looking at retrieval at one, you're looking at retrieval at like 50.”article, stated

eval-driven-development (quality)

The team converted open-source commits with tests into continuous evals for planning, retrieval, and multi-step execution so research improvements could be measured.

“We can find a bunch of commits, right? And we can actually see if some of these commits have tests associated with them.”article, stated
“break down and decompose this complex problem into like a planning retrieval and multi-step execution problem.”article, stated

model-routing (model strategy)

Windsurf uses first-party models where latency, FIM, retrieval, and code application are differentiating, while relying on third-party frontier models for high-level planning.

“autocomplete and supercomplete that run on every keystroke are entirely, like, our own models.”article, stated
“The planning models right now, undoubtedly, I think the CLODS and the OpenAIs have the best products.”article, stated

data-quality-loop (learning loop)

Windsurf learns from trajectories, acceptances, deletions, edits, synthetic data, and final developer outputs rather than treating accept/reject as the only signal.

“not only using synthetic data, but also getting the preference data from our users”article, stated
“If you can actually get ground truth of what actually happened, this is the beauty of being in the ID”article, stated

human-in-the-loop-gate (agent control)

Cascade keeps developers in the loop for review and command acceptance today, while the long-term direction is limited human interaction with safe escalation back to the human.

“Like, for instance, I think one of the most annoying parts about the product is the fact that you need to accept every command that kind of gets run. It's actually fairly annoying.”article, stated
“agentic is called, like, is Devin, I think, like, yes, the answer is this product should become fully agentic and limited human interaction is the goal, is 100% the goal. And I think, honestly, of all usable products right now, I think we're the closest right now, of all usable products in an ID.”article, stated

safety-policy-enforcement (enterprise readiness)

Codeium invested early in containerized deployment, security, compliance, FedRAMP work, and enterprise source-control compatibility to make AI developer tools acceptable in regulated or large-company environments.

“Built containerized systems from the start to make on-prem and VPC deployments easier”article, stated
“we have a lot of customers in like the defense space for example we're going through FedRAMP accreditation right now”article, stated

Tradeoffs

Build Windsurf while retaining cross-IDE enterprise coverage.

Chose A first-party IDE for the best agentic experience plus continued support for other IDEs. over Only shipping extensions or forcing all customers into Windsurf immediately..

Rationale: Windsurf unlocked trajectory-aware UX and APIs, but enterprise customers still required JetBrains, Eclipse, and other environments.

“Why don't we just build our own IDE? Right? Right. Right. Because it's by far the best experience.”article, stated
“there's a lot of like, meeting the developers where they are. So, I think on the enterprise side, we're still pretty invested in doing that.”article, stated

Use hybrid first-party and third-party models.

Chose First-party autocomplete/retrieval/code-application systems and third-party planning models. over All first-party models or all third-party models..

Rationale: First-party models were necessary where product-specific latency and FIM mattered, while frontier third-party models made Cascade and Windsurf possible for planning.

“there are certain things that it's really important to first party. Like autocomplete.”article, stated
“Cascade and Windsurf would not have been possible if it wasn't for the rapid improvements with 4.0 and 3.5.”article, stated

Invest in proprietary retrieval instead of relying on embeddings alone.

Chose High-powered LLM retrieval and large distributed systems over codebases. over Embedding-only retrieval for complex software questions..

Rationale: The team argued embeddings cannot capture granular semantic properties like quadratic-time algorithms across a large codebase.

“For a lot of the systems, we do believe embeddings work, but for complex questions, we don't believe embeddings can encapsulate all the granularity”article, stated
“we've actually built, like, large distributed systems to actually go out and run this. Run these at scale.”article, stated

Build enterprise infrastructure early.

Chose Containerization, security, compliance, VPC/on-prem readiness, and multi-SCM support from the start. over Fast MVP with enterprise capabilities tacked on later..

Rationale: Early enterprise infrastructure paid off when customers asked whether it could work for tens of thousands of developers or regulated environments.

“This "go slow to go fast" approach has proven particularly valuable in the AI tools space.”article, stated
“Built containerized systems from the start to make on-prem and VPC deployments easier”article, stated

Improve product from real developer trajectories rather than only explicit feedback.

Chose Preference learning from acceptances, edits, deletions, and final outputs. over Simple accept/reject metrics or chat-style explicit feedback alone..

Rationale: Being inside the IDE reveals what developers actually did after a suggestion, which gives richer ground truth than acceptance alone.

“you accepted it, but then after accepting it, you deleted three or four items in there. We can see that.”article, stated
“It's the preference between the acceptance and what actually happened.”article, stated

Gotchas (what bit them)

VS Code extension APIs capped the agentic UX ceiling.

Root cause: The team could implement features, but VS Code did not expose the APIs and stable hooks needed to display and operate them cleanly.

Resolution: Windsurf built a first-party IDE while keeping enterprise extensions for other environments.

“Problem was actually even to show the feature VSCode would not expose an API for us to do this.”article, stated
“our good engineering time was being spent fighting against the system rather than being a good system.”article, stated

Enterprise source-control and IDE fragmentation made GitHub/VS Code assumptions unsafe.

Root cause: Large enterprises use GitLab, Bitbucket, Gerrit, Perforce, CVS, Harvest, Mercurial, JetBrains, Eclipse, and other systems.

Resolution: Codeium preserved cross-IDE/source-control support and built enterprise infrastructure around customer heterogeneity.

“GitHub might have less than 10% penetration of the Fortune 500. Full penetration. It's very small. And then also on top of that, GitHub has very high switching costs for source code management tools.”article, stated
“I think it would be a little bit like, you know, very kind of egotistical as to being like, oh, we have Windsurf now, all of our enterprise customers are going to switch to Windsurf and this is the only, like, no, we still support the other IDE. I was going to say, Swyx [00:39:34]:”article, stated

Public coding benchmarks could drive the wrong optimization.

Root cause: SWE-Bench and HumanEval did not match the distributed, incomplete, trajectory-dependent nature of professional software work.

Resolution: The team built custom evals around incomplete commits, tests, planning, retrieval, and multi-step execution.

“when you're trying to optimize against a metric that's a little bit broken, you end up making kind of suboptimal decisions.”article, stated
“What are the 50 highest things that you can actually retrieve? And are you capturing all of the necessary pieces for that?”article, stated

Remote or autonomous execution can damage the user's working machine.

Root cause: Agentic code execution can run arbitrary commands or move the system forward in ways that are difficult to undo.

Resolution: The source argues for snapshots, rollback, multiple rollouts, and local-versus-remote execution designs that prevent destructive side effects.

“I want, like, a snapshot of the system that I can, like, constantly checkpoint and move back and forth.”article, stated
“if you move the system forward, it, like, destroys your machine. It's probably going to be a hard system”article, stated

Adding enterprise readiness later can force a product re-architecture.

Root cause: Security, compliance, scale, latency, deployment, and usage analytics shape the underlying system rather than sitting as add-ons.

Resolution: Codeium built containerized deployment and enterprise DNA from the start, even when those capabilities looked early.

“you actually end up with the different products or you end up worse off than if you had started from the beginning”article, stated
“we already have a containerized system we can already like deploy in these manners we can already do like we've already gone through like security”article, stated

Evaluation

Windsurf built evaluation infrastructure around executable code and realistic incomplete-development states. The harness finds open-source commits with associated tests, strips the commits, withholds complete intent, and measures whether Cascade can retrieve the right snippets, plan, iterate, and reach passing tests. Retrieval-specific evals look at retrieval-at-50 and golden sets from files edited together, while product feedback uses acceptance, deletion, modification, and final-output preference data.

Metrics: Open-source commits with associated tests are used to test end-to-end agentic workflows. · The system decomposes quality into planning, retrieval, and multi-step execution axes. · Retrieval evals use retrieval-at-50 rather than retrieval-at-1. · Enterprise-scale context is measured against codebases with tens of millions of lines and hundreds of billions of tokens. · Preference data includes whether accepted suggestions were later deleted or modified.

5 supporting quotes
“We can find a bunch of commits, right? And we can actually see if some of these commits have tests associated with them.”article, stated
“retrieve the right snippets and actually come up with a cohesive plan and iterative loop that gets you to a state where the code actually passes”article, stated
“So you can actually break down and decompose this complex problem into like a planning retrieval and multi-step execution problem. And you can see on every single one of these axes is getting better.”article, stated
“instead of looking at retrieval at one, you're looking at retrieval at like 50.”article, stated
“you accepted it, but then after accepting it, you deleted three or four items in there. We can see that.”article, stated

Outcomes

The case reports substantial adoption and enterprise traction, but the deeper technical outcome is an infrastructure base that supports both individual-developer scale and enterprise deployments with tens of thousands of developers. Claims are from a company podcast/article and should be treated as vendor-reported.

4 supporting quotes
“we have over 800,000 sort of developers that use that product. Lots of large enterprises.”article, stated
“We were recently awarded JPMorgan Chase's Hall of Innovation Award, which is usually not something a company gets, you know, within a year of deploying an enterprise product.”article, stated
“And then large companies like Dell and stuff use the product. So I think we've seen a lot of traction on the enterprise space.”article, stated
“we go from zero to 10 million ARR in less than a year in an enterprise product”article, stated