Docs/Teams/Gemeinsamer Kontext & Standards

Gemeinsamer Kontext & Standards

Aktualisiert 22. Aug. 2026Teams

Wie Organisationsregeln, AGENTS.md und gemeinsamer Projektkontext dafür sorgen, dass mehrere Entwickler eine Architektur erzeugen.

Zwei Entwickler, zwei Chats, eine Codebasis. Ohne gemeinsame Regeln erzeugt eine KI zwei verschiedene Architekturen im selben Repository. XAIO setzt Standards auf zwei Ebenen — und beide erreichen den Agenten bei jedem Turn, nicht einmalig bei der Einrichtung.

Organisationsregeln

Im Platform-Builder-Plan definiert eine Organisation einen Satz Regeln für alle ihre Projekte: Architekturprinzipien, Namenskonventionen, vorgeschriebene Technologien, Coding-Standards und Muster, die nicht erlaubt sind.

Die Regeln liegen an der Organisation, nicht in den Projektdateien. Sie werden zu Beginn jedes Chat-Turns vom Server gelesen und in die Anweisungen des Agenten gestellt, unter einer Überschrift, die sie als für die Organisation verbindlich kennzeichnet. Ein Projekt kann sich ihnen nicht stillschweigend entziehen, und niemand kann sie durch das Bearbeiten einer Datei im Repository überschreiben.

Erlaubte Modelle. Eine Organisation kann außerdem einschränken, welche KI-Modelle ihre Projekte verwenden dürfen. Ist ein Projekt auf ein Modell außerhalb dieser Liste festgelegt, wird es nicht verwendet — der Turn läuft stattdessen auf dem Standardmodell, und der Versuch wird protokolliert.

Projektregeln — AGENTS.md

Jedes Projekt kann eigene Anweisungen in AGENTS.md ablegen, einer normalen Datei im Wurzelverzeichnis der Projektquellen.

Weil die Datei in Git liegt, ist eine Regeländerung eine Änderung am Repository. Sie taucht im Diff auf, durchläuft dieselbe Prüfung wie jede andere Änderung und ist mit dem Release versioniert, zu dem sie gehört. Auch Monate später zeigt die Historie, welche Regeln galten, als ein Feature entstand.

Nutze die Organisationsebene für das, was sich zwischen Projekten nie unterscheiden darf, und AGENTS.md für das, was ein Produkt ausmacht: seine Fachsprache, die Fremdsysteme, mit denen es spricht, die Konventionen, auf die sich sein Team geeinigt hat.

Gemeinsamer Projektkontext

Der Chat-Verlauf gehört dem Projekt, nicht der Person, die getippt hat. Er wird bei den Projektdateien gespeichert — die Begründung hinter einer Entscheidung verschwindet also nicht in einer privaten Sitzung, wenn jemand im Urlaub ist oder das Team verlässt.

Eine Architektur als Default

Jede Web-App, die XAIO erzeugt, hat dieselbe Form: React-Frontend, Python/FastAPI-Backend und eine eigene PostgreSQL-Datenbank. Dazu arbeitet der Generator nach festen Korrektheitsregeln — Geld als Decimal und nie als Float, Zeitstempel als TIMESTAMPTZ in UTC, Foreign Keys mit explizitem Löschverhalten, Unique- und Check-Constraints, Soft Deletes und eine versionierte Migration für jede Schemaänderung.

Der praktische Effekt im Team: Zwei Entwickler, die nie miteinander gesprochen haben, erzeugen Code, der aussieht, als käme er von derselben Person.