Vorgehen

Der Aufwand verschwindet nicht, er verlagert sich — vom Code in die Spezifikation.

Mit Agenten wird das Implementieren billig. Spezifizieren und Prüfen bleiben Arbeit. Deshalb arbeite ich in festen Schritten, jeder mit einem Artefakt und einem Prüfkriterium. Die letzte Spalte nennt die Datei, mit der dieser Schritt für diese Website gemacht wurde.

#	Schritt	Artefakt	Prüfkriterium	Agent	Mensch	An dieser Seite
1	Kontext abgrenzen	Kontextabgrenzung, Context Map	Verantwortung jedes Kontexts benannt	schlägt vor	entscheidet	context_map.md
2	Fachsprache festlegen	Glossar mit Bindungswirkung	Begriffe im Code = Begriffe im Glossar	wendet an	legt fest	ubiquitous_language.md, CLAUDE.md
3	Modell formalisieren	Grammatik, Metamodell	Parser akzeptiert, Querverweise gültig	entwirft mit	verantwortet	profile.tx
4	Entscheidungen festhalten	Architekturentscheidung (ADR)	Kontext, Entscheidung, Konsequenzen, verworfene Alternativen	entwirft	gibt frei	ADR-013
5	Erzeugen	generierter Code, generierte Seiten	Erzeugnisse werden nie von Hand geändert	Generator oder Agent	reviewt	codegen.py, website.py
6	Verifizieren und validieren	Tests, statische Analyse, Prüfbericht	alles grün; ein Befund bricht ab	entwirft Tests	ergänzt Grenzfälle, gibt frei	website_checks.py, Prüfbericht
7	Dokumentieren und iterieren	arc42, Commit-Historie	Doku entspricht dem Stand; KI-Anteil im Commit ausgewiesen	entwirft	gibt frei	arc42

Die Schritte

1. Kontext abgrenzen. Bevor ein Agent eine Zeile schreibt, steht fest, wofür ein Teilsystem verantwortlich ist und wofür nicht. Ein Agent arbeitet so gut, wie sein Kontext begrenzt ist.

2. Fachsprache festlegen. Die Begriffe des Fachbereichs sind verbindlich: im Gespräch, im Code und in den Anweisungen an den Agenten. Abweichungen sind Fehler, keine Stilfragen.

3. Modell formalisieren. Was sich formal fassen lässt, steht in einer Grammatik. Der Parser prüft, was kein Review zuverlässig prüft: Vollständigkeit und gültige Verweise.

4. Entscheidungen festhalten. Architekturentscheidungen stehen als ADR im Repository, mit den verworfenen Alternativen. Der Agent erbt diese Entscheidungen, er trifft sie nicht.

5. Erzeugen. Ob ein Generator oder ein Agent den Code schreibt: Korrigiert wird in der Spezifikation, nicht im Erzeugnis. Sonst weiß der Code etwas, das die Spezifikation nicht weiß.

6. Verifizieren und validieren. Jede Ausgabe hat ein Prüfkriterium, das eine Maschine auswerten kann. Für diese Website heißt das unter anderem: Kein Name eines Auftraggebers oder Projekts darf erscheinen. Die Sperrliste dafür wird aus dem Profilmodell abgeleitet.

7. Dokumentieren und iterieren. Dokumentation ist Arbeitsgrundlage, keine Nachdokumentation. Commits mit wesentlichem KI-Anteil sind als solche gekennzeichnet.

1999 und heute

Die erste Fassung dieser Domain hatte eine Seite „Arbeitsschritte zur Projektdurchführung“. Die Schritte sind dieselben geblieben, die Werkzeuge nicht. Die frühere Fassung von vorgehen.de steht im Archiv.