AI kann Code schreiben. AI kann Code erklären. Aber AI kann nicht erklären warum du dich an einem Dienstag im März gegen Caching entschieden hast, weil dein Use Case es nicht brauchte. Dieses Warum steht nirgends. Nicht im Code, nicht im Commit, nicht im Ticket.

Was bei jedem Projekt verloren geht ist nicht die Implementierung. Die kannst du neu schreiben. Was verloren geht ist das Warum. Warum dieses Format und nicht jenes. Was du ausprobiert und verworfen hast. Welche Annahme sich als falsch herausgestellt hat. Ich merke das bei meinem eigenen Build-System. Ich habe vor drei Wochen eine Entscheidung getroffen und kann heute schon nicht mehr rekonstruieren warum.

Ich frage mich ob das überhaupt lösbar ist. Vielleicht geht Kontext immer verloren, egal wie gut du dokumentierst. Vielleicht ist die Frage nicht wie man Entscheidungen festhält, sondern wie man damit umgeht dass sie verschwinden. Und ob es einen Weg gibt der besser funktioniert als eine README die nach zwei Wochen veraltet ist.