Arbeitsbereich und Projekte

Ein Code-Arbeitsbereich besteht aus einem oder mehreren freigegebenen Ordnern. Alles, was die KI liest oder ändert, liegt darin.

Ein Projekt hinzufügen

Vor der ersten Nachricht wählen Sie den Ordner in der Arbeitsbereichszeile in der Mitte des Fensters. Ihr Menü enthält:

Aktion	Wofür
Weiteren Ordner hinzufügen	Ein zweites Projekt, von dem das erste abhängt
Anderen Ordner auswählen	Projektwechsel
Entfernen	Freigabe aufheben, was auch die Zusagen dieses Ordners widerruft

Während einer Unterhaltung liegt oben im Tab Dateien die Zeile Ordner hinzufügen. Das ist der Weg, mitten in der Arbeit einen Ordner dazuzunehmen, wenn sich zeigt, dass die Änderung in ein Nachbarprojekt reicht.

Warum mehrere Ordner und nicht der Elternordner

Wenn zwei Projekte nebeneinander liegen, gib beide frei und nicht ihren gemeinsamen Elternordner. Den Elternordner freizugeben gibt jedes unbeteiligte Projekt darin mit frei.

Die Werkstatt-Oberflächen (Dateibaum, Terminal, Git, Vorschau) arbeiten über die gesamte aktive Ordnermenge. Editor und Vorschau bleiben am primären Ordner verankert, damit ein hinzugefügter Ordner die offene Datei nicht wegwirft.

Eine Unterhaltung merkt sich ihre eigenen Ordner. Eine ältere zu öffnen schaltet den Arbeitsbereich auf deren Ordner zurück. Ist ein Ordner verschoben, umbenannt oder nicht mehr freigegeben, öffnet die Unterhaltung trotzdem lesend und bietet an, den Ordner neu zu wählen.

Ein neues Projekt starten

Liegt im freigegebenen Ordner noch kein Projekt, bietet der Vorschau-Tab an, eine Web-App zu erstellen: er legt ein Next.js-Projekt mit TypeScript und Tailwind an und startet danach den Dev-Server, damit Sie eine laufende Seite sehen und keinen leeren Ordner.

Weil das Werkzeug zum Anlegen ein nicht leeres Ziel ablehnt, wird das Projekt zuerst eine Ebene tiefer erzeugt, dann in den Ordner hochgezogen und nach ihm benannt.

Für alles andere sagen Sie es einfach: „richte hier ein Python-Projekt mit virtueller Umgebung und pytest ein" ist eine normale Aufgabe und läuft wie jeder andere Befehl im Terminal.

Ein vorhandenes Projekt starten

Klicken Sie im Vorschau-Tab auf Starten, und die App ermittelt selbst, wie das Projekt zu starten ist, statt Sie nach einem Befehl zu fragen:

Ein Node-Projekt mit Start-Skript, mit dem Paketmanager, auf den seine Lockfile hinweist.
Deno, Django, PHP und Rails haben jeweils einen eigenen Rückfallweg.
Eine statische Seite mit index.html wird direkt ausgeliefert, ohne Bauschritt.
Ist nichts Erkennbares da, sagt sie das, statt zu raten.

Die Projektanweisungen

Eine dgpt.md (oder CLAUDE.md) im Wurzelverzeichnis eines freigegebenen Ordners wird vor jedem Durchlauf als Projektanweisung gelesen: Konventionen, die wichtigen Befehle, was nicht angefasst werden darf, worum es in dem Projekt überhaupt geht.

Das ist die wirkungsvollste einzelne Datei im Arbeitsbereich. Fast jedes „warum macht sie das immer wieder" hat hier seine Antwort.

/init sieht sich den Arbeitsbereich an und schreibt eine erste Fassung. Bearbeiten Sie sie danach, denn Sie wissen Dinge, die die KI nicht ableiten kann.

Anweisungen in Unterordnern

Eine Anweisungsdatei tiefer im Baum wird über ihren Pfad angekündigt und nicht mit eingefügt. Die KI weiß, dass es sie gibt, und liest sie, wenn sie in diesem Bereich arbeitet. Ein Monorepo mit zwanzig davon verbraucht sein Budget also nicht komplett für Anweisungen.

Eine Datei, die zu groß für das Budget ist, wird mit einer ausdrücklichen Markierung gekürzt statt stillschweigend abgeschnitten, damit die KI immer weiß, dass da noch mehr steht.

Ihre eigenen Regeln, für alle Projekte

~/.deutschlandgpt/anweisungen.md in Ihrem Benutzerverzeichnis enthält Regeln, die in jedem Arbeitsbereich gelten: wie Sie Commits formuliert haben wollen, dass Sie die Tests selbst ausführen, welchen Stil Sie bevorzugen.

Sie stehen vor den Projektdateien, und die KI bekommt die Reihenfolge ausdrücklich mitgeteilt: widerspricht eine Projektanweisung Ihrer persönlichen Regel, gewinnt das Projekt. So ist es richtig, denn das Projekt ist der spezifischere Kontext.

Derselbe Ordner kann persönliche Fähigkeiten und Befehle enthalten, siehe Befehle.

Der Ordner `.deutschlandgpt`

Je freigegebenem Projekt ist dieser Ordner der Treffpunkt zwischen Ihnen und der KI:

CODE

.deutschlandgpt/
├── README.md    erklärt die Struktur
├── skills/      eigene Fähigkeiten
├── commands/    eigene Slash-Befehle
├── plans/       von der KI im Planungsmodus geschrieben
└── reviews/     von der KI bei /code-review geschrieben

Committen Sie ihn, wenn Fähigkeiten und Befehle im Team geteilt werden sollen. Setzen Sie ihn in .gitignore, wenn Pläne und Begutachtungen nur Sie betreffen.