Projekt-Dokumentation

Jedes Projekt hat einen docs/-Ordner neben frontend/ und backend/. Er gehört zum Repository, damit ist Dokumentation mit dem Code versioniert und wandert mit Clone, Export und Veröffentlichung mit — die Dokumentation eines Releases ist die, die mit ihm ausgeliefert wurde.

Der Documentation-Tab

Der Tab ist ein Dateimanager über docs/, mit Ordner-Navigation und Breadcrumb. Markdown öffnet gerendert, mit Umschalter auf den Quelltext; andere Dateitypen öffnen mit Syntax-Hervorhebung.

Neue Projekte starten mit einer docs/README.md, die die vorgeschlagene Struktur erklärt. Ältere Projekte zeigen einen Leerzustand mit einem Button, der den Ordner anlegt. Am Telefon hat der Tab einen eigenen Eintrag im Projekt-Menü.

Was der Agent damit macht

Der Agent ist angewiesen, Dokumentation ausschließlich in docs/ zu schreiben, eine bestehende Seite zu aktualisieren statt eine zweite zum selben Thema anzulegen, und nie Zugangsdaten in ein Dokument zu schreiben. Die Dateinamen aus docs/ gehören zu dem, was er zu Beginn eines Gesprächs sieht — er weiß also, welche Dokumente es schon gibt, bevor er ein neues schreibt.

Schreibt der Agent während eines Chat-Turns ein Dokument, aktualisiert sich die Ansicht sofort — dieselbe Live-Aktualisierung wie in den anderen Datei-Browsern.

Was hineingehört

Architekturentscheidungen und die Begründung dahinter, die Fachsprache des Produkts, Runbooks für das, was schiefgeht, und alles, wonach ein neues Teammitglied sonst eine Person fragen müsste. Es ist die eine Stelle, an der dieses Wissen sowohl den Chat-Verlauf als auch die Menschen überlebt, die es aufgeschrieben haben.