Zum Inhalt springen
Reality Graph

Governance

Die KI-Coding-Richtlinien-Vorlage

Zuletzt aktualisiert: 2026-07-02Lesezeit ca. 4 Min.

Eine KI-Coding-Richtlinie braucht acht Abschnitte: freigegebene Tools, Datenregeln pro Klassifizierung, Auftragsregeln für Agent-Runs, Verifikationspflichten pro Änderung, Belege, Rechte-Grenzen für Agenten, Ausnahmen und Verantwortung mit Review-Rhythmus. Die komplette Vorlage steht auf dieser Seite - ohne Schranke, bereit zum Anpassen. Ihr Designprinzip: Jede Regel trägt ihren Durchsetzungsmechanismus, denn eine Regel, die vom Gedächtnis abhängt, wird unter Termindruck optional.

Tests grünDiff gelesenauth.py geändertFreigabeblockiertgrüne Tests heben das nicht auf
Inhalt

Warum eine Richtlinie - und warum diese kurz ist

Die Zahlen hinter dem Bedarf sind in ihrem Missverhältnis deutlich: 84 % der Entwickler nutzen KI-Tools, aber nur 48 % prüfen konsequent, was diese Tools erzeugen - in den meisten Teams existieren die Regeln als Folklore. Unser Governance-Überblick zeichnet das ganze Kontrollbild; diese Seite trägt das eine Artefakt, an dem alles andere hängt. Sie ist absichtlich kurz. Richtlinien scheitern an Länge: Die Vierzig-Seiten-Version wird einmal unterschrieben und nie geöffnet - und ihre Autoren verwechseln die Unterschrift mit Akzeptanz.

Die acht Abschnitte - und warum jeder seinen Platz verdient

Jeder Abschnitt trägt eine Regel und den Mechanismus, der sie durchsetzt - von schriftlicher Absicht mit Grenzen vor einem Agent-Run bis zu advisory-by-default-Agenten mit kein Auto-Commit. Der Test, der über einen Abschnitt entscheidet: Benennt, wie er durchgesetzt wird - oder streicht ihn.

Jeder Abschnitt paart eine Regel mit dem Mechanismus, der sie durchsetzt; der Test der Seite ist einfach - wenn morgen alle die Richtlinie vergessen, gelten die Regeln mit Mechanismus trotzdem noch, und der Rest ist dokumentierte Absicht.
Die RegelIhr Durchsetzungsmechanismus
1 · Tools & AccountsNur freigegebene Tools auf Firmen-Accounts; Consumer- und Free-Tarife sind für Arbeit untersagt.Redaktionelle Einordnung · 2026-07Verwaltete Accounts und SSO - die Account-Stufe wird beim Login durchgesetzt, nicht per Goodwill.Redaktionelle Einordnung · 2026-07
2 · DatenregelnDaten erreichen Tools nach Klassifizierung; vertraulicher Code und personenbezogene Daten bleiben lokal.Redaktionelle Einordnung · 2026-07Filter und lokale Verarbeitung - die Datenklasse entscheidet, nicht der Entwickler unter Termindruck.Redaktionelle Einordnung · 2026-07
3 · AuftragsregelnJeder Agent-Run hat vor dem Start ein schriftliches Ziel, Grenzen und Akzeptanzkriterien.Redaktionelle Einordnung · 2026-07Der Agent-Workflow hat nichts zu prüfen, solange der Auftrag nicht aufgeschrieben ist.Redaktionelle Einordnung · 2026-07
4 · VerifikationBuild, Typen und änderungsrelevante Tests bestehen pro Änderung - nicht vom generierenden Modell verfasst.Redaktionelle Einordnung · 2026-07Ein Gate, das pro Änderung läuft, setzt sich selbst durch - anders als eine Regel, die um Wachsamkeit bittet.Redaktionelle Einordnung · 2026-07
5 · BelegeEin Run-Nachweis - Auftrag, Tool, Diff-Umfang, Validierungen, Freigebender - liegt beim Code.Redaktionelle Einordnung · 2026-07Der Bericht ist ein Nebenprodukt des Runs, kein Dokument, das jemand nachträglich verfasst.Redaktionelle Einordnung · 2026-07
6 · Agenten-RechteAgenten sind advisory by default: kein Auto-Commit, keine Writes auf geschützte Branches, kein Produktionszugriff.Redaktionelle Einordnung · 2026-07Die Grenzen stehen in den Tool-Berechtigungen, also halten sie, ohne dass sich jemand erinnert.Redaktionelle Einordnung · 2026-07
7 · AusnahmenAusnahmen werden mit Grund und Ablaufdatum beantragt und in einem Register protokolliert.Redaktionelle Einordnung · 2026-07Abgelaufene Ausnahmen fallen automatisch auf die Richtlinie zurück; das Register ist zugleich Audit-Trail.Redaktionelle Einordnung · 2026-07
8 · Verantwortung & ReviewEin benannter Owner; ein quartalsweises Review von Tool-Liste, Vorfällen und Anbieter-Bedingungen.Redaktionelle Einordnung · 2026-07Ein terminiertes Review mit benanntem Owner - herrenlose Richtlinien werden schlicht nie geprüft.Redaktionelle Einordnung · 2026-07
Jeder Abschnitt paart eine Regel mit dem Mechanismus, der sie durchsetzt; der Test der Seite ist einfach - wenn morgen alle die Richtlinie vergessen, gelten die Regeln mit Mechanismus trotzdem noch, und der Rest ist dokumentierte Absicht.

Wer welchen Abschnitt verantwortet

Eine Richtlinie bindet nur, wenn jeder Abschnitt eine benannte Verantwortung hat. Das ist die Verantwortung, die das Dokument voraussetzt - vier Rollen, die die acht Abschnitte unter sich tragen; übertragt sie auf eure eigenen Titel.

Eine Richtlinie bindet nur, wenn jeder Abschnitt eine benannte Verantwortung hat; das ist die eigene Zuordnung der Seite - die acht Abschnitte zu den vier Rollen, die sie tragen - kein Personalstandard. Lest sie als die Verantwortung, die das Dokument voraussetzt, und übertragt sie auf eure eigenen Titel.
Richtlinien-OwnerEntwicklerFreigebende:rDatenschutz-Kontakt
VerantwortetWelche Richtlinien-Abschnitte diese Rolle aktuell hältDas ganze Dokument - die Tool-Liste (§1), das Ausnahme-Register (§7) und den Review-Rhythmus.Redaktionelle Einordnung · 2026-07Abschnitt 3 und 4 im Alltag - ein schriftlicher Auftrag vor jedem Agent-Run und die Checks danach.Redaktionelle Einordnung · 2026-07Abschnitt 6 am Gate - advisory-by-default-Agenten, kein Auto-Commit, ein menschliches Ja oder Nein.Redaktionelle Einordnung · 2026-07Abschnitt 2 - die Datenklassen, was welches Tool erreichen darf, und die Regeln für personenbezogene Daten.Redaktionelle Einordnung · 2026-07
EntscheidetDie Entscheidung, die genau diese Rolle trifftWas freigegeben ist, wer eine Ausnahme bekommt und wann das Quartals-Review stattfindet.Redaktionelle Einordnung · 2026-07Ob eine Änderung reif für den Review ist - nie, ob sie sich selbst merged.Redaktionelle Einordnung · 2026-07Ob eine verifizierte Änderung merged - mit dem Prüfbericht vor Augen.Redaktionelle Einordnung · 2026-07Welche Klassifizierung eine Datenklasse bekommt und wo nur lokale Verarbeitung Pflicht ist.Redaktionelle Einordnung · 2026-07
Haftet, wenn es scheitertWas auf diese Rolle fällt, wenn eine Regel rutschtEine veraltete Tool-Liste oder eine Richtlinie, die niemand vor einem Vorfall geprüft hat.Redaktionelle Einordnung · 2026-07Einen Agenten ohne schriftlichen Auftrag zu starten oder die Prüfung pro Änderung zu überspringen.Redaktionelle Einordnung · 2026-07Auf Vertrauen zu mergen, ohne die Änderung gegen Auftrag und Grenzen zu prüfen.Redaktionelle Einordnung · 2026-07Vertraulichen Code oder personenbezogene Daten, die in einen Cloud-Prompt gelangen.Redaktionelle Einordnung · 2026-07
Fehlt, und es zeigt sich alsDer Fehlermodus, wenn die Rolle unbesetzt bleibtDie Richtlinie wird nach einem Vorfall wiederentdeckt, statt vorher gepflegt zu werden.Redaktionelle Einordnung · 2026-07Regeln leben als Folklore; die Absicht bleibt im Prompt und verdunstet nach dem Run.Redaktionelle Einordnung · 2026-07Die Abnahme geschieht nach Gefühl; das Gate ist informell und nichts ist prüfbar.Redaktionelle Einordnung · 2026-07Der Abschnitt, den Kunden und Auditoren zuerst lesen, wird unter Druck zum Ratespiel.Redaktionelle Einordnung · 2026-07
Eine Richtlinie bindet nur, wenn jeder Abschnitt eine benannte Verantwortung hat; das ist die eigene Zuordnung der Seite - die acht Abschnitte zu den vier Rollen, die sie tragen - kein Personalstandard. Lest sie als die Verantwortung, die das Dokument voraussetzt, und übertragt sie auf eure eigenen Titel.

Die Vorlage

ki-coding-richtlinie.mdtext/markdown

Beispiel - an euer Team anpassen
# KI-Coding-Richtlinie · <Team> · v1.0 · Owner: <Name> · Review: quartalsweise

## 1 Tools & Accounts
Freigegeben: <Claude Code, Cursor, Copilot> nur auf Firmen-Accounts.
Consumer-/Free-Tarife: für Arbeit untersagt. Neue Tools: <Owner> fragen.

## 2 Datenregeln
Öffentlicher/interner Code: in freigegebenen Tools erlaubt.
Vertraulich (Kundencode, infra/secrets/*, Prod-Daten): nur lokale
Verarbeitung - nie in Cloud-Prompts oder -Kontext.
Personenbezogene Daten in Prompts/Fixtures/Logs: untersagt (DSB-Notiz).

## 3 Auftragsregeln (Agent-Runs)
Jeder Agent-Run hat VOR dem Start einen schriftlichen Auftrag:
Ziel · Grenzen (erlaubte Dateien/Verzeichnisse) · Akzeptanzkriterien.
Kein Auftrag, kein Run - "Quick Fixes" eingeschlossen.

## 4 Verifikation (pro Änderung)
Muss vor dem Review bestehen: Build · Typen · änderungsrelevante Tests.
Validierung stammt nicht vom generierenden Modell / derselben Session.
Die Änderung wird gegen den Auftrag geprüft (Umfang + Kriterien).

## 5 Belege (pro Run)
Ein Run-Nachweis liegt beim Code: Auftrag, Tool+Version, Diff-Umfang,
Validierungen + Ergebnisse, Übersprungenes, Freigebender.

## 6 Agenten-Rechte
Agenten sind advisory by default: vorschlagen, nie unbeaufsichtigt
anwenden. Kein Auto-Commit. Keine direkten Writes auf geschützte
Branches. Kein Zugriff auf Produktion, Credentials, Kundendaten.

## 7 Ausnahmen
Antrag an <Owner> mit Grund + Ablaufdatum. Protokolliert in <Register>.
Abgelaufene Ausnahmen fallen automatisch auf die Richtlinie zurück.

## 8 Vorfälle
KI-zugeschriebener Defekt oder Daten-Ausrutscher: Meldung an <Kanal>
binnen 24h. Blameless Review; Richtlinien-Lücken-Check gehört zu
jedem Postmortem.
Die vollständige Acht-Abschnitte-Vorlage, auf der Seite und ohne Schranke: freigegebene Tools, Datenklassen, Auftragsregeln, Verifikation, Belege, Agenten-Rechte, Ausnahmen und Vorfälle. Die Platzhalter in spitzen Klammern sind die eigentliche Arbeit - das Dokument bindet niemanden, bis sie ausgefüllt sind und das Justiziariat es gelesen hat.Das ist eine illustrative Startvorlage zum Anpassen an euer Team, keine fertige Richtlinie und keine Rechtsberatung.

Anpassungshinweise: Ein Fünf-Personen-Team kann Abschnitt 7 und 8 auf zwei Zeilen eindampfen; ein reguliertes Team erweitert Abschnitt 2 um sein Klassifizierungsschema und Abschnitt 5 um Aufbewahrungsregeln. Was jede Anpassung überleben sollte, ist die Struktur von Abschnitt 4 und 6 - Verifikation pro Änderung und Advisory-by-default sind die zwei Regeln mit dem größten Risiko, wenn sie erodieren.

Typische Fehlermodi

  • Die Vierzig-Seiten-Richtlinie. Vollständigkeit fühlt sich verantwortungsvoll an und liest sich als Rauschen. Jeder Abschnitt, der kein Verhalten ändert, verdünnt die, die es müssen.
  • Alles verbieten. Bei 84 % Nutzung stoppt ein Verbot nicht die Nutzung - es stoppt die Offenlegung. Die BSI/ANSSI-Linie - ermöglichen mit Regeln, Output prüfen - ist sicherer und durchsetzbar.
  • Regeln ohne Mechanismen. „Entwickler sollen KI-Code sorgfältig prüfen“ ist ein Wunsch. Ein Gate, das pro Änderung läuft, ist eine Regel. Schreibt nur Regeln, die ihr mit einem Mechanismus hinterlegen könnt - und benennt den Mechanismus in der Richtlinie. Für die Freigabe-Klausel ist dieser Mechanismus das Gate, an dem auch ein grüner Run stehen bleibt.

Wo Reality Graph ansetzt

Abschnitt 3 bis 6 der Vorlage beschreiben fast Zeile für Zeile, was Reality Graph mechanisiert: schriftliche Aufträge mit Grenzen, Verifikation jedes Runs dagegen, ein Prüfbericht pro Run, Advisory-by-default ohne Auto-Commit als Architektur statt Versprechen. Die Richtlinie steht ohne jedes bestimmte Tool - Reality Graph macht aus ihren mittleren Abschnitten Defaults statt manueller Disziplin.

Diese Vorlage gibt euch

  • Acht Abschnitte mit Begründung pro Abschnitt
  • Das volle Dokument auf der Seite - keine Download-Schranke
  • Einen benannten Durchsetzungsmechanismus pro Regel
  • Anpassungshinweise für kleine und regulierte Teams
  • Einen benannten Owner und einen Review-Rhythmus pro Abschnitt

Sie gibt euch nicht

  • Eine universelle oder allgemeingültige Richtlinie - sie ist eine Startvorlage zum Anpassen, kein Standard, den ihr erfüllen könnt
  • Rechtsprüfung - euer Justiziariat liest sie, bevor sie jemanden bindet
  • Eine Richtlinie, die unangepasst funktioniert - die Platzhalter sind echte Arbeit
  • Durchsetzung von selbst - Mechanismen müssen wirklich verdrahtet werden
  • Abdeckung von KI jenseits des Codings - bewusst scopen oder erweitern
Das ist eine anpassbare Startvorlage, keine universelle Richtlinie: Sie beansprucht nicht, ein erfüllbarer Standard zu sein, und sie ist keine Rechtsberatung.

FAQ

Was gehört in eine KI-Coding-Richtlinie für Entwicklungsteams?
Acht Abschnitte decken die Arbeitsfälle ab: freigegebene Tools und Accounts; Datenregeln pro Klassifizierungsstufe; Auftragsregeln (schriftliche Absicht vor Agent-Runs). Verifikationspflichten pro Änderung; Belege und Audit-Trail; Rechte-Grenzen für Agenten (kein Auto-Commit); Ausnahmen samt Antragsweg; und Verantwortung mit Review-Rhythmus. Alles andere - Philosophie, Tool-Tutorials, Rechtsaufsätze - gehört woanders hin. Eine Richtlinie, die auf zwei Bildschirme passt, wird gelesen; eine mit vierzig Seiten wird unterschrieben und ignoriert.
Was unterscheidet diese Seite vom KI-Coding-Governance-Artikel?
Der Governance-Artikel ist der Überblick: warum Kontrolle zählt, die Bausteine, die Einführung - mit einer Ein-Bildschirm-Mini-Policy als Illustration. Diese Seite ist die Vertiefung des einen Bausteins Richtlinien-Dokument: die vollständige Vorlage Abschnitt für Abschnitt, mit Begründung pro Abschnitt und Anpassungshinweisen für Teamgröße und Regulierungsgrad. Lest zuerst den Überblick, wenn Governance Neuland ist; startet hier, wenn ihr wisst, dass ihr das Dokument braucht.
Brauchen kleine Teams wirklich eine schriftliche Richtlinie?
Ein Fünf-Personen-Team braucht keine Policy-Abteilung - es braucht dieselben acht Entscheidungen, einmal getroffen und aufgeschrieben, was mit der Vorlage etwa eine Stunde dauert. Die Schriftform zählt auch im Kleinen, aus drei Gründen: Onboarding hört auf, mündliche Überlieferung zu sein. Kunden- und Auditor-Fragen bekommen ein Dokument statt eines Schulterzuckens; und die Regeln überleben die Person, die sie erfunden hat. Skaliert die Zeremonie herunter, nicht die Entscheidungen.
Wie führt man eine Richtlinie ein, ohne Widerstand auszulösen?
Schreibt sie mit den Menschen, die sie bindet, nicht für sie - eine einstündige Session, in der das Team die Vorlage ausfüllt, schlägt jedes Dekret von oben. Verankert jede Regel an einem Fehlermodus, den alle kennen (Secrets im Prompt, ungeprüfte Agent-Merges), statt an Autorität. Und haltet die Durchsetzung mechanisch, wo es geht: Ein Verifikations-Gate, das pro Änderung läuft, setzt sich selbst durch - eine Regel, die von manueller Wachsamkeit abhängt, wird unter Termindruck optional.
Wie oft sollte die Richtlinie überprüft werden?
Quartalsweise ist 2026 der ehrliche Default - Tool-Fähigkeiten, Anbieter-Bedingungen und der Rechtsrahmen bewegen sich schnell genug, dass ein Jahresrhythmus Veralten garantiert. Das Review ist klein: Stimmt die Tool-Liste noch, hat ein Vorfall oder Beinahe-Vorfall eine Lücke gezeigt, haben sich Anbieter-Terms oder Regulierung geändert. Benennt eine verantwortliche Person; Richtlinien ohne Owner werden nicht überprüft, sondern nach einem Vorfall wiederentdeckt.
Was macht eine Richtlinie durchsetzbar statt dekorativ?
Jede Regel braucht einen Mechanismus, und die Vorlage erzwingt diese Frage pro Abschnitt. Tool-Regeln setzen sich über verwaltete Accounts durch, Datenregeln über Filter und lokale Verarbeitung, Auftragsregeln über den Agent-Workflow, Verifikationsregeln über ein Gate pro Änderung, Beleg-Regeln über Reports als Nebenprodukt. Der Test: Wenn morgen alle die Richtlinie vergessen - welche Regeln gelten trotzdem noch? Das sind eure durchgesetzten Regeln; der Rest ist dokumentierte Absicht.

Weiterlesen

Quellen

Wollt ihr sehen, wie euer letzter Agenten-Run ausgesehen hätte?

Zugang anfragen