Architekturrahmen
Code wird billig. Die Ordnung darüber nicht.
Coding Agents erzeugen in Stunden, wofür Teams Wochen brauchten. Diese Seite zeigt, wie ich als Principal Architect die Ordnung über viele Repositories baue, am eigenen System: wer abweichen darf, was gemessen wird, was zusammengehört.
Die Lage
Was die KI-Ära knapp macht
Code war lange der Engpass. Heute schreibt ein Coding Agent in einer Stunde, wofür ein Team eine Woche brauchte. Jedes Team kopiert sich die Standards der Organisation ins eigene Repository, verbessert sie dort und vergisst die Kopie. Ein Jahr später gibt es jeden Standard in mehreren Fassungen, und niemand kann sagen, welche gilt.
Der Engpass wandert nach oben, zur Ordnung über dem Code. Wer darf abweichen, und wie lange? Ob ein Repository auf der Paved Road fährt, die sich die Organisation selbst gegeben hat, wird behauptet und selten gemessen. Und ob die Systeme zusammengehören oder nur nebeneinander liegen, weiß oft niemand. In vielen Häusern ist Governance eine Sitzung, keine prüfbare Ordnung.
Das verschiebt die Arbeit des Architekten: weg vom einzelnen Entwurf, hin zur Ordnung über viele Systeme. Werkzeuge messen. Wer verantwortet, entscheiden sie nicht. So lese ich die Lage nach 25 Jahren in gewachsenen Landschaften.
Woher die Methode kommt
Drei Epochen, eine Frage: Welche Fassung gilt?
Werk · 2004–2006
Maschinensteuerung und Lagerlogistik, hardwarenah in C, darüber Java, eingebaut im laufenden Werksbetrieb.
Konzern · 2006–2020
Konzernweite Softwareentwicklung über sieben Werke: ERP, MES, Logistik, Produktionssteuerung. Danach Enterprise-Architektur, Applikationsportfolio und Migration im laufenden Betrieb.
Plattform · 2022–2025
Eine geschäftskritische Embedded-Software-Plattform mit zwölf Teams, gemeinsame Delivery-Standards und Qualitätstore, deren Wirkung gemessen wurde.
Die Ordnung
Paved Road abwärts, Beförderung aufwärts
Ein Repository ist der Kanon. Jede Kopie eines Standards in den anderen Repositories wird gegen ihn gemessen und hat danach genau einen von vier Zuständen. Nur einer davon ist eine Frage. Was in einem Repository besser geworden ist, wird Kandidat für den Kanon.
Kanon
Inhalt identisch mit dem Kanon. Nichts zu tun.
Veraltet
Entspricht einem früheren Stand des Kanons, unverändert. Gefahrlos aktualisierbar, ohne Urteil.
Drift
Weicht vom Kanon ab und entspricht keinem seiner Stände. Die einzige Frage: harmonisieren, pinnen, befördern oder einstellen.
Eigenständig
Es gibt keinen Kanon dazu. Das Repository ist die Quelle, und die Kopie ist Kandidat für den Kanon, wenn sie mehrfach vorkommt.
Drei Dimensionen
Drei Fragen an jede Systemlandschaft
Governance
Wer darf abweichen, wie lange, mit welchem Recht?
Eine Ausnahme gilt für genau einen Stand des Artefakts und trägt einen Grund. Ändert sich das Artefakt, ist die Abweichung wieder eine Frage. Jedes Repository deklariert, was es nie enthalten darf. Eine Maschine darf vorschlagen und bauen, aber nicht mergen. In der werkbank: der Pin im Kanon-Register und der Merge-Befehl, den man kopiert, statt ihn zu klicken.
Compliance
Fährt jedes Repository auf der eigenen Paved Road?
Compliance heißt hier, dass ein Repository die eigenen Regeln der Organisation einhält: Templates, Gates, Skripte. Der Zustand jeder Kopie wird aus der Git-Historie bestimmt, nicht aus einer Selbstauskunft. Rot ist ein Befund mit stabilem Schlüssel. Grün ist noch kein Merge-Recht.
Kohärenz
Gehören diese Systeme zusammen oder liegen sie nur nebeneinander?
Ein Register sagt, welche Konzepte wo umgesetzt sind und welche Fassung wie oft benutzt wird. Was niemand benutzt, wird sichtbar. Ob zwei Systeme fachlich zusammengehören, misst die Ordnung noch nicht; das steht unter den Grenzen.
Vier Entscheidungen
Vier Entscheidungen, jede mit Preis
| Entscheidung | Preis | Grenze |
|---|---|---|
| Hash statt Urteil. Der Zustand einer Kopie folgt aus dem Inhaltshash gegen den Kanon.Beleg: base/backbone/portfolio-claude.py:206–213 · werkbank-BIBLE INV-1 | Jede Abweichung ist beweisbar, auch die unwichtige. | Der Hash vergleicht Bytes. Zwei gleichbedeutende Fassungen gelten als verschieden. |
| Container als Tafel, Host als Hand. Der Container zeigt und verwaltet die Warteschlange; er liest die Berichte nur. Messen und Ausführen tut allein der Rechner des Betreibers, auf eigenem Branch.Beleg: werkbank-BIBLE 2026-09-01 „Container als Tafel“ · INV-4 · docker-compose.yml:32–33 | Zwischen Tafel und Hand ist jede Übergabe ein ausdrücklicher Schritt; ohne laufenden Läufer bleibt ein Auftrag liegen. | Was der Lauf nicht eingesammelt hat, kennt die Tafel nicht. |
| Ein grünes Gate ist kein Merge-Recht. Das Gate meldet, ein Mensch merged.Beleg: scripts/laeufer.sh:344–374 · web/src/pages/Auftraege.tsx:236–251 · werkbank-BIBLE INV-5 | Ein Befund wartet auf eine Person. Das ist langsamer als Auto-Merge. | Das Gate prüft nur, wofür es eine Regel hat. |
| Deterministisch vor Modell. Mechanische Befunde werden mechanisch behoben; ein Modell schlägt nur dort vor, wo ein Urteil fehlt, und merged nie.Beleg: werkbank-BIBLE 2026-09-01 „Zwei Spuren“ · INV-4/5 | Weniger Automatik. Das Modell bekommt Vorschläge, keine Entscheidungen. | Urteilsfälle bleiben Menschenarbeit, und bei Drift sind es viele. |
Grenzen
Was die Ordnung nicht entscheidet
- Der Hash vergleicht Bytes. Ob zwei Fassungen dasselbe meinen, sieht er nicht.
- Konzepte werden über Pfadmuster erkannt. Ein Konzept an ungewöhnlichem Ort fehlt im Register.
- Der Hash sieht keine Nähe. Eine um eine Zeile verschobene Kopie ist für ihn Drift, nicht veraltet.
- Ob zwei Systeme fachlich zusammengehören, wird noch nicht gemessen. Kohärenz ist hier Register und Nutzung.
- Das Urteil bleibt beim Menschen. Die Ordnung macht beweisbar, dass eines nötig ist.
Übertragung
So sieht das in Ihrer Organisation aus
| In der werkbank | In Ihrer Organisation |
|---|---|
| Kanon | Die Templates, Gates und Skripte Ihres Plattform-Teams, als Repository mit Historie |
| Drift | Eine Abweichung eines Teams, mit einem ADR, der sie begründet |
| Pin | Eine Ausnahme, gebunden an Artefakt, Stand und Grund. Die Wiedervorlage kommt bei Ihnen dazu; in der werkbank verfällt der Pin mit der nächsten Änderung. |
| Beförderung | Ein InnerSource-Beitrag zurück an die Plattform, mit Entscheidung im Register |
| Befund mit stabilem Schlüssel | Ein Ticket, das seinen Schlüssel behält, bis es erledigt ist |
| Gemessen und entschieden getrennt | Evidenzklassen wie im Review: belegt, bestätigt, Annahme, offen |
2026-10-18 · Die werkbank ist ein privates System für mein eigenes Portfolio. Belege sind Pfad und Zeile im privaten Repository, kein Link.