Teil 5. Ersteinrichtung des Projekts

Die Ersteinrichtung ist nötig, damit Agent und Mensch nicht aus dem Chat-Gedächtnis arbeiten, sondern aus den Repository-Dateien. In einem Datenprojekt ist das besonders wichtig: Eine vergessene Vereinbarung zu Grain oder PII kann einen grünen SQL falsch machen.

Minimale Struktur

specs/
  mission.md
  tech-stack.md
  roadmap.md
  models/
  validation/
models/
  staging/
  intermediate/
  marts/
tests/
AGENTS.md
dbt_project.yml
profiles.yml

Man muss nicht sofort eine Plattform aufbauen, die für den produktiven Einsatz bereit ist. Man muss Orte schaffen, an denen Entscheidungen landen werden. Wenn es keinen Ordner specs/validation/ gibt, bleiben Prüffakten fast garantiert im Chat oder in der PR-Beschreibung.

Was in AGENTS.md aufgenommen werden sollte

Mindestregeln:

Vor Änderungen an dbt-Modellen:
1. Lies Mission, Tech-Stack, Roadmap und die nötigen Modellspezifikationen.
2. Gib keine direkten PII-Felder in marts preis.
3. Ändere Grain, SLA oder Vertragsfelder nicht ohne Bestätigung.
4. Führe `dbt build` aus, wenn dbt verfügbar ist.
5. Berichte mit Prüffakten, nicht mit Versprechen.

Diese Regeln ersetzen nicht die Spezifikationen. Sie legen das Verhalten des Agenten fest. Produktversprechen, Vertragsfelder und Abnahmefakten müssen in specs/ leben.

Roadmap

Die Roadmap in einem Datenprojekt führt man besser nach Artefakten als nach „Schichten um der Schichten willen". Zum Beispiel:

1. raw/staging sind reproduzierbar;
2. der Vertrag Customer 360 ist genehmigt;
3. das Mart Customer 360 ist geprüft;
4. die Marts zu Risiko, Krediten und Einwilligungen sind vom Reviewer geprüft;
5. Release-Nachweise für die praktische Prüfung sind bereit.

So sieht man, dass „Modell geschrieben" nicht gleich „Produkt fertig" bedeutet.

Qwen-Anfrage

Lies die aktuelle Projektstruktur.
Prüfe, ob es Plätze für Mission, Tech-Stack, Roadmap, Modellspezifikationen,
Prüffakten, dbt-Modelle und Reviewer-Berichte gibt.
Erstelle eine Liste der Einrichtungslücken. Ändere keine Dateien.

Nach der Liste der Lücken kann man den Agenten bitten, nur die fehlenden Verzeichnisse und leeren Vorlagen anzulegen. Bitten Sie in diesem Kapitel nicht darum, SQL zu schreiben.

Erläuterung für den Leser

Die Ersteinrichtung wirkt langweilig, weil sie wenig Ergebnis liefert, das man auf dem Bildschirm zeigen kann. Aber genau hier entsteht das Gedächtnis des Projekts. Wenn der Agent nicht weiß, wo er Mission, Stack, Roadmap und Spezifikationen suchen soll, wird er das Chat-Gedächtnis nutzen. Dieses Gedächtnis ist bequem bis zum ersten /clear, aber nutzlos für die nächste Person und den nächsten Reviewer.

In einem Datenprojekt ist die Ordnerstruktur wichtiger als in einer kleinen Anwendung. SQL kann man in einer Minute schreiben, aber wenn es vorher keinen Ort für Prüfnotizen gibt, entsteht die Quelle der Wahrheit dort, wo es dem Agenten bequem ist: in einem Kommentar, in der Befehlsausgabe, im Antworttext. Das lässt sich später schwer rekonstruieren. Die Ordner specs/models/, specs/validation/ und specs/reviewer-reports/ sagen dem Agenten: Bedeutung, Prüfung und Review sind eigene Schichten, nicht ein Nachwort zum SQL.

AGENTS.md sollte in diesem Kapitel nicht zur Enzyklopädie werden. Seine Aufgabe ist es, das Verhalten des Agenten vor Änderungen festzulegen: was zu lesen ist, was nicht ohne Bestätigung anzufassen ist, welche Prüfungen auszuführen sind, wie zu berichten ist. Je kürzer diese Regeln sind, desto höher die Chance, dass Agent und Mensch sie tatsächlich nutzen. Die übrigen Details leben in den Spezifikationen.

Eine gute Einrichtung liefert einen einfachen Test: Nach dem Leeren des Kontexts muss ein neuer Agent verstehen, wo die Mission liegt, welcher Stack erlaubt ist, welche Marts gebaut werden und wie die Fertigkeit nachgewiesen wird. Wenn man für die Fortsetzung der Arbeit den Chat nacherzählen muss, ist das Projekt noch nicht eingerichtet. Die Einrichtung ist nicht dann abgeschlossen, wenn die Ordner angelegt sind, sondern wenn sie beginnen, Entscheidungen festzuhalten.

Praxis

Überprüfen Sie das Gerüst des Beispiels und schreiben Sie auf, wo die Agent-Regeln, das Projektgedächtnis, die Modellspezifikationen, die Prüfnotizen und die Reviewer-Berichte liegen. Wenn ein Ort in Ihrem Projekt fehlt, legen Sie ihn vor dem ersten SQL-Modell an.

Minimaler Output

Nach dem Kapitel müssen vorhanden sein:

• AGENTS.md;
• specs/mission.md;
• specs/tech-stack.md;
• specs/roadmap.md;
• Verzeichnisse für Modellspezifikationen, Prüfnotizen und Reviewer-Berichte;
• das Gerüst des dbt-Projekts.

Typischer Fehler

Den Agenten sofort zu bitten: „Baue ein Lakehouse". Das ist zu breit. In der Einrichtungsphase muss man Behälter für Entscheidungen schaffen, nicht die Entscheidungen selbst treffen.

Kontrollfragen

1. Worin unterscheidet sich AGENTS.md von specs/tech-stack.md?
2. Warum führt man die Roadmap besser nach Nachweisen als nur nach Schichten?
3. Welche Entscheidungen darf man nicht nur im Chat belassen?