app-entwickeln-lassen.de LogoApp entwickeln lassen

KI in der Softwareentwicklung

Context Engineering: Warum Kontext die Qualität von KI-Code bestimmt

Redaktion app-entwickeln-lassen.de 5 Min. Lesezeit
Inhalt
  1. Was Context Engineering ist – und was nicht
  2. Die Bestandteile des Kontexts bei Coding-Agents
  3. Warum mehr Kontext nicht automatisch besser ist
  4. Context Engineering in der Praxis: sechs Maßnahmen
  5. Spezifikationen als stärkster Kontext
  6. Typische Fehler im Context Engineering
  7. Checkliste: Ist Ihr Projekt bereit für Coding-Agents?
  8. Fazit
  9. Häufige Fragen

Context Engineering ist die Disziplin, einem KI-Modell zur richtigen Zeit die richtigen Informationen bereitzustellen – und Unwichtiges wegzulassen. Bei Coding-Agents entscheidet der Kontext oft stärker über die Qualität des Ergebnisses als die Wahl des Modells oder die Formulierung des Prompts. Dieser Beitrag erklärt, woraus der Kontext besteht, wie Sie ihn systematisch aufbauen und welche Fehler Sie vermeiden sollten.

Was Context Engineering ist – und was nicht

Ein Sprachmodell weiß über Ihr Projekt nur, was in seinem aktuellen Kontextfenster steht: Anweisungen, gelesene Dateien, Ausgaben von Befehlen, bisheriger Gesprächsverlauf. Alles andere – Ihre Architekturentscheidungen, Namenskonventionen, das Wissen, warum ein Modul so seltsam aussieht – existiert für das Modell nicht. Context Engineering bedeutet, diesen Kontext bewusst zu gestalten.

Abgrenzung zum Prompt Engineering: Ein Prompt ist die einzelne Aufgabe. Context Engineering umfasst alles, was dauerhaft und automatisch mitgeliefert wird oder das der Agent sich selbst beschaffen kann. Wer gute Prompts schreiben möchte, findet Hinweise im Beitrag Prompt Engineering für Entwickler; dieser Artikel konzentriert sich auf die Ebene darüber.

Die Bestandteile des Kontexts bei Coding-Agents

KontextquelleInhaltWer pflegt sie?
Projektregeln / KontextdateienArchitektur, Konventionen, Befehle für Build und Tests, TabusTeam, versioniert im Repository
Code selbstStruktur, Benennung, Beispiele für gute MusterAlle Entwickler
DokumentationArchitekturentscheidungen, Fachbegriffe, SchnittstellenTeam, idealerweise nah am Code
AufgabenbeschreibungZiel, Akzeptanzkriterien, GrenzenProduct Owner und Entwickler
WerkzeugausgabenTestergebnisse, Compilerfehler, LogsAutomatisch durch den Agent
Angebundene SystemeTickets, Datenbankschema, Designs, interne WikisÜber Schnittstellen wie MCP
GesprächsverlaufBisherige Schritte und Entscheidungen der SitzungEntsteht während der Arbeit

Warum mehr Kontext nicht automatisch besser ist

Kontextfenster sind groß geworden, aber nicht unbegrenzt – und vor allem nicht kostenlos. Zu viel Kontext hat drei Nachteile:

  • Verwässerung: Wichtige Hinweise gehen zwischen irrelevanten Informationen unter. Modelle gewichten nicht alles gleich zuverlässig.
  • Widersprüche: Veraltete Dokumentation neben aktuellem Code führt zu inkonsistenten Ergebnissen.
  • Kosten und Tempo: Jeder Token im Kontext kostet Rechenzeit und bei nutzungsbasierter Abrechnung Geld.

Gutes Context Engineering heißt daher: so wenig wie möglich, so viel wie nötig – und das Richtige zur richtigen Zeit.

Context Engineering in der Praxis: sechs Maßnahmen

  1. Eine kompakte Kontextdatei pflegen: Viele Tools lesen automatisch eine Datei mit Projektregeln im Repository. Sie sollte kurz und konkret sein: Tech-Stack, Verzeichnisstruktur, Befehle für Build, Tests und Linter, wichtige Konventionen, absolute Tabus. Details zum Aufbau finden Sie unter Projektregeln und Kontextdateien für Coding-Agents richtig schreiben.
  2. Kontext hierarchisch organisieren: Allgemeine Regeln im Wurzelverzeichnis, modulspezifische Hinweise in Unterverzeichnissen. So bekommt der Agent nur, was für den aktuellen Bereich relevant ist.
  3. Auf Quellen verweisen statt kopieren: Statt die ganze Architekturdokumentation in die Kontextdatei zu schreiben, verweisen Sie auf die Datei. Der Agent liest sie, wenn er sie braucht.
  4. Code als Kontext verbessern: Sprechende Namen, klare Modulgrenzen und ein gutes Referenzbeispiel pro Muster helfen Menschen und Agents gleichermaßen.
  5. Werkzeuge anbinden: Über Standards wie das Model Context Protocol (MCP) kann ein Agent Tickets, Datenbankschemata oder Dokumentation gezielt abrufen, statt dass alles vorab in den Kontext geladen wird. Berechtigungen dabei eng fassen.
  6. Sitzungen bewusst steuern: Lange Sitzungen sammeln veralteten Kontext an. Für neue Aufgaben lieber neu beginnen, und Zwischenergebnisse in einer kurzen Notiz oder einem Plan festhalten.

Spezifikationen als stärkster Kontext

Der wertvollste Kontext für eine konkrete Aufgabe ist eine gute Spezifikation: Was soll gebaut werden, welche Regeln gelten, welche Fälle müssen funktionieren? Teams, die Spezifikationen vor der Umsetzung schreiben und versioniert ablegen, geben Agents eine belastbare Grundlage und Reviewern einen Maßstab. Dieser Ansatz wird als Spec-Driven Development bezeichnet; mehr dazu in Spec-Driven Development: Spezifikationen als Steuerung für KI.

Typische Fehler im Context Engineering

  • Kontextdatei als Roman: Seitenlange Regelwerke werden nur teilweise beachtet. Kurz, priorisiert und konkret schreiben.
  • Einmal geschrieben, nie gepflegt: Kontextdateien veralten wie jede Dokumentation. Änderungen am Projekt sollten in derselben Pull Request auch die Regeln aktualisieren.
  • Vage Regeln: „Schreibe sauberen Code“ hilft nicht. „Nutze für HTTP-Aufrufe ausschließlich den ApiClient in core/network“ hilft.
  • Vertrauliches im Kontext: Zugangsdaten, Kundendaten oder interne Geheimnisse gehören nicht in Kontextdateien oder Prompts.
  • Jeder pflegt seinen eigenen Kontext: Private Notizen einzelner Entwickler führen zu unterschiedlichen Ergebnissen. Gemeinsame Regeln gehören ins Repository.

Checkliste: Ist Ihr Projekt bereit für Coding-Agents?

  • Kontextdatei mit Tech-Stack, Struktur, Befehlen und Konventionen vorhanden
  • Build, Tests und Linter lassen sich mit einem Befehl ausführen
  • Architekturentscheidungen sind kurz dokumentiert und verlinkt
  • Für jedes wichtige Muster gibt es ein Referenzbeispiel im Code
  • Aufgaben werden mit Akzeptanzkriterien beschrieben
  • Angebundene Werkzeuge haben minimale Berechtigungen
  • Kontextdateien werden bei Änderungen im Review mitgeprüft

Context Engineering ist eine Teamkompetenz, die sich am besten gemeinsam am eigenen Repository aufbauen lässt. In unseren Workshops vermitteln wir KI-Entwickler aus der Praxis als Trainer, die genau das mit Ihrem Team erarbeiten – ab 799 € netto, Anfrage per E-Mail an team@app-entwickeln-lassen.de.

Sie planen eine App? Kostenloses Festpreis-Angebot in 2 Minuten anfordern

Fazit

Ob ein Coding-Agent brauchbaren oder mittelmäßigen Code liefert, hängt maßgeblich vom Kontext ab, den er erhält. Context Engineering macht diesen Kontext zu einem gepflegten Bestandteil des Projekts: kompakte Projektregeln, gute Spezifikationen, sauberer Code als Vorbild und gezielt angebundene Werkzeuge. Teams, die hier investieren, bekommen konsistentere Ergebnisse, weniger Nacharbeit und eine Codebasis, die auch für Menschen verständlicher wird.

Häufige Fragen

Was ist der Unterschied zwischen Context Engineering und Prompt Engineering?

Prompt Engineering optimiert die einzelne Aufgabenformulierung. Context Engineering gestaltet alle Informationen, die ein Modell dauerhaft oder bei Bedarf erhält, etwa Projektregeln, Dokumentation, Code-Beispiele und angebundene Werkzeuge.

Wie lang sollte eine Kontextdatei für Coding-Agents sein?

So kurz wie möglich, meist reichen wenige Bildschirmseiten. Details gehören in verlinkte Dokumente, die der Agent bei Bedarf liest.

Hilft ein größeres Kontextfenster automatisch?

Nicht automatisch. Mehr Kontext kann wichtige Hinweise verwässern und erhöht Kosten; entscheidend ist, dass relevante Informationen gezielt und widerspruchsfrei bereitstehen.

Wer im Team ist für den Kontext verantwortlich?

Das gesamte Team. Bewährt hat sich, Kontextdateien im Repository zu versionieren und Änderungen daran wie Code zu reviewen.

Dieser Artikel wurde von der Redaktion von app-entwickeln-lassen.de erstellt – dem App- und KI-Entwicklungsangebot der jocapps GmbH aus Freiburg, seit 2014 in der App-Entwicklung aktiv. Die Inhalte dienen der allgemeinen Information und ersetzen keine individuelle (Rechts-)Beratung.

Das könnte Sie auch interessieren

KI in der SoftwareentwicklungSicherheitsrisiken von KI-generiertem Code – und wie Sie sie vermeiden

Sicherheitsrisiken von KI-generiertem Code erkennen: typische Schwachstellen, erfundene Pakete, Prompt Injection – plus Prüfprozess, der Ihr Team schützt.

6 Min. Lesezeit
KI in der SoftwareentwicklungKI-Coding-Tools auswählen: Worauf Unternehmen 2026 achten sollten

KI-Coding-Tools auswählen: Die wichtigsten Kriterien für Unternehmen 2026 – Datenschutz, Kosten, Integration – plus Bewertungsmatrix und Ablauf für den Test.

5 Min. Lesezeit
KI in der SoftwareentwicklungKI-Coding-Tools und Datenschutz: Darf mein Quellcode in die Cloud?

KI-Coding-Tools und Datenschutz: Wann Quellcode in die Cloud darf, was AVV, Training und Datenhaltung bedeuten – mit Prüfliste für eine sichere Tool-Freigabe.

6 Min. Lesezeit
KI in der SoftwareentwicklungTestautomatisierung mit KI: Unit-, Integrations- und E2E-Tests

Testautomatisierung mit KI: Wie Sie Unit-, Integrations- und E2E-Tests schneller erstellen, typische Fallen vermeiden und die Aussagekraft Ihrer Tests sichern.

6 Min. Lesezeit
KI in der SoftwareentwicklungVibe Coding vs. professionelle Softwareentwicklung: Wo die Grenze liegt

Vibe Coding vs. professionelle Softwareentwicklung: Wofür sich schnelles Prompten eignet, wo die Risiken beginnen und wie Sie den Übergang sauber gestalten.

5 Min. Lesezeit
KI in der SoftwareentwicklungKI in Code-Reviews: Chancen, Grenzen und Best Practices

KI in Code-Reviews: Was automatische Reviewer zuverlässig finden, wo sie versagen und wie Sie KI-Vorprüfung und menschliches Review sinnvoll kombinieren.

5 Min. Lesezeit