Die Qualitaet von KI-generiertem Code haengt fast ausschliesslich davon ab, was du fragst und wie du fragst. Dieser Leitfaden behandelt die Muster, die konsistent bessere Ergebnisse mit Claude Code liefern.
Von der Aufgabenabgrenzung bis zu System-Prompts, von iterativer Verfeinerung bis zu rollenspezifischen Anweisungen. Praktische Techniken fuer deine naechste Coding-Sitzung.
Wenn du einen menschlichen Entwickler bittest, 'eine Login-Seite zu bauen', stellt er klaerende Fragen: Welcher Auth-Provider? Welche Felder? Soll OAuth unterstuetzt werden? Fehlermeldungen? Ladezustaende?
KI-Code-Agenten versuchen, all diese Fragen selbst zu beantworten. Manchmal liegen sie richtig. Oft treffen sie etwas Vernuenftiges, aber nicht das, was du wolltest. Die Luecke zwischen 'vernuenftig' und 'genau richtig' ist das, was Prompt-Engineering schliesst.
Gute Prompts muessen nicht lang sein. Sie muessen spezifisch sein bei den Dingen, die zaehlen, und schweigen bei denen, die es nicht tun. Diese Balance ist das Thema dieses Leitfadens.
Muster, die Ergebnisse unabhaengig von der Aufgabe verbessern.
Statt 'erstelle eine React-Komponente, fuege dann State hinzu, dann Styling', beschreibe das Endergebnis: 'Baue eine einklappbare Sidebar, die Projektnamen anzeigt, Drag-to-Reorder unterstuetzt und unser bestehendes Tailwind-Theme nutzt.' Lass den Agenten den Weg entscheiden.
Avoid
Erstelle eine Komponente. Fuege useState hinzu. Fuege einen Toggle-Button hinzu. Style mit Tailwind.
Better
Baue eine einklappbare Sidebar-Komponente, die Projekte nach Namen auflistet. Sie soll Drag-to-Reorder unterstuetzen und zu unserem Dark-Theme passen (bg-[#111318], border-[#262b38]). Der eingeklappte Zustand soll seitenuebergreifend bestehen bleiben.
Agenten arbeiten am besten, wenn sie die Grenzen kennen. Gib an, welche Dateien bearbeitet (oder vermieden) werden sollen, welche Muster zu befolgen sind und wie 'fertig' aussieht. Unbegrenzte Aufgaben fuehren zu weitreichenden Änderungen, die schwer zu pruefen sind.
Avoid
Refaktoriere das Authentifizierungssystem.
Better
Refaktoriere den Login-Handler in src/api/auth/login.ts, um bcrypt statt sha256 fuer Passwort-Hashing zu verwenden. Aendere nicht die JWT-Logik oder das Session-Cookie-Handling. Aktualisiere die zugehoerigen Tests in tests/auth/.
Claude Code kann deine Projektdateien lesen, aber nicht deine Gedanken. Wenn es eine Konvention gibt, der du folgst, eine Bibliothek, die du bevorzugst, oder ein Muster, das du bereits etabliert hast, sag es. Das spart Nacharbeit.
Avoid
Fuege Formularvalidierung hinzu.
Better
Fuege Formularvalidierung zum Registrierungsformular mit zod hinzu (wir verwenden es bereits im Einstellungsformular in src/forms/settings.ts). Zeige Inline-Fehlermeldungen unter jedem Feld. Folge dem gleichen Fehler-Styling wie beim Login-Formular.
Zusammengesetzte Prompts ('baue die API, schreibe Tests, aktualisiere die Docs und deploye') zwingen den Agenten, zu viele Ziele gleichzeitig zu halten. Teile komplexe Arbeit in sequentielle, fokussierte Aufgaben. Jede baut auf dem vorherigen Ergebnis auf.
Avoid
Baue die Benutzerprofilseite, schreibe API-Endpunkte, fuege Tests hinzu, aktualisiere die README und repariere nebenbei die Navbar.
Better
Baue den GET /api/user/profile-Endpunkt. Gib die Felder id, name, email und plan zurueck. Verwende die bestehende Auth-Middleware.
Wenn das erste Ergebnis nicht stimmt, verfeinere den Prompt, statt von vorne anzufangen. Claude behaelt den gesamten Konversationskontext. Sag, was falsch ist, was geaendert und was beibehalten werden soll. Iteration ist schneller als Neuerfindung.
Avoid
Das ist falsch. Fang nochmal an und baue die Komponente anders.
Better
Das Layout ist gut, aber der Mobile-Breakpoint ist falsch. Unter 768px die Karten vertikal stapeln statt Grid. Alles andere beibehalten.
System-Prompts legen das Grundverhalten eines Agenten fest, bevor du etwas sagst. Sie sind das am wenigsten genutzte Werkzeug beim KI-Coding.
Ein System-Prompt sagt dem Agenten, wer er ist, worauf er sich konzentrieren soll und was er vermeiden soll. Er gilt fuer jede Nachricht in der Sitzung. Denk daran als Stellenbeschreibung des Agenten.
AgentsRoom liefert 14 rollenspezifische System-Prompts: einen fuer jeden Agententyp. Der Frontend-Agent-Prompt sagt, er soll sich auf Komponenten, Barrierefreiheit und responsives Design konzentrieren. Der QA-Agent-Prompt sagt, er soll an Grenzfaelle denken und umfassende Tests schreiben. Du kannst sie anpassen oder eigene schreiben.
Du bist ein Senior-Frontend-Entwickler. Konzentriere dich auf React-Komponenten, CSS/Tailwind-Styling, Barrierefreiheit (WCAG AA) und responsives Design. Verwende die bestehende Komponentenbibliothek des Projekts, bevor du neue erstellst. Bevorzuge Komposition vor Vererbung. Schreibe semantisches HTML. Bearbeite niemals Backend-Dateien.
Der effektivste Prompt wird nicht in einen Chat getippt. Er lebt in deinem Repository.
CLAUDE.md ist eine Markdown-Datei im Stammverzeichnis deines Projekts, die Claude Code automatisch liest. Sie enthaelt Projektstruktur, Konventionen, Stack-Details und Richtlinien, die fuer jede Agentensitzung gelten.
Statt 'wir verwenden Tailwind CSS 4, Prisma ORM und Next.js 16' in jeder Konversation zu wiederholen, schreib es einmal in CLAUDE.md. Jeder Agent erbt diesen Kontext. AgentsRoom enthaelt einen integrierten Editor fuer CLAUDE.md, den du nutzen kannst, ohne die App zu verlassen.
Eine gut geschriebene CLAUDE.md ist mehr wert als dutzende sorgfaeltig ausgearbeitete Einzelprompts. Sie akkumuliert sich: Jede Sitzung profitiert davon.
Hoer auf, dieselben Anweisungen neu zu schreiben. Speichere, was funktioniert, und verwende es wieder.
Wenn du immer wieder die gleiche Art von Anfrage schreibst ('schreibe Unit-Tests fuer diese Datei', 'refaktoriere das zum Repository-Pattern', 'fuege Error-Handling zu allen API-Routen hinzu'), speichere es als wiederverwendbaren Prompt.
AgentsRoom bietet eine Prompt-Bibliothek mit zwei Ebenen: projektspezifische Prompts und globale Prompts (Cloud-synchronisiert) fuer Muster, die du ueberall verwendest.
Gute Kandidaten: Code-Review-Checklisten, Test-Vorlagen, Migrationsskripte, Komponenten-Scaffolding-Anweisungen, Sicherheitsaudit-Schritte. Alles, was du als Standardverfahren in ein Team-Wiki setzen wuerdest.
Schreibe Unit-Tests fuer [Datei]. Verwende vitest. Decke den Happy-Path, Grenzfaelle (leere Eingabe, null, ungueltige Typen) und Error-Handling ab. Mocke externe Abhaengigkeiten. Ziele auf >90% Branch-Coverage.
Pruefe die Änderungen im aktuellen Git-Diff. Suche nach: ungenutzten Imports, fehlendem Error-Handling, Typ-Sicherheitsproblemen, moeglichen Race Conditions und Namensinkonsistenzen. Schlage Korrekturen fuer jedes gefundene Problem vor.
Erstelle einen REST-Endpunkt fuer [Ressource]. Fuege Eingabevalidierung mit zod, passende Fehlerantworten (400, 401, 404, 500), TypeScript-Typen fuer Request/Response und einen JSDoc-Kommentar hinzu. Folge dem bestehenden Muster in src/api/.
Techniken fuer komplexe Aufgaben, die ueber einzelne Prompts hinausgehen.
Teile eine große Aufgabe in geordnete Schritte. Starte den ersten Agenten mit Schritt eins, warte auf Abschluss, starte dann den naechsten Agenten mit Schritt zwei (mit Verweis auf die Ausgabe von Schritt eins). Jeder Schritt ist kleiner und fokussierter. Beispiel: Agent 1 entwirft das Datenbankschema, Agent 2 schreibt die API damit, Agent 3 schreibt Tests gegen die API.
Nachdem ein Agent fertig ist, richte einen anderen Agenten auf dessen Ausgabe. 'Pruefe die Änderungen, die der Frontend-Agent in src/components/ gemacht hat. Suche nach Barrierefreiheitsproblemen und fehlenden Fehlerzustaenden.' Ein frischer Agent mit anderer Rolle findet Dinge, die der urspruengliche Agent uebersehen hat.
Beginne mit einem offenen Prompt, um zu sehen, wie der Agent das Problem angeht. Fuege dann in Folgenachrichten Einschraenkungen hinzu: 'Gute Struktur, aber verwende Server Components statt Client Components.' 'Behalte den Hook, aber entferne den useEffect und verwende stattdessen eine React-Query-Mutation.' Jede Iteration naehert sich der gewuenschten Loesung.
Verweise den Agenten auf bestehenden Code: 'Baue eine Einstellungsseite nach dem gleichen Muster wie src/pages/profile.tsx. Gleiche Layout-Struktur, gleiches Formular-Handling, gleiche Fehleranzeige.' Das ist oft effektiver als das Muster in Worten zu beschreiben.
Muster, die konsistent schlechtere Ergebnisse liefern.
Dem Agenten genau sagen, welche Funktionen zu schreiben, welche Variablen zu benennen und in welcher Reihenfolge zu implementieren sind. Dieses Mikromanagement nimmt dem Agenten die Moeglichkeit, einen besseren Ansatz zu finden. Beschreibe das Ergebnis, nicht das Verfahren.
Einen Agenten bitten, 'die Codebasis zu verbessern' ohne Einschraenkungen. Ohne Grenzen koennte der Agent Dateien refaktorieren, die du nicht beruehren wolltest, APIs aendern, von denen anderer Code abhaengt, oder Tokens fuer niedrigpriorisierte Verbesserungen ausgeben.
Nicht erwaehnen, dass ein Muster, Utility oder Komponente bereits im Projekt existiert. Der Agent wird ein neues erstellen. Ein einfaches 'wir haben bereits einen useAuth-Hook in src/hooks/' spart erhebliche Nacharbeit.
Fuenf Aufgaben in eine Nachricht packen. Der Agent wird alle versuchen, aber die Qualitaet sinkt, wenn er konkurrierende Ziele jongliert. Teile sie in sequentielle, fokussierte Anfragen auf.
AgentsRoom bietet System-Prompts, Prompt-Bibliothek und CLAUDE.md-Bearbeitung integriert. Weniger Zeit fuer Prompts, mehr Zeit zum Bauen.
Companion-App: Agenten auch unterwegs im Blick behalten
Nutzen Sie Claude, Codex, Gemini CLI oder einen anderen AI-Anbieter.
Bugs und Wünsche direkt in dein öffentliches Backlog schicken.