Training course · Windsurf · Software Architecture

Windsurf for Software Architects

Develop with the Windsurf AI IDE and its Cascade agent: flows, memories, rules, workflows and safe use across the team.

Duration
2 days (14 hrs)
Format
Online or on-site
Language
German or English
Participants
open dates or exclusive for your team
Certificate
Certificate of attendance

Overview

“Windsurf for Software Architects” is designed for roles such as Software architects and solution architects, Enterprise architects with links to application development and Senior developers and tech leads with architectural responsibility and shows step by step how to use Windsurf productively, safely and transparently in Software Architecture – from the fundamentals to advanced workflows.

Windsurf is an AI-powered development environment built around its agent, Cascade. Cascade understands the structure of your project, follows your actions in the editor and terminal, and works with you according to the flow principle: you and the agent take turns on the same task without having to re-explain context over and over. In this two-day course you will learn how to use Cascade effectively for features, debugging and refactoring, and how to make the most of intelligent completion in your daily development work.

To keep results consistent across a team, you steer Cascade with global and workspace rules, rely on memories for lasting project knowledge and automate recurring procedures with workflows that run from a slash command. You will connect external tools through MCP, control how terminal commands are executed and decide which data Cascade is allowed to see. Finally, you will define rules for code review, security and data protection so that Windsurf can be used responsibly within your organisation and its existing processes.

When AI agents write large parts of the code, architecture becomes more important, not less: clear module boundaries, documented decisions and verifiable quality goals are the frame that keeps generated code consistent. AI assistants also support architects directly, for example by analysing existing codebases, producing C4 diagrams, drafting architecture decision records and weighing alternatives against quality attributes. Fitness functions and architecture tests can be generated and anchored in your pipelines. In this course you learn to use AI as a sparring partner for architectural decisions, prepare architectural knowledge so that coding agents follow it reliably and spot erosion early in fast-growing codebases.

The course is delivered live – either online in a virtual classroom or on-site in our training rooms in Munich, Salzburg, Berlin, Augsburg, Hanover, Bremen, Stuttgart and Kaiserslautern. We can also run it exclusively for your team.

Who is this course for?

  • Software architects and solution architects
  • Enterprise architects with links to application development
  • Senior developers and tech leads with architectural responsibility
  • Platform and cloud architects
  • Owners of architecture governance and review boards

Typical challenges we address

  • Architecture documentation goes stale quickly and drifts from the actual code
  • Decisions are made verbally and their context is lost
  • Gradual architectural erosion through cyclic dependencies and violated layer boundaries
  • Without clear guidance, AI-generated code ignores established patterns and conventions

What you will be able to do

  • You use Cascade productively in flow for features, debugging and refactoring.
  • You steer Windsurf’s context precisely and keep sensitive content protected.
  • You maintain memories and rules that reliably enforce your project conventions.
  • You automate recurring procedures with workflows and connect external tools via MCP.
  • Use AI to analyse existing systems, evaluate architectural options and record decisions as ADRs.
  • Anchor architecture rules as fitness functions in the pipeline and detect erosion early.
  • Shape context and rules so that AI coding agents reliably respect your architectural guidelines.

Course outline

Day 1

Module 1 Getting to know Windsurf and Cascade
  • Installation, importing existing editor settings and basic configuration
  • Cascade in code and chat mode: when the agent edits and when it only advises
  • The flow principle: how Cascade takes your editor and terminal actions into account
  • Intelligent completion and inline commands in everyday development
Module 2 Steering context
  • Understanding codebase indexing and referencing relevant files or directories
  • Bringing documentation, web sources and terminal output into context
  • Excluding sensitive content from context with ignore files
  • Structuring sessions and starting afresh when the topic changes
Module 3 Memories and rules for consistent results
  • Reviewing and maintaining auto-generated and manually created memories
  • Creating and versioning global and workspace rules
  • Expressing architecture, style and testing guidelines as effective rules
  • Activating rules selectively by file pattern or occasion
Module 4 Workflows and automation
  • Defining recurring procedures as workflows and launching them via slash command
  • Building workflows for release preparation, testing or code maintenance
  • Connecting MCP servers for issue trackers, databases or internal services
  • Controlling terminal command execution with allow and deny lists

Day 2

Module 5 Quality, review and governance
  • Tracing Cascade’s changes, accepting them partially or reverting them
  • Using a test-driven approach and preview features for verification
  • Team settings, data protection options and handling of secrets
  • Defining review processes and accountability for AI-generated code
Module 6 Practice lab: Software Architecture
  • Documenting architecture decisions
  • Reconstructing existing architecture
  • Evaluating alternatives
  • Generating fitness functions
  • Guardrails for coding agents
  • Carving out domains
Module 7 Data protection, quality & transfer to daily work
  • Architecture documents often describe security-relevant details such as network zones and data flows: you learn which information may be shared with AI services, how to assess licensing risks of components and how architectural decisions traceably reflect GDPR, NIS2 and Cyber Resilience Act requirements.
  • Ground rules for safe AI use in your team
  • Checking results: facts, sources, tests and the four-eyes principle
  • Personal action plan for the next 30 days
  • Open questions, outlook and resources for further learning

Practical scenarios from your field

Documenting architecture decisions

Turn discussions, meeting notes and pull requests into structured architecture decision records with context, options considered, decision and consequences, stored consistently in the repository. Related decisions are linked automatically.

Reconstructing existing architecture

Analyse existing codebases, extract modules, dependencies and interfaces and generate up-to-date C4 diagrams as diagrams-as-code with PlantUML, Mermaid or Structurizr. Diagrams can be refreshed automatically on every build.

Evaluating alternatives

Compare options such as a modular monolith, microservices or event-driven integration against quality scenarios, cost and team structure, and make trade-offs visible following ATAM principles.

Generating fitness functions

Express architecture rules such as layer access, forbidden dependencies or naming conventions as automated tests with ArchUnit, dependency-cruiser or similar tools and wire them into CI.

Guardrails for coding agents

Describe architectural principles, module boundaries and patterns in rule files and context documents so AI agents follow them reliably when generating code, and spot deviations in review.

Carving out domains

Derive bounded contexts, aggregates and context maps following domain-driven design from event storming results and business descriptions, and use them to shape teams and services.

Possible hands-on projects

ADR assistant

A command-line tool that turns bullet points into a complete ADR from a template, links related decisions and updates an index in the repository.

Dependency visualiser

A script that analyses import relationships in a codebase, flags cycles and layer violations and renders an interactive diagram in the browser.

Architecture Q&A over repos

A small application that indexes ADRs, diagrams and code and answers architecture questions with references to the underlying sources. New team members onboard faster.

Prerequisites

You program regularly in at least one language and are familiar with Git and a modern IDE. You have several years of development experience and have made or supported architectural decisions in larger software systems.

Technical requirements

Your own laptop with the Windsurf editor, Git and your usual toolchain installed; a Windsurf account with access to Cascade is required.

Data protection & compliance

Architecture documents often describe security-relevant details such as network zones and data flows: you learn which information may be shared with AI services, how to assess licensing risks of components and how architectural decisions traceably reflect GDPR, NIS2 and Cyber Resilience Act requirements.

Suggested dates

All dates are suggestions – your preferred date is always possible.

  • Thu, 26 November 2026 – Fri, 27 November 2026 Online Request
  • Thu, 10 December 2026 – Fri, 11 December 2026 Stuttgart Request
  • Tue, 12 January 2027 – Wed, 13 January 2027 Online Request
  • Wed, 27 January 2027 – Thu, 28 January 2027 Berlin Request
  • Thu, 11 February 2027 – Fri, 12 February 2027 Online Request
  • Thu, 18 February 2027 – Fri, 19 February 2027 Munich Request

Frequently asked questions

What does Windsurf mean by flows?

Flows describe the close collaboration between you and Cascade. The agent observes what you do in the editor and terminal and takes those actions into account in its next steps. As a result you do not have to keep explaining where you are, and you can move smoothly between doing the work yourself and delegating it to the agent.

How do memories, rules and workflows differ?

Memories store knowledge that Cascade has gathered while working or that you have explicitly recorded. Rules are guidelines you write that shape the agent’s behaviour permanently. Workflows are reusable sequences of steps for recurring tasks, launched with a slash command. Together they keep results consistent across the whole team.

Can I use Windsurf with my existing projects and languages?

Yes. Windsurf is language-agnostic and works with your existing toolchain, including build tools, package managers and test frameworks. Whether you work on back end, front end, data processing or infrastructure code, what matters is giving Cascade good rules and clear context. Each course variant adds the specific focus for your field.

Can AI make architecture decisions?

AI is a strong sparring partner: it offers options, names trade-offs, finds gaps in reasoning and documents decisions in a structured way. Responsibility stays with people, because architecture depends on business context, team skills, budget and risk appetite. In the course you learn to use AI so that decisions are better reasoned and made faster.

How do we stop AI agents from eroding the architecture?

Through a combination of clear context and automated checks: rule files and ADRs describe module boundaries and patterns, fitness functions and architecture tests in CI block violations, and reviews focus on structural changes. Architecture thus turns from documentation into a verifiable guardrail for humans and agents alike.

How much does “Windsurf for Software Architects” cost?

The course costs a flat €949 plus VAT per participant – whether online or on-site. This includes 2 training day(s) with a live trainer, course materials, a lab environment and a certificate of attendance.

Can I suggest my own date?

Yes. Our suggested dates are just a guide. In the request form you can always describe your preferred date or period in free text – we check availability and confirm within one working day.

Is the course online or on-site?

Both are possible: live online in a virtual classroom or on-site in Munich, Salzburg, Berlin, Augsburg, Hanover, Bremen, Stuttgart or Kaiserslautern. We can also run the course exclusively for your team.

More courses for Software Architects

More Windsurf courses

All 32 Windsurf courses

Windsurf · MunichWindsurf · SalzburgWindsurf · BerlinWindsurf · AugsburgWindsurf · HanoverWindsurf · BremenWindsurf · StuttgartWindsurf · KaiserslauternWindsurf · Online