KI-Projekt ordentlich halten: Ein einfacher Ordnerplan

Halte dein KI-Projekt ordentlich, indem jede Art von Ding einen festen Platz bekommt: Spielregeln, Bilder, Töne, Notizen und eine kurze Anweisungsdatei. Meist reicht eine Aufräumsitzung, solange die KI dabei nur verschiebt und nichts daran ändert, wie sich das Spiel verhält.

Wie sieht ein chaotisches Projekt aus?

Hier der Ordner von Nebelglockenfort, einem erfundenen Verteidigungsspiel, nach drei Wochen Arbeit:

game.js
game_final.js
game_final_v2_REAL.js
index-old.html
index.html
player.png
player (1).png
notizen.txt
todo neu.txt

So ein Durcheinander kostet mehr als nur Ordnung. Deine KI erkennt nicht, welche der drei Spieldateien die echte ist. Vielleicht ändert sie die falsche, du siehst keinen Unterschied und fragst noch mal. Deine Notizen liegen an zwei Stellen, und keine wird gelesen.

Wie sieht ein ordentliches Projekt aus?

nebelglockenfort/
  CLAUDE.md
  index.html
  game/
    player.js
    enemies.js
    levels.js
  assets/
    images/
    sounds/
  docs/
    design.md
    decisions.md

Das ist ein Beispiel für ein kleines Browserspiel, keine Regel. Deine Engine will vielleicht etwas anderes, das sagt dir deine KI dann.

Welche Regeln halten das so?

• Ein fester Platz für jede Art Ding. Ein Bild liegt nie neben einer Regel.
• Keine alten Kopien. „Final“, „v2“ und „alt“ sind Aufgaben für Git, das jede gesicherte Version aufbewahrt. Im Ordner liegt nur die von heute. Nutzt du es noch nicht, fang hier an.
• Eine Datei pro Thema. Dann liest die KI nur, was eine Änderung braucht. Kleine Dateien helfen auch dem Arbeitsgedächtnis deiner KI.
• Einfache, kleingeschriebene Namen. Das erspart später Ärger auf Servern.
• Eine kurze Anweisungsdatei. Claude Code liest zu Beginn jeder Sitzung CLAUDE.md, oder AGENTS.md, wenn es keine CLAUDE.md gibt. Andere Werkzeuge haben ihre eigenen.

Was steht in der Anweisungsdatei?

Weniger, als du denkst. Die Claude-Code-Dokumentation rät, jede CLAUDE.md unter 200 Zeilen zu halten, weil längere Dateien mehr Platz brauchen und schlechter befolgt werden. Sie sagt auch, dass du deine Ordnerstruktur nicht beschreiben musst: Die KI liest dein Projekt selbst, schreib also nur auf, was dort nicht steht.

Für Nebelglockenfort sind das sechs Zeilen: wie man das Spiel startet, wo Entscheidungen stehen, was sich nie ändern darf, und drei Gewohnheiten, die du von deiner KI erwartest. Eine Ordnerliste gehört nicht dazu.

Das sagst du deiner KI

Räum mein Projekt auf, ohne zu ändern, wie sich das Spiel verhält.

1. Sichere zuerst den aktuellen Stand, damit wir zurückkönnen. Zeig mir, dass er gesichert ist.
2. Bevor du etwas verschiebst, zeichne ein Mermaid-Diagramm, was was benutzt: welche Datei welche lädt und wo jedes Bild und jeder Ton gebraucht wird. Prüfe jeden Pfeil an den echten Dateien. Markiere Dateien, die nichts benutzt.
3. Sehen mehrere Dateien wie die echte aus, etwa game_final und game_final_v2, rate nicht. Zeig mir, woran du erkennst, welche das Spiel wirklich lädt.
4. Schlag auf Grundlage dieser Zeichnung einen Ordnerplan und eine Liste aller Verschiebungen vor. Warte auf mein Ja.
5. Verschiebe in kleinen Schritten und passe jede Stelle an, die auf eine verschobene Datei zeigt. Schreib dabei nichts um und verbessere nichts.
6. Lösche nichts, was nicht gesichert ist. Frag mich bei jeder Datei, die du entfernen möchtest.
7. Schreib eine kurze CLAUDE.md oder AGENTS.md: wie man das Spiel startet, wo Entscheidungen stehen, was sich nie ändern darf.

Sag mir danach, was du ausprobiert hast, um zu sehen, dass das Spiel noch startet und gleich läuft, und was du nicht ausprobieren konntest.

Oder spar dir das und schließ den MCP an: Dann findet deine KI das alles von selbst.MCP anschließen

So prüfst du es

• Spiel fünf Minuten. Alles sollte aussehen, klingen und sich verhalten wie vorher.
• Schau oben in deinen Ordner. Du solltest bei jedem Eintrag sagen können, was er ist.
• Starte einen neuen Chat. Frag, wo das Gegnertempo steht. Die Antwort sollte sofort kommen.
• Frag nach einer gelöschten Datei. Die KI sollte sie aus einer gesicherten Version zurückholen können.
• Lies die Anweisungsdatei. Findest du eine Zeile, die du nicht verstehst, frag, wozu sie gut ist, oder streich sie.