Training course · Claude Code · Software Architecture

Claude Code for Software Architects

Agentic coding with Claude Code in the terminal and IDE: CLAUDE.md, subagents, hooks, MCP, CI pipelines and secure permissions.

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

“Claude Code 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 Claude Code productively, safely and transparently in Software Architecture – from the fundamentals to advanced workflows.

Claude Code is Anthropic’s agentic coding assistant, working directly in your terminal and in popular IDEs. Rather than completing individual lines, it reads your repository, plans changes across multiple files, runs commands, executes tests and prepares commits. Over two days you will learn to use it with deliberate control: clear project instructions in CLAUDE.md, careful context management, and a workflow in which you set the direction as a developer and can trace every change the agent makes back to a clear intention.

The course is built around real engineering work: diagnosing bugs, delivering features, refactoring legacy code and filling gaps in test coverage. You will configure subagents for specialised tasks, enforce quality checks with hooks, connect external systems through the Model Context Protocol (MCP) and capture team knowledge as reusable skills. Finally, you will run Claude Code headless in CI pipelines and define permissions, sandboxing and approval rules so that its use remains defensible even in security-sensitive environments.

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 Claude Code for multi-step development tasks while keeping full control over every change.
  • You maintain a CLAUDE.md that effectively conveys project conventions, commands and architectural guidance to the agent.
  • You extend Claude Code with subagents, hooks, MCP servers and skills tailored to your team.
  • You integrate Claude Code into Git workflows and CI pipelines with traceable, test-backed results.
  • 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 How Claude Code works
  • Installation, sign-in and use in the terminal, VS Code and JetBrains IDEs
  • Understanding the agentic loop: read, plan, act, verify
  • Using plan mode to agree on an approach before any code changes
  • Writing effective task briefs with goal, context and acceptance criteria
Module 2 Project context with CLAUDE.md and context management
  • Structuring CLAUDE.md at project, directory and user level
  • Documenting build, test and style conventions so the agent follows them reliably
  • Managing the context window with targeted file references, compaction and fresh sessions
  • Resuming sessions and breaking long tasks into manageable stages
Module 3 Extending Claude Code with subagents, hooks, MCP and skills
  • Defining subagents for code review, research or test generation
  • Using hooks to enforce formatting, linting or checks before and after tool calls
  • Connecting MCP servers for issue trackers, databases or internal documentation
  • Creating custom slash commands and skills for recurring team workflows
Module 4 Git workflows, testing and quality assurance
  • Creating branches, meaningful commits and pull requests with Claude Code
  • Test-first work: have tests written before the implementation
  • Reviewing diffs systematically and rejecting or refining changes
  • Organising parallel work with Git worktrees and multiple sessions

Day 2

Module 5 Headless operation, CI and security
  • Running Claude Code non-interactively in scripts and CI pipelines
  • Automated reviews and issue handling in GitHub or GitLab workflows
  • Configuring permission modes, allow and deny rules, and sandboxing
  • Handling secrets, prompt injection risks and organisation-wide policies
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 have hands-on programming experience in at least one language and are comfortable with Git and the command line. You have several years of development experience and have made or supported architectural decisions in larger software systems.

Technical requirements

Your own laptop with admin rights, Git, a Node.js runtime and an up-to-date editor; a Claude subscription or Anthropic API access is required for the exercises.

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
  • Mon, 11 January 2027 – Tue, 12 January 2027 Online Request
  • Mon, 18 January 2027 – Tue, 19 January 2027 Berlin Request
  • Mon, 25 January 2027 – Tue, 26 January 2027 Online Request
  • Wed, 10 February 2027 – Thu, 11 February 2027 Munich Request

Frequently asked questions

How is Claude Code different from traditional code completion?

Code completion suggests the next few lines, whereas Claude Code acts as an agent that handles whole tasks: it searches the repository, plans changes across several files, runs tests and commands, and corrects itself based on the results. You define the goal and review the outcome instead of steering every single line yourself.

Is Claude Code secure enough for enterprise use?

By default, Claude Code asks for approval before editing files or running commands. Permission rules, sandboxing, managed settings and hooks let you define precisely what the agent may do. During the course you learn to configure these mechanisms to match your security and data protection requirements and to assess risks such as prompt injection.

Does Claude Code work with my language and tech stack?

Yes. Claude Code is language-agnostic because it works with files, terminal commands and your existing build and test tooling. Whether you use Python, Java, TypeScript, Go, SAP-related code or infrastructure as code, what matters most is a well-written CLAUDE.md describing your commands and conventions. Each course variant adds the relevant domain focus.

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 “Claude Code 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 Claude Code courses

All 77 Claude Code courses

Claude Code · MunichClaude Code · SalzburgClaude Code · BerlinClaude Code · AugsburgClaude Code · HanoverClaude Code · BremenClaude Code · StuttgartClaude Code · KaiserslauternClaude Code · Online