Domänenmodellierung
Baue das Domänenmodell des Projekts aktiv auf und schärfe es während des Entwurfs. Dies ist die aktive Disziplin – Begriffe hinterfragen, Randfallszenarien erfinden und das Glossar sowie Entscheidungen genau dann dokumentieren, wenn sie sich kristallisieren. (Das bloße Lesen von CONTEXT.md für Vokabular ist nicht dieser Skill – das ist eine einzeilige Gewohnheit, die jeder Skill ausführen kann. Dieser Skill ist für den Moment, in dem du das Modell änderst, nicht nur konsumierst.)
Dateistruktur
Die meisten Repos haben einen einzigen Kontext:
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-event-sourced-orders.md
│ └── 0002-postgres-for-write-model.md
└── src/
Wenn im Root eine CONTEXT-MAP.md existiert, hat das Repo mehrere Kontexte. Die Map zeigt, wo sich jeder Kontext befindet:
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← systemweite Entscheidungen
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← kontextspezifische Entscheidungen
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/
Erstelle Dateien nur bei Bedarf – nur wenn du etwas zu schreiben hast. Wenn keine CONTEXT.md existiert, erstelle sie, sobald der erste Begriff festgelegt ist. Wenn kein docs/adr/ existiert, erstelle es, sobald die erste ADR benötigt wird.
Während der Sitzung
Glossar herausfordern
Wenn der Benutzer einen Begriff verwendet, der mit der vorhandenen Sprache in CONTEXT.md kollidiert, weise sofort darauf hin. „Dein Glossar definiert ‚Stornierung‘ als X, aber du scheinst Y zu meinen – was ist es nun?“
Vage Sprache schärfen
Wenn der Benutzer vage oder überladene Begriffe verwendet, schlage einen präzisen kanonischen Begriff vor. „Du sagst ‚Konto‘ – meinst du den Kunden oder den Benutzer? Das sind verschiedene Dinge.“
Konkrete Szenarien diskutieren
Wenn über Domänenbeziehungen gesprochen wird, prüfe sie mit konkreten Szenarien auf Herz und Nieren. Erfinde Szenarien, die Randfälle ausloten und den Benutzer zwingen, präzise über die Grenzen zwischen Konzepten zu sprechen.
Mit Code abgleichen
Wenn der Benutzer sagt, wie etwas funktioniert, überprüfe, ob der Code dem zustimmt. Wenn du einen Widerspruch findest, sprich ihn an: „Dein Code storniert ganze Bestellungen, aber du hast gerade gesagt, dass Teilstornierungen möglich sind – was ist richtig?“
CONTEXT.md direkt aktualisieren
Wenn ein Begriff festgelegt ist, aktualisiere CONTEXT.md sofort. Sammle sie nicht auf – halte sie fest, sobald sie passieren. Verwende das Format aus CONTEXT-FORMAT.md.
CONTEXT.md sollte völlig frei von Implementierungsdetails sein. Behandle CONTEXT.md nicht als Spezifikation, Notizblock oder Ablage für Implementierungsentscheidungen. Es ist ein Glossar und nichts weiter.
ADRs zurückhaltend anbieten
Biete nur dann an, eine ADR zu erstellen, wenn alle drei Bedingungen zutreffen:
- Schwer rückgängig zu machen – die Kosten, später seine Meinung zu ändern, sind signifikant
- Ohne Kontext überraschend – ein zukünftiger Leser wird sich fragen „warum haben sie es so gemacht?“
- Das Ergebnis eines echten Abwägens – es gab echte Alternativen und du hast dich aus bestimmten Gründen für eine entschieden
Wenn eine der drei Bedingungen fehlt, überspringe die ADR. Verwende das Format aus ADR-FORMAT.md.