{"content_id":"vduimuvis9","slug":"claude-code-prompt-six-principles-and-templates","locale":"de","schema_type":"HowTo","category":"tutorial","category_name":"Tutorial","title":"6 Prompt-Prinzipien für bessere Ergebnisse mit Claude Code","summary":"Hier wird erläutert, wie Sie statt einer einfachen Aufforderung zur Codeerstellung den Kontext, den Ausgabevertrag, die Ausnahmebehandlung und die Validierungskriterien strukturiert an Claude Code übermitteln. Zudem werden Prompt-Vorlagen bereitgestellt, die sich direkt auf die Entwicklung neuer Agenten, Funktionserweiterungen und Fehlerbehebungen anwenden lassen.","sponsorship_disclosure":null,"author":{"name":"injoys","url":"https://injoys.com/ko/about"},"key_points":["1. Fassen Sie vor Beginn der Arbeit den Nutzerkontext, das zu lösende Problem, die Erfolgskriterien und die technischen Einschränkungen in einem Dokument zusammen.","2. Legen Sie die Dateistruktur und das Datenformat des Ergebnisses, den zulässigen Umfang sowie die Abschlussbedingungen in einem konkreten Ausgabevertrag fest.","3. Definieren Sie vorhersehbare Ausnahmen wie Ausfälle externer APIs, leere Ergebnisse, doppelte Daten und Authentifizierungsfehler sowie entsprechende Reaktionsrichtlinien.","4. Unterteilen Sie die Arbeit in die Prüfung des Plans, die Umsetzung der Mindestfunktionalität, automatisierte Tests und die Funktionserweiterung, und überprüfen Sie die Ergebnisse nach jedem Schritt.","5. Geben Sie statt unklarer Überarbeitungsaufforderungen konkrete Fehlerfälle und messbare Verbesserungsziele an und validieren Sie das Ergebnis anhand der endgültigen Abnahmebedingungen."],"content_markdown":"Coding-Agenten wie Claude Code sind nicht nur Werkzeuge, die einzelne Codefragmente erzeugen, sondern Arbeitsumgebungen, die Repositorys durchsuchen, mehrere Dateien ändern sowie Tests und Befehle ausführen können. Daher hängt die Qualität des Ergebnisses weniger davon ab, wie plausibel Formulierungen klingen, sondern maßgeblich davon, **wie klar Arbeitsumfang und Validierungsmethode definiert sind**.\n\nEin guter Prompt ist kein langer Erklärungstext, sondern eine ausführbare Arbeitsspezifikation. Er sollte nicht nur vermitteln, was erstellt werden soll, sondern auch, warum es benötigt wird, welche Bedingungen einzuhalten sind, wie mit Fehlern umzugehen ist und welche Kriterien für den Abschluss erfüllt sein müssen.\n\n## Zuerst unterscheiden: Prompt und Ausführungsumgebung\n\nVibe Coding ist eine Form der Zusammenarbeit, bei der Absichten in natürlicher Sprache vermittelt werden und ein AI-Agent die Implementierung übernimmt. Die Tatsache, dass eine Anfrage in natürlicher Sprache gestellt wurde, garantiert jedoch weder die Korrektheit des Codes noch die Stabilität im Betrieb.\n\nBei Arbeiten mit Claude Code wirken die folgenden Elemente zusammen.\n\n| Element | Rolle | Im Prompt zu klärende Inhalte |\n|---|---|---|\n| Benutzeranfrage | Vermittelt Ziel und Änderungsumfang | Zweck, Prioritäten, Verbote |\n| Repository-Kontext | Stellt bestehende Struktur und Regeln bereit | Framework, Ausführungsbefehle, relevante Dateien |\n| `CLAUDE.md` | Stellt wiederholt anzuwendende Projektanweisungen bereit | Coding-Regeln, Testmethoden, Verzeichniskonventionen |\n| Werkzeugberechtigungen | Kontrollieren den zulässigen Umfang von Dateiänderungen und Befehlsausführungen | Zulässige Befehle und Arbeiten, die eine vorherige Bestätigung erfordern |\n| Externe Verbindungen | Ermöglichen den Zugriff auf APIs, Datenbanken, MCP-Server usw. | Authentifizierungsmethode, Vertrauensgrenzen, Fehlerrichtlinien |\n| Validierungsverfahren | Stellen fest, ob das Ergebnis die Anforderungen erfüllt | Tests, statische Analyse, manuell zu prüfende Punkte |\n\nAuch ein gut formulierter Prompt löst nicht alle Probleme. Claude Code kann beispielsweise Code für eine geplante Ausführung erstellen. Soll die Aufgabe jedoch auch bei ausgeschaltetem Computer ausgeführt werden, ist ein separater Server, ein CI-Dienst oder ein Scheduler des Betriebssystems erforderlich. Auch der E-Mail-Versand kann ohne Authentifizierungsdaten und Versandberechtigung eines realen Anbieters nicht fertiggestellt werden.\n\n## Prinzip 1. Zuerst Hintergrund, Zweck und Einschränkungen erläutern\n\nWenn lediglich die Bezeichnung des Ergebnisses genannt wird, etwa `Erstelle mir einen Agenten zur Nachrichtensammlung`, muss der Agent Benutzer, Datenquellen, Ausführungsumgebung und Erfolgskriterien erraten. Selbst bei demselben Nachrichtensammler unterscheiden sich die benötigten Quellen und Klassifizierungskriterien für Verantwortliche in der Geschäftsentwicklung, Investoren oder Redakteure einer Universitätszeitung.\n\n### Unzureichende Anfrage\n\n```text\nErstelle mir einen Agenten zum Sammeln von AI-Nachrichten.\n```\n\n### Verbesserte Anfrage\n\n```text\nIch bin für die Geschäftsentwicklung eines IT-Start-ups verantwortlich.\nIch möchte jeden Tag vor Arbeitsbeginn schnell Nachrichten aus den Bereichen\nAI, Cloud und Fintech prüfen, die sich auf Geschäftspartnerschaften oder die Produktstrategie auswirken.\n\nZiele:\n- Für die angegebenen Schlüsselwörter Kandidaten aktueller Artikel sammeln.\n- Artikel mit derselben URL und Duplikate mit ähnlichen Titeln entfernen.\n- Die Auswirkungen danach als hoch, mittel oder niedrig klassifizieren,\n  ob innerhalb von 3 Monaten eine Produkt- oder Partnerschaftsentscheidung erforderlich ist.\n- Die Ergebnisse als koreanisches E-Mail-Briefing erstellen.\n\nEinschränkungen:\n- Die Python-Version und Paketverwaltungsmethode des aktuellen Repositorys beibehalten.\n- Vor dem Hinzufügen einer neuen Bibliothek deren Notwendigkeit und Alternativen erläutern.\n- API-Schlüssel und E-Mail-Passwörter weder im Code noch in Logs speichern.\n- Vor dem tatsächlichen E-Mail-Versand nur eine Vorschaudatei erstellen.\n\nUntersuche zuerst die Repository-Struktur und die Ausführungsmethode und schlage anschließend einen Implementierungsplan vor.\nUnbekannte Informationen zur Umgebung nicht erraten, sondern als Fragenliste zusammenstellen.\n```\n\nGute Hintergrundinformationen umfassen die folgenden vier Punkte.\n\n1. **Benutzer und Nutzungssituation:** Wer verwendet das Ergebnis wann und für welche Entscheidung?\n2. **Ziel:** Welches Problem soll gelöst werden, statt lediglich Code zu schreiben?\n3. **Einschränkungen:** Welche Technologien, Sicherheitsregeln sowie Kosten- oder Zeitlimits müssen eingehalten werden?\n4. **Nicht-Ziele:** Welche Funktionen sind ausdrücklich von dieser Änderung ausgeschlossen?\n\nDurch die Angabe von Nicht-Zielen lässt sich verhindern, dass der Umfang unbegrenzt wächst. Wird beispielsweise festgelegt, dass `in dieser Phase die geplante Ausführung und der tatsächliche E-Mail-Versand ausgeschlossen sind`, können zunächst die Sammel- und Klassifizierungslogik zuverlässig validiert werden.\n\n## Prinzip 2. Das gewünschte Ausgabeformat als Ausgabevertrag definieren\n\n`Sende es ansprechend per E-Mail` wird von jedem anders interpretiert. Für das Ausgabeformat sollten nicht nur Beispiele gezeigt, sondern auch Pflichtfelder, zulässige Werte, der Umgang mit fehlenden Angaben und die Sortierreihenfolge definiert werden.\n\n```text\nE-Mail-Betreff:\n[Nachrichten-Briefing] {YYYY-MM-DD} Die wichtigsten Nachrichten des Tages\n\nArtikelformat im Nachrichtentext:\n1. {Titel}\nZusammenfassung: {1–2 Sätze auf Koreanisch}\nAuswirkung: {hoch|mittel|niedrig}\nBegründung der Bewertung: {1 Satz}\nQuelle: {Name des Mediums}\nLink: {URL des Originals}\n\nSortierregeln:\n1. Absteigend nach Auswirkung\n2. Bei gleicher Auswirkung nach dem neuesten Veröffentlichungszeitpunkt\n\nStatistik am Ende:\n- Gesamtzahl der Artikel\n- Anzahl der Artikel je Auswirkungsstufe\n- Schlüsselwörter ohne Suchergebnisse\n\nEinschränkungen:\n- In der Zusammenfassung keine Zahlen oder Behauptungen erfinden, die nicht im Original enthalten sind.\n- Wenn das Datum nicht überprüft werden kann, kein Datum schätzen, sondern als 'nicht überprüfbar' kennzeichnen.\n- Einträge ohne Link aus dem endgültigen Briefing ausschließen.\n```\n\nWenn Ergebnisse zwischen Programmen übertragen werden müssen, empfiehlt es sich, neben einem für Menschen lesbaren Beispiel auch ein JSON-Schema oder eine Typdefinition anzufordern.\n\n```json\n{\n  \"title\": \"string\",\n  \"summary\": \"string\",\n  \"impact\": \"high | medium | low\",\n  \"reason\": \"string\",\n  \"source\": \"string\",\n  \"url\": \"absolute URL\",\n  \"published_at\": \"ISO 8601 string | null\"\n}\n```\n\nEin Ausgabevertrag umfasst nicht nur die Form, sondern auch die Bedeutung. Wenn es keine Bewertungskriterien dafür gibt, was `impact: high` bedeutet, kann die JSON-Syntax korrekt sein, während die Klassifizierungsergebnisse inkonsistent bleiben.\n\n## Prinzip 3. Ausnahmesituationen und Wiederherstellungsrichtlinien festlegen\n\nDie Qualität von Produktionscode zeigt sich stärker im Fehlerpfad als im Normalfall. Im Prompt sollten erwartbare Fehler, die Möglichkeit von Wiederholungsversuchen, die Bedingungen für eine Benachrichtigung des Benutzers und Informationen, die nicht protokolliert werden dürfen, gemeinsam angegeben werden.\n\n| Ausnahmesituation | Beispiel für eine empfohlene Richtlinie |\n|---|---|\n| Keine Suchergebnisse | Das betreffende Schlüsselwort überspringen und in der abschließenden Statistik erfassen |\n| Vorübergehender Netzwerkfehler | Nur eine begrenzte Anzahl von Wiederholungsversuchen in festgelegten Abständen |\n| Authentifizierungsfehler | Nicht erneut versuchen, sondern sofort abbrechen und auf die Überprüfung der Konfiguration hinweisen |\n| API-Nutzungslimit | Warteanweisungen der Antwort beachten und unbegrenzte Wiederholungsversuche verbieten |\n| Doppelte Artikel | Anhand normalisierter URLs und der Titelähnlichkeit entfernen |\n| Fehlerhaft formatierte Daten | Original beibehalten und nur den betreffenden Eintrag isolieren |\n| Fehler beim E-Mail-Versand | Wenn auch Wiederholungsversuche fehlschlagen, alternative Benachrichtigung senden oder Fehlerstatus protokollieren |\n| Teilerfolg | Erfolgreiche Ergebnisse und fehlgeschlagene Einträge getrennt melden |\n\nRichtlinien können wie folgt konkret angefordert werden.\n\n```text\nBehandle Netzwerk-Timeouts als Fehler, bei denen ein erneuter Versuch möglich ist.\nWarte zwischen den Versuchen. Wenn die maximale Anzahl überschritten wird,\nmarkiere nur die betreffende Quelle als fehlgeschlagen.\nBrich bei Authentifizierungsfehlern und fehlerhaften Anfragen sofort ab,\nda wiederholte Versuche diese Probleme nicht lösen.\n\nSpeichere in allen Fehler-Logs Zeitpunkt, Arbeitsschritt, Quelle und Fehlertyp,\naber keine API-Schlüssel, vollständigen E-Mail-Adressen, Authentifizierungsheader\noder vollständigen Artikeltexte.\nUnterscheide über den Prozess-Exit-Status zwischen vollständigem Erfolg,\nTeilerfolg und vollständigem Fehlschlag.\n```\n\nWerte wie `drei Wiederholungsversuche` oder `5 Sekunden Wartezeit` sind keine universell richtigen Antworten. Sie müssen im Projekt anhand der offiziellen Beschränkungen externer Dienste, der Dringlichkeit der Aufgabe und des Risikos doppelter Ausführungen festgelegt werden. Aufgaben mit Nebenwirkungen, etwa Zahlungen oder der Versand von Nachrichten, können bei automatischen Wiederholungsversuchen ohne garantierte Idempotenz doppelt verarbeitet werden.\n\n## Prinzip 4. Schrittweise in der Reihenfolge Planung, minimale Implementierung und Validierung entwickeln\n\nWenn mehrere externe Dienste und die automatische Ausführung gleichzeitig verbunden werden, lassen sich Fehlerursachen nur schwer voneinander trennen. Wird die Implementierung in kleine Validierungseinheiten aufgeteilt, können Ein- und Ausgabe jeder Phase überprüft werden.\n\n### Empfohlene Reihenfolge\n\n1. Repository-Struktur, relevante Dateien und Ausführungsbefehle untersuchen.\n2. Vor Codeänderungen einen Plan und die betroffenen Dateien vorlegen lassen.\n3. Die Sammelfunktion mit einem Schlüsselwort und festgelegten Beispieldaten implementieren.\n4. Deduplizierung und Klassifizierung der Auswirkungen jeweils separat testen.\n5. E-Mails nicht tatsächlich versenden, sondern anhand einer lokalen Vorschau validieren.\n6. Nach Bestehen der Tests die Anbindung eines realen Anbieters und die geplante Ausführung hinzufügen.\n\nDie erste Anfrage kann wie folgt eingeschränkt werden.\n\n```text\nFühre jetzt nur Phase 1 aus.\nUntersuche das Repository und berichte über Folgendes:\n- Einstiegspunkt der aktuellen Anwendung\n- Relevante Module und Testdateien\n- Verwendete Paketverwaltungs- und Testbefehle\n- Dateien, die voraussichtlich geändert werden müssen\n- Fragen, die vor der Implementierung geklärt werden müssen\n\nÄndere noch keine Dateien.\n```\n\nNach Prüfung des Plans wird die Implementierung auf einen engen Änderungsumfang begrenzt.\n\n```text\nImplementiere aus dem genehmigten Plan nur die Nachrichtensammlung und Deduplizierung.\nFüge Klassifizierung, E-Mail-Versand und geplante Ausführung nicht hinzu.\nErmögliche die Ausführung mit festgelegten Testdaten und fasse am Ende\ndie geänderten Dateien und Ergebnisse der ausgeführten Tests zusammen.\n```\n\nWenn in der Claude Code-Umgebung ein reiner Planungsmodus verfügbar ist, kann er in der Erkundungs- und Entwurfsphase verwendet werden. Ein plausibel wirkender Plan bedeutet jedoch nicht, dass die Implementierung korrekt ist. Daher müssen tatsächliche Tests und eine Codeprüfung folgen.\n\n## Prinzip 5. Feedback anhand von Fehlerbeispielen und Zahlen geben\n\nMit Aussagen wie `Das Ergebnis ist nicht besonders gut`, `Die Performance ist langsam` oder `Die Klassifizierung ist falsch` lässt sich die Richtung der Korrektur nur schwer bestimmen. Es müssen der aktuelle Zustand, der erwartete Zustand, die Eingabe zur Reproduktion und der zulässige Änderungsumfang angegeben werden.\n\n### Anfrage zur Längenänderung\n\n```text\nDer aktuelle E-Mail-Text wird mit etwa 3.000 Zeichen erstellt.\nIch möchte ihn auf höchstens 500 Zeichen kürzen, damit er auf Mobilgeräten schnell gelesen werden kann.\nBegrenze jede Artikelzusammenfassung auf 1–2 Sätze und behalte die Bewertungsbegründung bei.\nVerlinke die URL des Originals im Titel und entferne die separate Linkzeile.\nBehalte die Statistik am Ende bei.\n```\n\n### Anfrage zur Änderung der Klassifizierungskriterien\n\n```text\nVon 10 Testdatensätzen wurden 8 als 'hoch' klassifiziert.\nKlassifiziere langfristige Technologieprognosen oder allgemeine Produktvorstellungen als 'niedrig'.\nKlassifiziere einen Artikel nur dann als 'hoch', wenn konkrete Belege dafür vorliegen,\ndass innerhalb von 3 Monaten Entscheidungen zu Preisen, Produkt-Roadmap,\nregulatorischen Maßnahmen oder Partnerschaften geändert werden müssen.\n\nIn den beigefügten Beispielen sind A und B als hoch und C als niedrig korrekt.\nÄndere die Klassifizierungsregeln und füge diese Beispiele als Regressionstests hinzu.\n```\n\n### Anfrage zur Performanceverbesserung\n\n```text\nDie durchschnittliche Ausführungszeit derselben Beispieleingabe beträgt derzeit etwa 45 Sekunden.\nDas Ziel liegt in derselben Umgebung bei höchstens 30 Sekunden.\nMiss zuerst die Zeit je Phase und zeige den Engpass.\nEntferne weder die Ergebnisgenauigkeit noch die Fehlerbehandlung.\nVergleiche Wirkung und Risiken der Verbesserungsalternativen und wende zuerst die kleinste Änderung an.\n```\n\nPerformancewerte können nur verglichen werden, wenn Messumgebung und Eingabedaten identisch sind. Die Verbesserung sollte nicht anhand eines einzigen Ausführungsergebnisses beurteilt werden. Auch Messmethode, Stichprobe und Cache-Zustand müssen festgelegt werden.\n\n## Prinzip 6. Prompt-Vorlagen nach Aufgabentyp verwenden\n\n### Vorlage zum Erstellen eines neuen Agenten\n\n```text\n[Rolle und Situation]\nIch bin {Beruf/Rolle} und möchte {Problemsituation} lösen.\nDieses Ergebnis wird von {Benutzer oder nachgelagertes System} verwendet.\n\n[Ziel]\n{Zu erreichendes Ergebnis und Erfolgskriterien}\n\n[Ausführungsauslöser]\n{Manuelle Ausführung, Ereignis, geplanter Zeitpunkt usw.}\n\n[Eingabe]\n- Datenquelle: {Datei/API/Datenbank}\n- Pflichtfelder: {Feldliste}\n- Authentifizierungsmethode: {Umgebungsvariable oder Methode zur Geheimnisverwaltung}\n\n[Verarbeitungslogik]\n1. {Schritt 1}\n2. {Schritt 2}\n3. {Schritt 3}\n\n[Ausgabevertrag]\n{Dateiformat, Schema, Vorlage sowie Sortier- und Auslassungsregeln}\n\n[Ausnahmebehandlung]\n{Leere Ergebnisse, Timeout, Authentifizierungsfehler, Richtlinie bei Teilausfällen}\n\n[Einschränkungen und Nicht-Ziele]\n- Beizubehaltende Technologien: {Elemente}\n- Verbote: {Elemente}\n- Von dieser Aufgabe ausgeschlossene Funktionen: {Elemente}\n\n[Validierung]\n- Zu bestehende Tests: {Elemente}\n- Inhalte des Abschlussberichts: geänderte Dateien, Ausführungsbefehle, Testergebnisse, verbleibende Risiken\n\nUntersuche zuerst das Repository und lege einen Implementierungsplan vor.\nErrate unbekannte Informationen nicht, sondern stelle Fragen.\n```\n\n### Vorlage zum Hinzufügen einer bestehenden Funktion\n\n```text\nFüge dem bestehenden {Name des Agenten oder Moduls} die {neue Funktion} hinzu.\nDie neue Funktion muss nach {bestehender Schritt A} und vor {bestehender Schritt B} ausgeführt werden.\n\nDetaillierte Logik:\n- {Bedingungen und Verarbeitungsregeln}\n- {Ein- und Ausgabeformat}\n- {Verhalten bei einem Fehler}\n\nBeizubehaltende Bedingungen:\n- Bestehende öffentliche Schnittstellen und Konfigurationsformate nicht ändern.\n- Alle bestehenden Tests beibehalten.\n- Keine nicht relevanten Dateien ändern.\n\nErläutere zuerst den Wirkungsbereich und die Regressionsrisiken.\nFüge anschließend Tests hinzu, die das bestehende Verhalten bewahren, und implementiere die Funktion.\n```\n\n### Vorlage zur Fehlerbehebung\n\n```text\nReproduziere den folgenden Fehler und behebe seine Grundursache.\n\nVollständige Fehlermeldung:\n{Fehlermeldung und Stacktrace nach Entfernung geheimer und personenbezogener Informationen}\n\nAuftretensbedingungen:\n- Ausführungsbefehl: {Befehl}\n- Eingabe: {Minimale Eingabe zur Reproduktion}\n- Umgebung: {Betriebssystem, Laufzeit, relevante Versionen}\n- Zeitpunkt des Auftretens: {In welcher Phase}\n\nErwartetes Verhalten:\n{Ergebnis, das bei normalem Verhalten erscheinen sollte}\n\nTatsächliches Verhalten:\n{Aktuell beobachtetes Ergebnis}\n\nAnfrage:\n1. Reproduziere zuerst den Fehler.\n2. Erkläre die Ursache anhand von Belegen.\n3. Behebe ihn mit dem kleinstmöglichen Änderungsumfang.\n4. Füge einen Regressionstest hinzu, der denselben Fehler verhindert.\n5. Berichte über die ausgeführten Tests und verbleibenden Risiken.\n```\n\nBeim Einfügen von Fehlermeldungen müssen sensible Informationen wie API-Schlüssel, Sitzungstoken, Kundendaten und interne Adressen entfernt werden.\n\n## Vollständiges Beispiel: Anfrage für einen Nachrichten-Briefing-Agenten\n\nDas folgende Beispiel kombiniert die sechs Prinzipien in einer einzigen Anfrage.\n\n```text\nIch bin für die Geschäftsentwicklung eines SaaS-Start-ups verantwortlich.\nIch möchte täglich nur Nachrichten über Veränderungen in den Märkten für AI,\nCloud und Fintech prüfen, die innerhalb von 3 Monaten Produkt- oder\nPartnerschaftsentscheidungen verändern können.\n\nUntersuche das aktuelle Repository und entwirf ein Werkzeug für Nachrichten-Briefings.\nImplementiere in der ersten Phase nur die Funktion, die Beispiel-JSON einliest,\nDuplikate entfernt, die Auswirkungen klassifiziert und anschließend eine HTML-Vorschaudatei erstellt.\nWebsuche, tatsächlicher E-Mail-Versand und geplante Ausführung sind von dieser Phase ausgeschlossen.\n\nEingabefelder:\n- title, url, source, published_at, body\n\nVerarbeitungsregeln:\n- Identische normalisierte URLs gelten als Duplikate.\n- Auch bei unterschiedlichen URLs werden Artikel mit ähnlichen Titeln als Duplikatkandidaten markiert.\n- Nur Artikel, die innerhalb von 3 Monaten konkrete Änderungen bei Preisen,\n  regulatorischen Maßnahmen, der Produkt-Roadmap oder Partnerschaftsentscheidungen\n  erforderlich machen, werden mit der Auswirkung 'hoch' klassifiziert.\n- Bei unzureichenden Belegen keine hohe Stufe vermuten.\n\nAusgabe:\n- Titel, Zusammenfassung in 1–2 Sätzen, Auswirkung, Bewertungsbegründung, Quelle und URL anzeigen.\n- Absteigend nach Auswirkung sortieren.\n- Gesamtzahl, Anzahl entfernter Duplikate und Anzahl je Stufe am Ende anzeigen.\n\nAusnahmebehandlung:\n- Einträge ohne Pflichtfelder nicht ausschließen, sondern in einer separaten Fehlerliste erfassen.\n- Fehlerhafte Datumsangaben nicht schätzen, sondern als null beibehalten.\n- Weder vollständige Artikeltexte noch Authentifizierungsdaten in Logs speichern.\n\nValidierung:\n- Normale Eingabe, leere Eingabe, doppelte URL, fehlerhaftes Datum und fehlende Pflichtfelder testen.\n- Falls bestehende Tests vorhanden sind, müssen alle bestanden werden.\n\nArbeitsreihenfolge:\n1. Repository-Struktur und relevante Dateien untersuchen.\n2. Zu ändernde Dateien und Testplan vorlegen.\n3. Den Code nicht ändern, bevor ich den Plan geprüft habe.\n4. Nach der Genehmigung die minimale Funktion implementieren und über die Testergebnisse berichten.\n```\n\nDiese Anfrage verlangt nicht, alle erforderlichen Funktionen gleichzeitig in der Produktionsumgebung bereitzustellen. Der Umfang ist begrenzt, und Ausgabebedeutung, Fehlerbehandlung sowie Testfälle sind gemeinsam definiert, sodass sich das Ergebnis leicht beurteilen lässt.\n\n## Qualitätskriterien, die bei ausschließlicher Konzentration auf Prompts leicht übersehen werden\n\nViele Anleitungen zum Vibe Coding konzentrieren sich darauf, detailliertere Anweisungen zu schreiben. Weitere Faktoren, die jedoch die tatsächliche Qualität bestimmen, sind **Validierbarkeit, Änderungskontrolle, Beobachtbarkeit und Sicherheitsgrenzen**.\n\n### 1. Abnahmekriterien in Tests umwandeln\n\nStatt `Sorge dafür, dass es gut funktioniert` werden Eingaben mit den erwarteten Ausgaben als Paare bereitgestellt. Wichtige Klassifizierungsbeispiele werden als Regressionstests festgehalten, um zu prüfen, ob die Ergebnisse auch bei späteren Änderungen erhalten bleiben.\n\n### 2. Die Selbsteinschätzung des Agenten nicht als endgültigen Beleg verwenden\n\nDass ein Agent erklärt, er sei `fertig`, ist nicht dasselbe wie bestandene Tests. Er sollte über ausgeführte Befehle, Testergebnisse, geänderte Dateien und ungelöste Risiken berichten, und ein Mensch muss den diff prüfen.\n\n### 3. Berechtigungen und geheime Informationen minimieren\n\nNicht benötigte Verzeichnisse, Produktionsdatenbanken und Bereitstellungszugangsdaten werden nicht gemeinsam zur Verfügung gestellt. API-Schlüssel werden weder direkt in Prompts noch in Repositorys eingetragen. Stattdessen werden Umgebungsvariablen oder genehmigte Systeme zur Geheimnisverwaltung verwendet. MCP-Servern oder Skripten unbekannter Herkunft wird kein Zugriff auf sensible Repositorys gewährt.\n\n### 4. Beobachtbaren Code verlangen\n\nBei automatisierten Aufgaben werden Informationen hinterlassen, die zur Ermittlung von Fehlerursachen erforderlich sind, etwa Status je Phase, strukturierte Fehler, Ausführungszeiten und die Anzahl verarbeiteter Datensätze. Authentifizierungsdaten und personenbezogene Informationen werden dagegen aus Logs entfernt.\n\n### 5. Änderungen reversibel gestalten\n\nNicht relevante Refactorings und Funktionserweiterungen werden nicht in derselben Änderung vermischt. Werden diffs in kleinen Einheiten geprüft und in der Versionsverwaltung erfasst, lassen sich fehlerhafte Änderungen leichter isolieren und rückgängig machen.\n\n## Tipps für den Betrieb von Claude Code-Projekten\n\n- Wiederkehrende Projektregeln kurz und konkret in `CLAUDE.md` festhalten.\n- Build-, Test- und Lint-Befehle in tatsächlich ausführbarer Form angeben.\n- Keine geheimen Informationen, einmaligen Fehler-Logs oder langen Referenzdokumente in `CLAUDE.md` aufnehmen.\n- Vor umfangreichen Änderungen zuerst relevante Dateien und Abhängigkeiten untersuchen lassen.\n- Beim Hinzufügen neuer Pakete Notwendigkeit, Lizenz und Wartungsrisiken prüfen.\n- Gefährliche Befehle zum Löschen, Bereitstellen oder Ändern von Daten nicht automatisch genehmigen.\n- Vor der Anbindung externer APIs oder von MCP prüfen, wohin Daten übertragen werden.\n- Nach Abschluss geänderte Dateien, Ausführungsbefehle, Testergebnisse und verbleibende Einschränkungen zusammenfassen lassen.\n\n## Checkliste vor der Einreichung\n\n- [ ] Sind Benutzer und Nutzungssituation beschrieben?\n- [ ] Sind Ziele und Nicht-Ziele voneinander getrennt?\n- [ ] Sind bestehende Technologien und Bereiche, die nicht geändert werden dürfen, angegeben?\n- [ ] Sind Eingabedaten und Ausgabeformat definiert?\n- [ ] Ist die Bedeutung von Klassifizierungs- und Statuswerten erläutert?\n- [ ] Gibt es Richtlinien für leere Ergebnisse, Authentifizierungsfehler, Timeouts und Teilausfälle?\n- [ ] Sind Planung und Implementierung phasenweise voneinander getrennt?\n- [ ] Gibt es Tests für Normal-, Grenz- und Fehlerfälle?\n- [ ] Sind geheime und personenbezogene Informationen aus Prompts und Logs ausgeschlossen?\n- [ ] Wurden ein von Menschen zu prüfender diff und Ausführungsbelege angefordert?\n\nDer Kern eines guten Claude Code-Prompts besteht nicht darin, lange Anweisungen zu schreiben. Es geht darum, die Punkte zu reduzieren, die der Agent erraten muss, und das Ergebnis so zu gestalten, dass auch Dritte reproduzierbar feststellen können, ob es korrekt ist.","content_html":"\u003cp\u003eCoding-Agenten wie Claude Code sind nicht nur Werkzeuge, die einzelne Codefragmente erzeugen, sondern Arbeitsumgebungen, die Repositorys durchsuchen, mehrere Dateien ändern sowie Tests und Befehle ausführen können. Daher hängt die Qualität des Ergebnisses weniger davon ab, wie plausibel Formulierungen klingen, sondern maßgeblich davon, \u003cstrong\u003ewie klar Arbeitsumfang und Validierungsmethode definiert sind\u003c/strong\u003e.\u003c/p\u003e\n\u003cp\u003eEin guter Prompt ist kein langer Erklärungstext, sondern eine ausführbare Arbeitsspezifikation. Er sollte nicht nur vermitteln, was erstellt werden soll, sondern auch, warum es benötigt wird, welche Bedingungen einzuhalten sind, wie mit Fehlern umzugehen ist und welche Kriterien für den Abschluss erfüllt sein müssen.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#zuerst-unterscheiden-prompt-und-ausf%C3%BChrungsumgebung\" class=\"anchor\" id=\"zuerst-unterscheiden-prompt-und-ausführungsumgebung\"\u003e\u003c/a\u003eZuerst unterscheiden: Prompt und Ausführungsumgebung\u003c/h2\u003e\n\u003cp\u003eVibe Coding ist eine Form der Zusammenarbeit, bei der Absichten in natürlicher Sprache vermittelt werden und ein AI-Agent die Implementierung übernimmt. Die Tatsache, dass eine Anfrage in natürlicher Sprache gestellt wurde, garantiert jedoch weder die Korrektheit des Codes noch die Stabilität im Betrieb.\u003c/p\u003e\n\u003cp\u003eBei Arbeiten mit Claude Code wirken die folgenden Elemente zusammen.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eElement\u003c/th\u003e\n\u003cth\u003eRolle\u003c/th\u003e\n\u003cth\u003eIm Prompt zu klärende Inhalte\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Element\"\u003eBenutzeranfrage\u003c/td\u003e\n\u003ctd data-label=\"Rolle\"\u003eVermittelt Ziel und Änderungsumfang\u003c/td\u003e\n\u003ctd data-label=\"Im Prompt zu klärende Inhalte\"\u003eZweck, Prioritäten, Verbote\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Element\"\u003eRepository-Kontext\u003c/td\u003e\n\u003ctd data-label=\"Rolle\"\u003eStellt bestehende Struktur und Regeln bereit\u003c/td\u003e\n\u003ctd data-label=\"Im Prompt zu klärende Inhalte\"\u003eFramework, Ausführungsbefehle, relevante Dateien\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Element\"\u003e\u003ccode\u003eCLAUDE.md\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"Rolle\"\u003eStellt wiederholt anzuwendende Projektanweisungen bereit\u003c/td\u003e\n\u003ctd data-label=\"Im Prompt zu klärende Inhalte\"\u003eCoding-Regeln, Testmethoden, Verzeichniskonventionen\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Element\"\u003eWerkzeugberechtigungen\u003c/td\u003e\n\u003ctd data-label=\"Rolle\"\u003eKontrollieren den zulässigen Umfang von Dateiänderungen und Befehlsausführungen\u003c/td\u003e\n\u003ctd data-label=\"Im Prompt zu klärende Inhalte\"\u003eZulässige Befehle und Arbeiten, die eine vorherige Bestätigung erfordern\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Element\"\u003eExterne Verbindungen\u003c/td\u003e\n\u003ctd data-label=\"Rolle\"\u003eErmöglichen den Zugriff auf APIs, Datenbanken, MCP-Server usw.\u003c/td\u003e\n\u003ctd data-label=\"Im Prompt zu klärende Inhalte\"\u003eAuthentifizierungsmethode, Vertrauensgrenzen, Fehlerrichtlinien\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Element\"\u003eValidierungsverfahren\u003c/td\u003e\n\u003ctd data-label=\"Rolle\"\u003eStellen fest, ob das Ergebnis die Anforderungen erfüllt\u003c/td\u003e\n\u003ctd data-label=\"Im Prompt zu klärende Inhalte\"\u003eTests, statische Analyse, manuell zu prüfende Punkte\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eAuch ein gut formulierter Prompt löst nicht alle Probleme. Claude Code kann beispielsweise Code für eine geplante Ausführung erstellen. Soll die Aufgabe jedoch auch bei ausgeschaltetem Computer ausgeführt werden, ist ein separater Server, ein CI-Dienst oder ein Scheduler des Betriebssystems erforderlich. Auch der E-Mail-Versand kann ohne Authentifizierungsdaten und Versandberechtigung eines realen Anbieters nicht fertiggestellt werden.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#prinzip-1-zuerst-hintergrund-zweck-und-einschr%C3%A4nkungen-erl%C3%A4utern\" class=\"anchor\" id=\"prinzip-1-zuerst-hintergrund-zweck-und-einschränkungen-erläutern\"\u003e\u003c/a\u003ePrinzip 1. Zuerst Hintergrund, Zweck und Einschränkungen erläutern\u003c/h2\u003e\n\u003cp\u003eWenn lediglich die Bezeichnung des Ergebnisses genannt wird, etwa \u003ccode\u003eErstelle mir einen Agenten zur Nachrichtensammlung\u003c/code\u003e, muss der Agent Benutzer, Datenquellen, Ausführungsumgebung und Erfolgskriterien erraten. Selbst bei demselben Nachrichtensammler unterscheiden sich die benötigten Quellen und Klassifizierungskriterien für Verantwortliche in der Geschäftsentwicklung, Investoren oder Redakteure einer Universitätszeitung.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#unzureichende-anfrage\" class=\"anchor\" id=\"unzureichende-anfrage\"\u003e\u003c/a\u003eUnzureichende Anfrage\u003c/h3\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eErstelle mir einen Agenten zum Sammeln von AI-Nachrichten.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch3\u003e\n\u003ca href=\"#verbesserte-anfrage\" class=\"anchor\" id=\"verbesserte-anfrage\"\u003e\u003c/a\u003eVerbesserte Anfrage\u003c/h3\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eIch bin für die Geschäftsentwicklung eines IT-Start-ups verantwortlich.\n\u003c/span\u003e\u003cspan\u003eIch möchte jeden Tag vor Arbeitsbeginn schnell Nachrichten aus den Bereichen\n\u003c/span\u003e\u003cspan\u003eAI, Cloud und Fintech prüfen, die sich auf Geschäftspartnerschaften oder die Produktstrategie auswirken.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eZiele:\n\u003c/span\u003e\u003cspan\u003e- Für die angegebenen Schlüsselwörter Kandidaten aktueller Artikel sammeln.\n\u003c/span\u003e\u003cspan\u003e- Artikel mit derselben URL und Duplikate mit ähnlichen Titeln entfernen.\n\u003c/span\u003e\u003cspan\u003e- Die Auswirkungen danach als hoch, mittel oder niedrig klassifizieren,\n\u003c/span\u003e\u003cspan\u003e  ob innerhalb von 3 Monaten eine Produkt- oder Partnerschaftsentscheidung erforderlich ist.\n\u003c/span\u003e\u003cspan\u003e- Die Ergebnisse als koreanisches E-Mail-Briefing erstellen.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eEinschränkungen:\n\u003c/span\u003e\u003cspan\u003e- Die Python-Version und Paketverwaltungsmethode des aktuellen Repositorys beibehalten.\n\u003c/span\u003e\u003cspan\u003e- Vor dem Hinzufügen einer neuen Bibliothek deren Notwendigkeit und Alternativen erläutern.\n\u003c/span\u003e\u003cspan\u003e- API-Schlüssel und E-Mail-Passwörter weder im Code noch in Logs speichern.\n\u003c/span\u003e\u003cspan\u003e- Vor dem tatsächlichen E-Mail-Versand nur eine Vorschaudatei erstellen.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eUntersuche zuerst die Repository-Struktur und die Ausführungsmethode und schlage anschließend einen Implementierungsplan vor.\n\u003c/span\u003e\u003cspan\u003eUnbekannte Informationen zur Umgebung nicht erraten, sondern als Fragenliste zusammenstellen.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eGute Hintergrundinformationen umfassen die folgenden vier Punkte.\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003e\n\u003cstrong\u003eBenutzer und Nutzungssituation:\u003c/strong\u003e Wer verwendet das Ergebnis wann und für welche Entscheidung?\u003c/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eZiel:\u003c/strong\u003e Welches Problem soll gelöst werden, statt lediglich Code zu schreiben?\u003c/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eEinschränkungen:\u003c/strong\u003e Welche Technologien, Sicherheitsregeln sowie Kosten- oder Zeitlimits müssen eingehalten werden?\u003c/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eNicht-Ziele:\u003c/strong\u003e Welche Funktionen sind ausdrücklich von dieser Änderung ausgeschlossen?\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003eDurch die Angabe von Nicht-Zielen lässt sich verhindern, dass der Umfang unbegrenzt wächst. Wird beispielsweise festgelegt, dass \u003ccode\u003ein dieser Phase die geplante Ausführung und der tatsächliche E-Mail-Versand ausgeschlossen sind\u003c/code\u003e, können zunächst die Sammel- und Klassifizierungslogik zuverlässig validiert werden.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#prinzip-2-das-gew%C3%BCnschte-ausgabeformat-als-ausgabevertrag-definieren\" class=\"anchor\" id=\"prinzip-2-das-gewünschte-ausgabeformat-als-ausgabevertrag-definieren\"\u003e\u003c/a\u003ePrinzip 2. Das gewünschte Ausgabeformat als Ausgabevertrag definieren\u003c/h2\u003e\n\u003cp\u003e\u003ccode\u003eSende es ansprechend per E-Mail\u003c/code\u003e wird von jedem anders interpretiert. Für das Ausgabeformat sollten nicht nur Beispiele gezeigt, sondern auch Pflichtfelder, zulässige Werte, der Umgang mit fehlenden Angaben und die Sortierreihenfolge definiert werden.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eE-Mail-Betreff:\n\u003c/span\u003e\u003cspan\u003e[Nachrichten-Briefing] {YYYY-MM-DD} Die wichtigsten Nachrichten des Tages\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eArtikelformat im Nachrichtentext:\n\u003c/span\u003e\u003cspan\u003e1. {Titel}\n\u003c/span\u003e\u003cspan\u003eZusammenfassung: {1–2 Sätze auf Koreanisch}\n\u003c/span\u003e\u003cspan\u003eAuswirkung: {hoch|mittel|niedrig}\n\u003c/span\u003e\u003cspan\u003eBegründung der Bewertung: {1 Satz}\n\u003c/span\u003e\u003cspan\u003eQuelle: {Name des Mediums}\n\u003c/span\u003e\u003cspan\u003eLink: {URL des Originals}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eSortierregeln:\n\u003c/span\u003e\u003cspan\u003e1. Absteigend nach Auswirkung\n\u003c/span\u003e\u003cspan\u003e2. Bei gleicher Auswirkung nach dem neuesten Veröffentlichungszeitpunkt\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eStatistik am Ende:\n\u003c/span\u003e\u003cspan\u003e- Gesamtzahl der Artikel\n\u003c/span\u003e\u003cspan\u003e- Anzahl der Artikel je Auswirkungsstufe\n\u003c/span\u003e\u003cspan\u003e- Schlüsselwörter ohne Suchergebnisse\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eEinschränkungen:\n\u003c/span\u003e\u003cspan\u003e- In der Zusammenfassung keine Zahlen oder Behauptungen erfinden, die nicht im Original enthalten sind.\n\u003c/span\u003e\u003cspan\u003e- Wenn das Datum nicht überprüft werden kann, kein Datum schätzen, sondern als 'nicht überprüfbar' kennzeichnen.\n\u003c/span\u003e\u003cspan\u003e- Einträge ohne Link aus dem endgültigen Briefing ausschließen.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eWenn Ergebnisse zwischen Programmen übertragen werden müssen, empfiehlt es sich, neben einem für Menschen lesbaren Beispiel auch ein JSON-Schema oder eine Typdefinition anzufordern.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e{\n\u003c/span\u003e\u003cspan\u003e  \"\u003c/span\u003e\u003cspan\u003etitle\u003c/span\u003e\u003cspan\u003e\": \"\u003c/span\u003e\u003cspan\u003estring\u003c/span\u003e\u003cspan\u003e\",\n\u003c/span\u003e\u003cspan\u003e  \"\u003c/span\u003e\u003cspan\u003esummary\u003c/span\u003e\u003cspan\u003e\": \"\u003c/span\u003e\u003cspan\u003estring\u003c/span\u003e\u003cspan\u003e\",\n\u003c/span\u003e\u003cspan\u003e  \"\u003c/span\u003e\u003cspan\u003eimpact\u003c/span\u003e\u003cspan\u003e\": \"\u003c/span\u003e\u003cspan\u003ehigh | medium | low\u003c/span\u003e\u003cspan\u003e\",\n\u003c/span\u003e\u003cspan\u003e  \"\u003c/span\u003e\u003cspan\u003ereason\u003c/span\u003e\u003cspan\u003e\": \"\u003c/span\u003e\u003cspan\u003estring\u003c/span\u003e\u003cspan\u003e\",\n\u003c/span\u003e\u003cspan\u003e  \"\u003c/span\u003e\u003cspan\u003esource\u003c/span\u003e\u003cspan\u003e\": \"\u003c/span\u003e\u003cspan\u003estring\u003c/span\u003e\u003cspan\u003e\",\n\u003c/span\u003e\u003cspan\u003e  \"\u003c/span\u003e\u003cspan\u003eurl\u003c/span\u003e\u003cspan\u003e\": \"\u003c/span\u003e\u003cspan\u003eabsolute URL\u003c/span\u003e\u003cspan\u003e\",\n\u003c/span\u003e\u003cspan\u003e  \"\u003c/span\u003e\u003cspan\u003epublished_at\u003c/span\u003e\u003cspan\u003e\": \"\u003c/span\u003e\u003cspan\u003eISO 8601 string | null\u003c/span\u003e\u003cspan\u003e\"\n\u003c/span\u003e\u003cspan\u003e}\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eEin Ausgabevertrag umfasst nicht nur die Form, sondern auch die Bedeutung. Wenn es keine Bewertungskriterien dafür gibt, was \u003ccode\u003eimpact: high\u003c/code\u003e bedeutet, kann die JSON-Syntax korrekt sein, während die Klassifizierungsergebnisse inkonsistent bleiben.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#prinzip-3-ausnahmesituationen-und-wiederherstellungsrichtlinien-festlegen\" class=\"anchor\" id=\"prinzip-3-ausnahmesituationen-und-wiederherstellungsrichtlinien-festlegen\"\u003e\u003c/a\u003ePrinzip 3. Ausnahmesituationen und Wiederherstellungsrichtlinien festlegen\u003c/h2\u003e\n\u003cp\u003eDie Qualität von Produktionscode zeigt sich stärker im Fehlerpfad als im Normalfall. Im Prompt sollten erwartbare Fehler, die Möglichkeit von Wiederholungsversuchen, die Bedingungen für eine Benachrichtigung des Benutzers und Informationen, die nicht protokolliert werden dürfen, gemeinsam angegeben werden.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eAusnahmesituation\u003c/th\u003e\n\u003cth\u003eBeispiel für eine empfohlene Richtlinie\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Ausnahmesituation\"\u003eKeine Suchergebnisse\u003c/td\u003e\n\u003ctd data-label=\"Beispiel für eine empfohlene Richtlinie\"\u003eDas betreffende Schlüsselwort überspringen und in der abschließenden Statistik erfassen\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Ausnahmesituation\"\u003eVorübergehender Netzwerkfehler\u003c/td\u003e\n\u003ctd data-label=\"Beispiel für eine empfohlene Richtlinie\"\u003eNur eine begrenzte Anzahl von Wiederholungsversuchen in festgelegten Abständen\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Ausnahmesituation\"\u003eAuthentifizierungsfehler\u003c/td\u003e\n\u003ctd data-label=\"Beispiel für eine empfohlene Richtlinie\"\u003eNicht erneut versuchen, sondern sofort abbrechen und auf die Überprüfung der Konfiguration hinweisen\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Ausnahmesituation\"\u003eAPI-Nutzungslimit\u003c/td\u003e\n\u003ctd data-label=\"Beispiel für eine empfohlene Richtlinie\"\u003eWarteanweisungen der Antwort beachten und unbegrenzte Wiederholungsversuche verbieten\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Ausnahmesituation\"\u003eDoppelte Artikel\u003c/td\u003e\n\u003ctd data-label=\"Beispiel für eine empfohlene Richtlinie\"\u003eAnhand normalisierter URLs und der Titelähnlichkeit entfernen\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Ausnahmesituation\"\u003eFehlerhaft formatierte Daten\u003c/td\u003e\n\u003ctd data-label=\"Beispiel für eine empfohlene Richtlinie\"\u003eOriginal beibehalten und nur den betreffenden Eintrag isolieren\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Ausnahmesituation\"\u003eFehler beim E-Mail-Versand\u003c/td\u003e\n\u003ctd data-label=\"Beispiel für eine empfohlene Richtlinie\"\u003eWenn auch Wiederholungsversuche fehlschlagen, alternative Benachrichtigung senden oder Fehlerstatus protokollieren\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Ausnahmesituation\"\u003eTeilerfolg\u003c/td\u003e\n\u003ctd data-label=\"Beispiel für eine empfohlene Richtlinie\"\u003eErfolgreiche Ergebnisse und fehlgeschlagene Einträge getrennt melden\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eRichtlinien können wie folgt konkret angefordert werden.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eBehandle Netzwerk-Timeouts als Fehler, bei denen ein erneuter Versuch möglich ist.\n\u003c/span\u003e\u003cspan\u003eWarte zwischen den Versuchen. Wenn die maximale Anzahl überschritten wird,\n\u003c/span\u003e\u003cspan\u003emarkiere nur die betreffende Quelle als fehlgeschlagen.\n\u003c/span\u003e\u003cspan\u003eBrich bei Authentifizierungsfehlern und fehlerhaften Anfragen sofort ab,\n\u003c/span\u003e\u003cspan\u003eda wiederholte Versuche diese Probleme nicht lösen.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eSpeichere in allen Fehler-Logs Zeitpunkt, Arbeitsschritt, Quelle und Fehlertyp,\n\u003c/span\u003e\u003cspan\u003eaber keine API-Schlüssel, vollständigen E-Mail-Adressen, Authentifizierungsheader\n\u003c/span\u003e\u003cspan\u003eoder vollständigen Artikeltexte.\n\u003c/span\u003e\u003cspan\u003eUnterscheide über den Prozess-Exit-Status zwischen vollständigem Erfolg,\n\u003c/span\u003e\u003cspan\u003eTeilerfolg und vollständigem Fehlschlag.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eWerte wie \u003ccode\u003edrei Wiederholungsversuche\u003c/code\u003e oder \u003ccode\u003e5 Sekunden Wartezeit\u003c/code\u003e sind keine universell richtigen Antworten. Sie müssen im Projekt anhand der offiziellen Beschränkungen externer Dienste, der Dringlichkeit der Aufgabe und des Risikos doppelter Ausführungen festgelegt werden. Aufgaben mit Nebenwirkungen, etwa Zahlungen oder der Versand von Nachrichten, können bei automatischen Wiederholungsversuchen ohne garantierte Idempotenz doppelt verarbeitet werden.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#prinzip-4-schrittweise-in-der-reihenfolge-planung-minimale-implementierung-und-validierung-entwickeln\" class=\"anchor\" id=\"prinzip-4-schrittweise-in-der-reihenfolge-planung-minimale-implementierung-und-validierung-entwickeln\"\u003e\u003c/a\u003ePrinzip 4. Schrittweise in der Reihenfolge Planung, minimale Implementierung und Validierung entwickeln\u003c/h2\u003e\n\u003cp\u003eWenn mehrere externe Dienste und die automatische Ausführung gleichzeitig verbunden werden, lassen sich Fehlerursachen nur schwer voneinander trennen. Wird die Implementierung in kleine Validierungseinheiten aufgeteilt, können Ein- und Ausgabe jeder Phase überprüft werden.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#empfohlene-reihenfolge\" class=\"anchor\" id=\"empfohlene-reihenfolge\"\u003e\u003c/a\u003eEmpfohlene Reihenfolge\u003c/h3\u003e\n\u003col\u003e\n\u003cli\u003eRepository-Struktur, relevante Dateien und Ausführungsbefehle untersuchen.\u003c/li\u003e\n\u003cli\u003eVor Codeänderungen einen Plan und die betroffenen Dateien vorlegen lassen.\u003c/li\u003e\n\u003cli\u003eDie Sammelfunktion mit einem Schlüsselwort und festgelegten Beispieldaten implementieren.\u003c/li\u003e\n\u003cli\u003eDeduplizierung und Klassifizierung der Auswirkungen jeweils separat testen.\u003c/li\u003e\n\u003cli\u003eE-Mails nicht tatsächlich versenden, sondern anhand einer lokalen Vorschau validieren.\u003c/li\u003e\n\u003cli\u003eNach Bestehen der Tests die Anbindung eines realen Anbieters und die geplante Ausführung hinzufügen.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003eDie erste Anfrage kann wie folgt eingeschränkt werden.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eFühre jetzt nur Phase 1 aus.\n\u003c/span\u003e\u003cspan\u003eUntersuche das Repository und berichte über Folgendes:\n\u003c/span\u003e\u003cspan\u003e- Einstiegspunkt der aktuellen Anwendung\n\u003c/span\u003e\u003cspan\u003e- Relevante Module und Testdateien\n\u003c/span\u003e\u003cspan\u003e- Verwendete Paketverwaltungs- und Testbefehle\n\u003c/span\u003e\u003cspan\u003e- Dateien, die voraussichtlich geändert werden müssen\n\u003c/span\u003e\u003cspan\u003e- Fragen, die vor der Implementierung geklärt werden müssen\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eÄndere noch keine Dateien.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eNach Prüfung des Plans wird die Implementierung auf einen engen Änderungsumfang begrenzt.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eImplementiere aus dem genehmigten Plan nur die Nachrichtensammlung und Deduplizierung.\n\u003c/span\u003e\u003cspan\u003eFüge Klassifizierung, E-Mail-Versand und geplante Ausführung nicht hinzu.\n\u003c/span\u003e\u003cspan\u003eErmögliche die Ausführung mit festgelegten Testdaten und fasse am Ende\n\u003c/span\u003e\u003cspan\u003edie geänderten Dateien und Ergebnisse der ausgeführten Tests zusammen.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eWenn in der Claude Code-Umgebung ein reiner Planungsmodus verfügbar ist, kann er in der Erkundungs- und Entwurfsphase verwendet werden. Ein plausibel wirkender Plan bedeutet jedoch nicht, dass die Implementierung korrekt ist. Daher müssen tatsächliche Tests und eine Codeprüfung folgen.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#prinzip-5-feedback-anhand-von-fehlerbeispielen-und-zahlen-geben\" class=\"anchor\" id=\"prinzip-5-feedback-anhand-von-fehlerbeispielen-und-zahlen-geben\"\u003e\u003c/a\u003ePrinzip 5. Feedback anhand von Fehlerbeispielen und Zahlen geben\u003c/h2\u003e\n\u003cp\u003eMit Aussagen wie \u003ccode\u003eDas Ergebnis ist nicht besonders gut\u003c/code\u003e, \u003ccode\u003eDie Performance ist langsam\u003c/code\u003e oder \u003ccode\u003eDie Klassifizierung ist falsch\u003c/code\u003e lässt sich die Richtung der Korrektur nur schwer bestimmen. Es müssen der aktuelle Zustand, der erwartete Zustand, die Eingabe zur Reproduktion und der zulässige Änderungsumfang angegeben werden.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#anfrage-zur-l%C3%A4ngen%C3%A4nderung\" class=\"anchor\" id=\"anfrage-zur-längenänderung\"\u003e\u003c/a\u003eAnfrage zur Längenänderung\u003c/h3\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eDer aktuelle E-Mail-Text wird mit etwa 3.000 Zeichen erstellt.\n\u003c/span\u003e\u003cspan\u003eIch möchte ihn auf höchstens 500 Zeichen kürzen, damit er auf Mobilgeräten schnell gelesen werden kann.\n\u003c/span\u003e\u003cspan\u003eBegrenze jede Artikelzusammenfassung auf 1–2 Sätze und behalte die Bewertungsbegründung bei.\n\u003c/span\u003e\u003cspan\u003eVerlinke die URL des Originals im Titel und entferne die separate Linkzeile.\n\u003c/span\u003e\u003cspan\u003eBehalte die Statistik am Ende bei.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch3\u003e\n\u003ca href=\"#anfrage-zur-%C3%A4nderung-der-klassifizierungskriterien\" class=\"anchor\" id=\"anfrage-zur-änderung-der-klassifizierungskriterien\"\u003e\u003c/a\u003eAnfrage zur Änderung der Klassifizierungskriterien\u003c/h3\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eVon 10 Testdatensätzen wurden 8 als 'hoch' klassifiziert.\n\u003c/span\u003e\u003cspan\u003eKlassifiziere langfristige Technologieprognosen oder allgemeine Produktvorstellungen als 'niedrig'.\n\u003c/span\u003e\u003cspan\u003eKlassifiziere einen Artikel nur dann als 'hoch', wenn konkrete Belege dafür vorliegen,\n\u003c/span\u003e\u003cspan\u003edass innerhalb von 3 Monaten Entscheidungen zu Preisen, Produkt-Roadmap,\n\u003c/span\u003e\u003cspan\u003eregulatorischen Maßnahmen oder Partnerschaften geändert werden müssen.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eIn den beigefügten Beispielen sind A und B als hoch und C als niedrig korrekt.\n\u003c/span\u003e\u003cspan\u003eÄndere die Klassifizierungsregeln und füge diese Beispiele als Regressionstests hinzu.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch3\u003e\n\u003ca href=\"#anfrage-zur-performanceverbesserung\" class=\"anchor\" id=\"anfrage-zur-performanceverbesserung\"\u003e\u003c/a\u003eAnfrage zur Performanceverbesserung\u003c/h3\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eDie durchschnittliche Ausführungszeit derselben Beispieleingabe beträgt derzeit etwa 45 Sekunden.\n\u003c/span\u003e\u003cspan\u003eDas Ziel liegt in derselben Umgebung bei höchstens 30 Sekunden.\n\u003c/span\u003e\u003cspan\u003eMiss zuerst die Zeit je Phase und zeige den Engpass.\n\u003c/span\u003e\u003cspan\u003eEntferne weder die Ergebnisgenauigkeit noch die Fehlerbehandlung.\n\u003c/span\u003e\u003cspan\u003eVergleiche Wirkung und Risiken der Verbesserungsalternativen und wende zuerst die kleinste Änderung an.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003ePerformancewerte können nur verglichen werden, wenn Messumgebung und Eingabedaten identisch sind. Die Verbesserung sollte nicht anhand eines einzigen Ausführungsergebnisses beurteilt werden. Auch Messmethode, Stichprobe und Cache-Zustand müssen festgelegt werden.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#prinzip-6-prompt-vorlagen-nach-aufgabentyp-verwenden\" class=\"anchor\" id=\"prinzip-6-prompt-vorlagen-nach-aufgabentyp-verwenden\"\u003e\u003c/a\u003ePrinzip 6. Prompt-Vorlagen nach Aufgabentyp verwenden\u003c/h2\u003e\n\u003ch3\u003e\n\u003ca href=\"#vorlage-zum-erstellen-eines-neuen-agenten\" class=\"anchor\" id=\"vorlage-zum-erstellen-eines-neuen-agenten\"\u003e\u003c/a\u003eVorlage zum Erstellen eines neuen Agenten\u003c/h3\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e[Rolle und Situation]\n\u003c/span\u003e\u003cspan\u003eIch bin {Beruf/Rolle} und möchte {Problemsituation} lösen.\n\u003c/span\u003e\u003cspan\u003eDieses Ergebnis wird von {Benutzer oder nachgelagertes System} verwendet.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e[Ziel]\n\u003c/span\u003e\u003cspan\u003e{Zu erreichendes Ergebnis und Erfolgskriterien}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e[Ausführungsauslöser]\n\u003c/span\u003e\u003cspan\u003e{Manuelle Ausführung, Ereignis, geplanter Zeitpunkt usw.}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e[Eingabe]\n\u003c/span\u003e\u003cspan\u003e- Datenquelle: {Datei/API/Datenbank}\n\u003c/span\u003e\u003cspan\u003e- Pflichtfelder: {Feldliste}\n\u003c/span\u003e\u003cspan\u003e- Authentifizierungsmethode: {Umgebungsvariable oder Methode zur Geheimnisverwaltung}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e[Verarbeitungslogik]\n\u003c/span\u003e\u003cspan\u003e1. {Schritt 1}\n\u003c/span\u003e\u003cspan\u003e2. {Schritt 2}\n\u003c/span\u003e\u003cspan\u003e3. {Schritt 3}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e[Ausgabevertrag]\n\u003c/span\u003e\u003cspan\u003e{Dateiformat, Schema, Vorlage sowie Sortier- und Auslassungsregeln}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e[Ausnahmebehandlung]\n\u003c/span\u003e\u003cspan\u003e{Leere Ergebnisse, Timeout, Authentifizierungsfehler, Richtlinie bei Teilausfällen}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e[Einschränkungen und Nicht-Ziele]\n\u003c/span\u003e\u003cspan\u003e- Beizubehaltende Technologien: {Elemente}\n\u003c/span\u003e\u003cspan\u003e- Verbote: {Elemente}\n\u003c/span\u003e\u003cspan\u003e- Von dieser Aufgabe ausgeschlossene Funktionen: {Elemente}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e[Validierung]\n\u003c/span\u003e\u003cspan\u003e- Zu bestehende Tests: {Elemente}\n\u003c/span\u003e\u003cspan\u003e- Inhalte des Abschlussberichts: geänderte Dateien, Ausführungsbefehle, Testergebnisse, verbleibende Risiken\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eUntersuche zuerst das Repository und lege einen Implementierungsplan vor.\n\u003c/span\u003e\u003cspan\u003eErrate unbekannte Informationen nicht, sondern stelle Fragen.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch3\u003e\n\u003ca href=\"#vorlage-zum-hinzuf%C3%BCgen-einer-bestehenden-funktion\" class=\"anchor\" id=\"vorlage-zum-hinzufügen-einer-bestehenden-funktion\"\u003e\u003c/a\u003eVorlage zum Hinzufügen einer bestehenden Funktion\u003c/h3\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eFüge dem bestehenden {Name des Agenten oder Moduls} die {neue Funktion} hinzu.\n\u003c/span\u003e\u003cspan\u003eDie neue Funktion muss nach {bestehender Schritt A} und vor {bestehender Schritt B} ausgeführt werden.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eDetaillierte Logik:\n\u003c/span\u003e\u003cspan\u003e- {Bedingungen und Verarbeitungsregeln}\n\u003c/span\u003e\u003cspan\u003e- {Ein- und Ausgabeformat}\n\u003c/span\u003e\u003cspan\u003e- {Verhalten bei einem Fehler}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eBeizubehaltende Bedingungen:\n\u003c/span\u003e\u003cspan\u003e- Bestehende öffentliche Schnittstellen und Konfigurationsformate nicht ändern.\n\u003c/span\u003e\u003cspan\u003e- Alle bestehenden Tests beibehalten.\n\u003c/span\u003e\u003cspan\u003e- Keine nicht relevanten Dateien ändern.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eErläutere zuerst den Wirkungsbereich und die Regressionsrisiken.\n\u003c/span\u003e\u003cspan\u003eFüge anschließend Tests hinzu, die das bestehende Verhalten bewahren, und implementiere die Funktion.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch3\u003e\n\u003ca href=\"#vorlage-zur-fehlerbehebung\" class=\"anchor\" id=\"vorlage-zur-fehlerbehebung\"\u003e\u003c/a\u003eVorlage zur Fehlerbehebung\u003c/h3\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eReproduziere den folgenden Fehler und behebe seine Grundursache.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eVollständige Fehlermeldung:\n\u003c/span\u003e\u003cspan\u003e{Fehlermeldung und Stacktrace nach Entfernung geheimer und personenbezogener Informationen}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eAuftretensbedingungen:\n\u003c/span\u003e\u003cspan\u003e- Ausführungsbefehl: {Befehl}\n\u003c/span\u003e\u003cspan\u003e- Eingabe: {Minimale Eingabe zur Reproduktion}\n\u003c/span\u003e\u003cspan\u003e- Umgebung: {Betriebssystem, Laufzeit, relevante Versionen}\n\u003c/span\u003e\u003cspan\u003e- Zeitpunkt des Auftretens: {In welcher Phase}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eErwartetes Verhalten:\n\u003c/span\u003e\u003cspan\u003e{Ergebnis, das bei normalem Verhalten erscheinen sollte}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eTatsächliches Verhalten:\n\u003c/span\u003e\u003cspan\u003e{Aktuell beobachtetes Ergebnis}\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eAnfrage:\n\u003c/span\u003e\u003cspan\u003e1. Reproduziere zuerst den Fehler.\n\u003c/span\u003e\u003cspan\u003e2. Erkläre die Ursache anhand von Belegen.\n\u003c/span\u003e\u003cspan\u003e3. Behebe ihn mit dem kleinstmöglichen Änderungsumfang.\n\u003c/span\u003e\u003cspan\u003e4. Füge einen Regressionstest hinzu, der denselben Fehler verhindert.\n\u003c/span\u003e\u003cspan\u003e5. Berichte über die ausgeführten Tests und verbleibenden Risiken.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eBeim Einfügen von Fehlermeldungen müssen sensible Informationen wie API-Schlüssel, Sitzungstoken, Kundendaten und interne Adressen entfernt werden.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#vollst%C3%A4ndiges-beispiel-anfrage-f%C3%BCr-einen-nachrichten-briefing-agenten\" class=\"anchor\" id=\"vollständiges-beispiel-anfrage-für-einen-nachrichten-briefing-agenten\"\u003e\u003c/a\u003eVollständiges Beispiel: Anfrage für einen Nachrichten-Briefing-Agenten\u003c/h2\u003e\n\u003cp\u003eDas folgende Beispiel kombiniert die sechs Prinzipien in einer einzigen Anfrage.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eIch bin für die Geschäftsentwicklung eines SaaS-Start-ups verantwortlich.\n\u003c/span\u003e\u003cspan\u003eIch möchte täglich nur Nachrichten über Veränderungen in den Märkten für AI,\n\u003c/span\u003e\u003cspan\u003eCloud und Fintech prüfen, die innerhalb von 3 Monaten Produkt- oder\n\u003c/span\u003e\u003cspan\u003ePartnerschaftsentscheidungen verändern können.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eUntersuche das aktuelle Repository und entwirf ein Werkzeug für Nachrichten-Briefings.\n\u003c/span\u003e\u003cspan\u003eImplementiere in der ersten Phase nur die Funktion, die Beispiel-JSON einliest,\n\u003c/span\u003e\u003cspan\u003eDuplikate entfernt, die Auswirkungen klassifiziert und anschließend eine HTML-Vorschaudatei erstellt.\n\u003c/span\u003e\u003cspan\u003eWebsuche, tatsächlicher E-Mail-Versand und geplante Ausführung sind von dieser Phase ausgeschlossen.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eEingabefelder:\n\u003c/span\u003e\u003cspan\u003e- title, url, source, published_at, body\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eVerarbeitungsregeln:\n\u003c/span\u003e\u003cspan\u003e- Identische normalisierte URLs gelten als Duplikate.\n\u003c/span\u003e\u003cspan\u003e- Auch bei unterschiedlichen URLs werden Artikel mit ähnlichen Titeln als Duplikatkandidaten markiert.\n\u003c/span\u003e\u003cspan\u003e- Nur Artikel, die innerhalb von 3 Monaten konkrete Änderungen bei Preisen,\n\u003c/span\u003e\u003cspan\u003e  regulatorischen Maßnahmen, der Produkt-Roadmap oder Partnerschaftsentscheidungen\n\u003c/span\u003e\u003cspan\u003e  erforderlich machen, werden mit der Auswirkung 'hoch' klassifiziert.\n\u003c/span\u003e\u003cspan\u003e- Bei unzureichenden Belegen keine hohe Stufe vermuten.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eAusgabe:\n\u003c/span\u003e\u003cspan\u003e- Titel, Zusammenfassung in 1–2 Sätzen, Auswirkung, Bewertungsbegründung, Quelle und URL anzeigen.\n\u003c/span\u003e\u003cspan\u003e- Absteigend nach Auswirkung sortieren.\n\u003c/span\u003e\u003cspan\u003e- Gesamtzahl, Anzahl entfernter Duplikate und Anzahl je Stufe am Ende anzeigen.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eAusnahmebehandlung:\n\u003c/span\u003e\u003cspan\u003e- Einträge ohne Pflichtfelder nicht ausschließen, sondern in einer separaten Fehlerliste erfassen.\n\u003c/span\u003e\u003cspan\u003e- Fehlerhafte Datumsangaben nicht schätzen, sondern als null beibehalten.\n\u003c/span\u003e\u003cspan\u003e- Weder vollständige Artikeltexte noch Authentifizierungsdaten in Logs speichern.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eValidierung:\n\u003c/span\u003e\u003cspan\u003e- Normale Eingabe, leere Eingabe, doppelte URL, fehlerhaftes Datum und fehlende Pflichtfelder testen.\n\u003c/span\u003e\u003cspan\u003e- Falls bestehende Tests vorhanden sind, müssen alle bestanden werden.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eArbeitsreihenfolge:\n\u003c/span\u003e\u003cspan\u003e1. Repository-Struktur und relevante Dateien untersuchen.\n\u003c/span\u003e\u003cspan\u003e2. Zu ändernde Dateien und Testplan vorlegen.\n\u003c/span\u003e\u003cspan\u003e3. Den Code nicht ändern, bevor ich den Plan geprüft habe.\n\u003c/span\u003e\u003cspan\u003e4. Nach der Genehmigung die minimale Funktion implementieren und über die Testergebnisse berichten.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eDiese Anfrage verlangt nicht, alle erforderlichen Funktionen gleichzeitig in der Produktionsumgebung bereitzustellen. Der Umfang ist begrenzt, und Ausgabebedeutung, Fehlerbehandlung sowie Testfälle sind gemeinsam definiert, sodass sich das Ergebnis leicht beurteilen lässt.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#qualit%C3%A4tskriterien-die-bei-ausschlie%C3%9Flicher-konzentration-auf-prompts-leicht-%C3%BCbersehen-werden\" class=\"anchor\" id=\"qualitätskriterien-die-bei-ausschließlicher-konzentration-auf-prompts-leicht-übersehen-werden\"\u003e\u003c/a\u003eQualitätskriterien, die bei ausschließlicher Konzentration auf Prompts leicht übersehen werden\u003c/h2\u003e\n\u003cp\u003eViele Anleitungen zum Vibe Coding konzentrieren sich darauf, detailliertere Anweisungen zu schreiben. Weitere Faktoren, die jedoch die tatsächliche Qualität bestimmen, sind \u003cstrong\u003eValidierbarkeit, Änderungskontrolle, Beobachtbarkeit und Sicherheitsgrenzen\u003c/strong\u003e.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#1-abnahmekriterien-in-tests-umwandeln\" class=\"anchor\" id=\"1-abnahmekriterien-in-tests-umwandeln\"\u003e\u003c/a\u003e1. Abnahmekriterien in Tests umwandeln\u003c/h3\u003e\n\u003cp\u003eStatt \u003ccode\u003eSorge dafür, dass es gut funktioniert\u003c/code\u003e werden Eingaben mit den erwarteten Ausgaben als Paare bereitgestellt. Wichtige Klassifizierungsbeispiele werden als Regressionstests festgehalten, um zu prüfen, ob die Ergebnisse auch bei späteren Änderungen erhalten bleiben.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#2-die-selbsteinsch%C3%A4tzung-des-agenten-nicht-als-endg%C3%BCltigen-beleg-verwenden\" class=\"anchor\" id=\"2-die-selbsteinschätzung-des-agenten-nicht-als-endgültigen-beleg-verwenden\"\u003e\u003c/a\u003e2. Die Selbsteinschätzung des Agenten nicht als endgültigen Beleg verwenden\u003c/h3\u003e\n\u003cp\u003eDass ein Agent erklärt, er sei \u003ccode\u003efertig\u003c/code\u003e, ist nicht dasselbe wie bestandene Tests. Er sollte über ausgeführte Befehle, Testergebnisse, geänderte Dateien und ungelöste Risiken berichten, und ein Mensch muss den diff prüfen.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#3-berechtigungen-und-geheime-informationen-minimieren\" class=\"anchor\" id=\"3-berechtigungen-und-geheime-informationen-minimieren\"\u003e\u003c/a\u003e3. Berechtigungen und geheime Informationen minimieren\u003c/h3\u003e\n\u003cp\u003eNicht benötigte Verzeichnisse, Produktionsdatenbanken und Bereitstellungszugangsdaten werden nicht gemeinsam zur Verfügung gestellt. API-Schlüssel werden weder direkt in Prompts noch in Repositorys eingetragen. Stattdessen werden Umgebungsvariablen oder genehmigte Systeme zur Geheimnisverwaltung verwendet. MCP-Servern oder Skripten unbekannter Herkunft wird kein Zugriff auf sensible Repositorys gewährt.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#4-beobachtbaren-code-verlangen\" class=\"anchor\" id=\"4-beobachtbaren-code-verlangen\"\u003e\u003c/a\u003e4. Beobachtbaren Code verlangen\u003c/h3\u003e\n\u003cp\u003eBei automatisierten Aufgaben werden Informationen hinterlassen, die zur Ermittlung von Fehlerursachen erforderlich sind, etwa Status je Phase, strukturierte Fehler, Ausführungszeiten und die Anzahl verarbeiteter Datensätze. Authentifizierungsdaten und personenbezogene Informationen werden dagegen aus Logs entfernt.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#5-%C3%A4nderungen-reversibel-gestalten\" class=\"anchor\" id=\"5-änderungen-reversibel-gestalten\"\u003e\u003c/a\u003e5. Änderungen reversibel gestalten\u003c/h3\u003e\n\u003cp\u003eNicht relevante Refactorings und Funktionserweiterungen werden nicht in derselben Änderung vermischt. Werden diffs in kleinen Einheiten geprüft und in der Versionsverwaltung erfasst, lassen sich fehlerhafte Änderungen leichter isolieren und rückgängig machen.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#tipps-f%C3%BCr-den-betrieb-von-claude-code-projekten\" class=\"anchor\" id=\"tipps-für-den-betrieb-von-claude-code-projekten\"\u003e\u003c/a\u003eTipps für den Betrieb von Claude Code-Projekten\u003c/h2\u003e\n\u003cul\u003e\n\u003cli\u003eWiederkehrende Projektregeln kurz und konkret in \u003ccode\u003eCLAUDE.md\u003c/code\u003e festhalten.\u003c/li\u003e\n\u003cli\u003eBuild-, Test- und Lint-Befehle in tatsächlich ausführbarer Form angeben.\u003c/li\u003e\n\u003cli\u003eKeine geheimen Informationen, einmaligen Fehler-Logs oder langen Referenzdokumente in \u003ccode\u003eCLAUDE.md\u003c/code\u003e aufnehmen.\u003c/li\u003e\n\u003cli\u003eVor umfangreichen Änderungen zuerst relevante Dateien und Abhängigkeiten untersuchen lassen.\u003c/li\u003e\n\u003cli\u003eBeim Hinzufügen neuer Pakete Notwendigkeit, Lizenz und Wartungsrisiken prüfen.\u003c/li\u003e\n\u003cli\u003eGefährliche Befehle zum Löschen, Bereitstellen oder Ändern von Daten nicht automatisch genehmigen.\u003c/li\u003e\n\u003cli\u003eVor der Anbindung externer APIs oder von MCP prüfen, wohin Daten übertragen werden.\u003c/li\u003e\n\u003cli\u003eNach Abschluss geänderte Dateien, Ausführungsbefehle, Testergebnisse und verbleibende Einschränkungen zusammenfassen lassen.\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2\u003e\n\u003ca href=\"#checkliste-vor-der-einreichung\" class=\"anchor\" id=\"checkliste-vor-der-einreichung\"\u003e\u003c/a\u003eCheckliste vor der Einreichung\u003c/h2\u003e\n\u003cul\u003e\n\u003cli\u003e Sind Benutzer und Nutzungssituation beschrieben?\u003c/li\u003e\n\u003cli\u003e Sind Ziele und Nicht-Ziele voneinander getrennt?\u003c/li\u003e\n\u003cli\u003e Sind bestehende Technologien und Bereiche, die nicht geändert werden dürfen, angegeben?\u003c/li\u003e\n\u003cli\u003e Sind Eingabedaten und Ausgabeformat definiert?\u003c/li\u003e\n\u003cli\u003e Ist die Bedeutung von Klassifizierungs- und Statuswerten erläutert?\u003c/li\u003e\n\u003cli\u003e Gibt es Richtlinien für leere Ergebnisse, Authentifizierungsfehler, Timeouts und Teilausfälle?\u003c/li\u003e\n\u003cli\u003e Sind Planung und Implementierung phasenweise voneinander getrennt?\u003c/li\u003e\n\u003cli\u003e Gibt es Tests für Normal-, Grenz- und Fehlerfälle?\u003c/li\u003e\n\u003cli\u003e Sind geheime und personenbezogene Informationen aus Prompts und Logs ausgeschlossen?\u003c/li\u003e\n\u003cli\u003e Wurden ein von Menschen zu prüfender diff und Ausführungsbelege angefordert?\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eDer Kern eines guten Claude Code-Prompts besteht nicht darin, lange Anweisungen zu schreiben. Es geht darum, die Punkte zu reduzieren, die der Agent erraten muss, und das Ergebnis so zu gestalten, dass auch Dritte reproduzierbar feststellen können, ob es korrekt ist.\u003c/p\u003e\n","tags":["Prompt Engineering","Harness Engineering","Claude Code","KI Coding","Programmieragent"],"faqs":[{"question":"Sind längere Claude Code-Prompts besser?","answer":"Wichtiger als die Länge ist, ob die für die Aufgabe erforderlichen Informationen strukturiert enthalten sind. Hintergrund, Ziel, Einschränkungen, Ausgabevorgaben, Fehlerbehandlung und Abschlusskriterien sollten konkret formuliert werden; irrelevante Erläuterungen und redundante Anweisungen sollten hingegen entfernt werden."},{"question":"Kann ich nicht von Anfang an darum bitten, das gesamte Programm zu erstellen?","answer":"Bei einem kleinen, eigenständigen Tool ist das möglich, aber bei Aufgaben, die eine externe API, eine Datenbank, E-Mail und eine zeitgesteuerte Ausführung umfassen, ist eine schrittweise Entwicklung sicherer. Wenn zunächst das Repository untersucht und der Plan geprüft wird und die Anwendung anschließend in der Reihenfolge Mindestfunktionalität, Tests und externe Anbindungen erweitert wird, lassen sich Fehlerursachen leichter isolieren."},{"question":"Kann ich Tests auslassen, wenn ich den Plan Mode verwende?","answer":"Nein. Der Planungsmodus ist nützlich, um vor Änderungen die Struktur und den Ansatz zu prüfen, belegt jedoch nicht die Korrektheit des tatsächlichen Codes. Nach der Implementierung müssen automatisierte Tests, statische Analysen, eine Prüfung der Änderungen und erforderliche manuelle Kontrollen separat durchgeführt werden."},{"question":"Was sollte in CLAUDE.md stehen?","answer":"Darin sollten Anweisungen festgehalten werden, die bei verschiedenen Aufgaben wiederholt gelten, etwa die Projektstruktur, Programmierrichtlinien, Build- und Testbefehle sowie Bereiche, die nicht geändert werden dürfen. API-Schlüssel, Passwörter, personenbezogene Daten, Beschreibungen einmaliger Aufgaben und übermäßig umfangreiche Referenzmaterialien sollten nicht aufgenommen werden."},{"question":"Welche Informationen sollte ich bei einer Anfrage zur Fehlerbehebung bereitstellen?","answer":"Bereitgestellt werden sollten die um sensible Informationen bereinigte Fehlermeldung und Stacktrace, der Ausführungsbefehl, eine minimale Eingabe zur Reproduktion, die relevante Umgebung sowie das tatsächliche und das erwartete Verhalten. Es empfiehlt sich außerdem, eine Erklärung der Ursache, eine Änderung im kleinstmöglichen Umfang, Regressionstests und die Ausführungsergebnisse anzufordern."},{"question":"Kann ich Claude Code einen API-Schlüssel über den Prompt übermitteln?","answer":"Grundsätzlich sollten echte API-Schlüssel weder direkt im Prompt noch im Quellcode eingetragen werden. Verwenden Sie freigegebene Umgebungsvariablen oder ein System zur Verwaltung von Geheimnissen und stellen Sie sicher, dass auch in Protokollen und Testergebnissen keine Authentifizierungsdaten offengelegt werden."},{"question":"Müssen im Prompt unbedingt die Anzahl der Wiederholungsversuche und die Wartezeit angegeben werden?","answer":"Bei der Betriebsautomatisierung ist es wichtig, zwischen Fehlern, bei denen ein erneuter Versuch möglich ist, und Fehlern, bei denen sofort abgebrochen werden muss, zu unterscheiden. Die konkrete Anzahl der Versuche und die Wartezeit sollten jedoch anhand der Beschränkungen des externen Dienstes, der Dringlichkeit der Aufgabe und des Risikos einer doppelten Verarbeitung festgelegt werden; nicht jeder Fehler darf bedingungslos erneut versucht werden."},{"question":"Wie kann ich feststellen, ob der generierte Code fertiggestellt ist?","answer":"Dies wird anhand der zuvor festgelegten Abnahmekriterien beurteilt. Es muss geprüft werden, ob die Tests für die erforderlichen Funktionen und Ausnahmefälle bestanden wurden, welche Befehle ausgeführt und welche Dateien geändert wurden und ob die Leistungs- oder Sicherheitsanforderungen erfüllt sind. Zudem müssen die Codeänderungen von einem Menschen geprüft werden."}],"sources":[{"url":"https://docs.anthropic.com/en/docs/claude-code/overview","title":"Claude Code – Überblick","type":"source"},{"url":"https://www.anthropic.com/engineering/claude-code-best-practices","title":"Claude Code: Best Practices für agentenbasiertes Programmieren","type":"source"},{"url":"https://github.com/anthropics/claude-code","title":"GitHub-Repository von Anthropic Claude Code","type":"source"}],"images":[{"id":845,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MTExNTQsInB1ciI6ImJsb2JfaWQifX0=--9f2d2e2c8a61fc294a6019e4807ece297f36e85a/ai-4caeb237.webp","is_representative":true,"generation_method":"ai_photo","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"코드와 작업 흐름이 표시된 대형 모니터 앞에서 작업하는 개발자","caption":"개발자가 여러 화면의 코드와 문서를 검토하며 작업하고 있다.","description":null},"en":{"alt":"Developer working at a desk with code and a workflow diagram on a large monitor","caption":"A developer reviews code and documentation across multiple screens.","description":null},"ja":{"alt":"コードとワークフロー図を映した大型モニターの前で作業する開発者","caption":"開発者が複数の画面でコードとドキュメントを確認している。","description":null},"es":{"alt":"Desarrollador trabajando frente a un monitor grande con código y un diagrama de flujo","caption":"Un desarrollador revisa código y documentación en varias pantallas.","description":null},"id":{"alt":"Pengembang bekerja di depan monitor besar yang menampilkan kode dan diagram alur kerja","caption":"Seorang pengembang meninjau kode dan dokumentasi di beberapa layar.","description":null},"pt":{"alt":"Desenvolvedor trabalhando diante de um monitor grande com código e diagrama de fluxo","caption":"Um desenvolvedor analisa código e documentação em várias telas.","description":null},"zh-hant":{"alt":"開發人員在顯示程式碼與工作流程圖的大型螢幕前工作","caption":"開發人員正透過多個螢幕檢視程式碼與文件。","description":null},"de":{"alt":"Entwickler vor einem großen Monitor mit Code und einem Ablaufdiagramm","caption":"Ein Entwickler prüft Code und Dokumentation auf mehreren Bildschirmen.","description":null}}},{"id":846,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MTExNjAsInB1ciI6ImJsb2JfaWQifX0=--285d7ecdc8209e07e0fc4eb68085cd8a304b9a81/ai-062b34c5.webp","is_representative":false,"generation_method":"ai_image","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"코드 편집기가 열린 노트북과 요구사항, 표, 오류, 버전 관리, 성과 차트를 연결한 개발 워크플로","caption":"체계적인 프롬프트가 코딩 결과물의 검증과 완성도를 높이는 과정을 보여준다.","description":null},"en":{"alt":"Laptop code editor connected to requirements, tables, errors, version control, and performance charts","caption":"The workflow shows how structured prompts support validation and more polished coding results.","description":null},"ja":{"alt":"要件、表、エラー、バージョン管理、成果グラフにつながるコードエディター搭載ノートPC","caption":"構造化されたプロンプトがコードの検証と完成度向上を支える流れを示している。","description":null},"es":{"alt":"Portátil con editor de código conectado a requisitos, tablas, errores, versiones y gráficos de rendimiento","caption":"El flujo muestra cómo los prompts estructurados ayudan a validar y perfeccionar el código.","description":null},"id":{"alt":"Laptop dengan editor kode yang terhubung ke spesifikasi, tabel, galat, kontrol versi, dan grafik kinerja","caption":"Alur ini menunjukkan bagaimana prompt terstruktur membantu validasi dan penyempurnaan hasil kode.","description":null},"pt":{"alt":"Notebook com editor de código ligado a requisitos, tabelas, erros, controle de versão e gráficos de desempenho","caption":"O fluxo mostra como prompts estruturados ajudam a validar e aprimorar os resultados do código.","description":null},"zh-hant":{"alt":"筆電程式碼編輯器連結需求、表格、錯誤、版本控制與成效圖表","caption":"此流程呈現結構化提示如何協助驗證程式碼並提升成果完成度。","description":null},"de":{"alt":"Laptop mit Code-Editor, verbunden mit Anforderungen, Tabellen, Fehlern, Versionskontrolle und Leistungsdiagrammen","caption":"Der Ablauf zeigt, wie strukturierte Prompts die Prüfung und Verfeinerung von Code unterstützen.","description":null}}}],"published_at":"2026-08-23T02:30:01+09:00","updated_at":"2026-08-23T02:30:01+09:00","license":"cc_by","translation_status":"reviewed","available_locales":["ko","en","ja","es"],"data_locales":["ko","en","ja","es","id","pt","zh-hant","de"],"url":"https://injoys.com/en/articles/claude-code-prompt-six-principles-and-templates"}