Arbeiten mit Claude Fable 5 lehrt mich immer wieder eine alte Lektion: Die Karte ist nicht das Gebiet.
Die Karte, eine Darstellung der zu erledigenden Arbeit, sind meine Prompts, Fähigkeiten und der Kontext – das, was ich Claude gebe. Das Gebiet ist der Ort, an dem die Arbeit stattfinden muss, die Codebasis, die reale Welt mit ihren tatsächlichen Einschränkungen.
Den Unterschied zwischen der Karte und dem Gebiet nenne ich Unbekannte. Wenn Claude auf ein Unbekanntes stößt, muss es eine Entscheidung auf der Grundlage seiner besten Schätzung dessen treffen, was ich möchte. Je mehr Arbeit erledigt wird, desto mehr Unbekannte könnten Claude begegnen.
Fable ist das erste Modell, bei dem ich feststelle, dass die Qualität der Arbeit durch meine Fähigkeit, seine Unbekannten zu klären, begrenzt wird.
Wichtig ist: Allein im Voraus zu planen, reicht nicht immer aus. Man kann tief in der Implementierung auf Unbekannte stoßen, oder Ihre Unbekannten können darauf hinweisen, dass Sie das Problem eigentlich auf eine ganz andere Weise lösen sollten.
Ich habe festgestellt, dass die Arbeit mit Fable ein iterativer Prozess ist, bei dem ich meine Unbekannten vor, während und nach der Implementierung entdecke.
Ich habe einige Beispiel-Artefakte zum Finden von Unbekannten hier erstellt, aber kommen Sie unbedingt zurück, um ein Gespür dafür zu entwickeln, wann Sie sie einsetzen sollten.
Die eigenen Unbekannten kennen
Was sind Ihre Unbekannten? Wenn ich mit einem Problem zu Claude komme, unterteile ich es normalerweise auf vier Arten:
- Bekannte Bekannte: Das ist im Wesentlichen das, was in meinem Prompt steht. Was sage ich dem Agenten, dass ich möchte?
- Bekannte Unbekannte: Was habe ich noch nicht herausgefunden, bin mir aber bewusst, dass ich es noch nicht weiß?
- Unbekannte Bekannte: Was ist so offensichtlich, dass ich es nie aufschreiben würde, aber erkennen würde, wenn ich es sähe?
- Unbekannte Unbekannte: Was habe ich überhaupt nicht bedacht? Welches Wissen ist mir nicht bewusst? Weiß ich, wie gut etwas sein kann?
Die besten agentischen Programmierer haben relativ wenige Unbekannte. Wenn man jemandem wie Boris oder Jarred beim Prompten zusieht, wird mir klar, dass sie genau wissen, was sie wollen. Sie sind tief mit der Codebasis und den Modellverhalten synchronisiert.
Aber sie gehen auch von Unbekannten aus. In vielerlei Hinsicht ist das Reduzieren und Planen für Ihre Unbekannten die Fähigkeit des agentischen Programmierens. Aber glücklicherweise ist dies eine Fähigkeit, die Sie verbessern können, indem Sie mit Claude arbeiten.
Helfen Sie Claude, Ihnen zu helfen
Claude Anweisungen zu geben, ist eine heikle Balance. Wenn Sie zu spezifisch sind, wird Claude Ihren Anweisungen folgen, selbst wenn eine Kursänderung angebrachter wäre. Wenn Sie zu vage sind, wird Claude oft Entscheidungen und Annahmen auf der Grundlage von Branchenstandards treffen, die möglicherweise nicht zu Ihrer Aufgabe passen.
Wenn Sie Ihre Unbekannten nicht berücksichtigen, scheitern Sie auf beide Arten. Sie wissen nicht, wann der Weg voller Hindernisse sein wird, und Sie wissen nicht, wann der Weg frei sein wird, aber Sie möchten trotzdem, dass Claude abweicht.
Claude kann Ihnen helfen, Ihre Unbekannten schneller zu entdecken. Es kann extrem schnell in Ihrer Codebasis und im Internet suchen und weiß viel mehr über das durchschnittliche Thema als Sie. Es kann auch schneller aus Fehlern lernen.
Der wichtigste Teil dieses Prozesses ist, Claude Kontext über Ihren Ausgangspunkt zu geben. Sagen Sie ihm zum Beispiel, wo Sie in Ihrem Gedankengang stehen; offenbaren Sie Ihre Erfahrung mit dem Problem und der Codebasis; und lassen Sie es wie einen Gedankenpartner mit Ihnen arbeiten.
Ich habe bereits darüber geschrieben, wie man HTML mit Claude verwendet. In fast all diesen Fällen ist ein HTML-Artefakt der beste Weg, es zu visualisieren und darzustellen.
In diesem Artikel beschreibe ich einige der Muster, die ich verwende, um diese Unbekannten aufzudecken. Ich verwende nicht jede Technik jedes Mal, aber es ist eine nützliche Sammlung von Techniken, die man parat haben sollte.
Vor der Implementierung
Blind-Spot-Pass
Wenn Sie mit der Arbeit beginnen, ist es eine der nützlichsten Sachen, die Sie tun können, Ihre blinden Flecken zu verstehen. Wenn Sie zum Beispiel eine Funktion in einem neuen Teil der Codebasis schreiben oder Claude verwenden, um Ihnen bei ungewohnter Arbeit wie dem Iterieren eines Designs zu helfen, haben Sie wahrscheinlich viele unbekannte Unbekannte.
Sie wissen vielleicht nicht, welche Fragen Sie stellen sollen, wie „gut“ aussieht, welche historische Arbeit geleistet wurde oder welche Fallstricke Sie vermeiden sollten.
Dazu können Sie Claude bitten, Ihnen zu helfen, Ihre unbekannten Unbekannten zu finden und sie Ihnen zu erklären. Ich verwende gerne die wörtlichen Worte „Blindspot Pass“ und „Unknown Unknowns“. Ihm Kontext darüber zu geben, wer Sie sind und was Sie wissen, ist normalerweise wichtig dafür.
Beispiel-Prompts:
- „Ich arbeite daran, einen neuen Auth-Provider hinzuzufügen, aber ich weiß nichts über die Auth-Module in dieser Codebasis. Kannst du einen Blindspot Pass machen, um mir zu helfen, meine relevanten unbekannten Unbekannten herauszufinden und mir zu helfen, dich besser zu prompten.“
- „Ich weiß nicht, was Color Grading ist, aber ich muss dieses Video gradieren. Kannst du mir beibringen, meine unbekannten Unbekannten über Color Grading zu verstehen, damit ich besser prompten kann?“
Brainstormings und Prototypen
Wenn ich in einem Bereich mit vielen unbekannten Bekannten arbeite, die Kriterien betreffen, die ich erst definieren kann, wenn ich sie sehe, bitte ich Claude gerne, mit mir zu brainstormen und zu prototypisieren.
Es ist äußerst wertvoll, unbekannte Bekannte früh während des Prototypings zu identifizieren und zu verbalisieren, da ihr Auffinden während der Implementierung (relativ) teuer sein kann. Kleine Änderungen an einer Funktion oder Spezifikation können zu drastisch unterschiedlichen Implementierungen im Code führen, und es kann für Ihren Agenten schwieriger sein, vorherige Änderungen rückgängig zu machen.
Zum Beispiel möchten Sie vielleicht nur sehen, wie ein zu einem Frame hinzugefügter Button aussieht, ohne eine Backend-Route einrichten oder zusätzlichen Status im Frontend verwalten zu müssen.
Visuelles Design ist etwas, das für mich schwer zu artikulieren ist, aber ich weiß, was ich will, wenn ich es sehe. In diesen Fällen frage ich nach mehreren Designansätzen für ein Artefakt.
Ich beginne fast jede Codierungssitzung mit einer Erkundungs- oder Brainstorming-Phase. Das hilft mir, mit der Absicht zu beginnen, den Umfang des Projekts zu definieren. Claude findet oft wertvolle Ansätze, die ich übersehen hätte, und verliert manchmal den Wald vor lauter Bäumen. Brainstorming verhindert, dass ich den Umfang zu eng oder zu weit fasse.
Beispiel-Prompts:
- „Ich möchte ein Dashboard für diese Daten, aber ich habe keinen visuellen Geschmack und weiß nicht, was möglich ist. Erstelle mir eine HTML-Seite mit 4 völlig unterschiedlichen Designrichtungen, damit ich darauf reagieren kann.“
- „Bevor du etwas verdrahtest, erstelle eine einzelne HTML-Datei, die die neue Editor-Symbolleiste mit gefälschten Daten nachahmt. Ich möchte auf das Layout reagieren, bevor du die echte App anfasst.“
- „Hier ist mein grobes Problem: Benutzer springen nach dem Onboarding ab. Durchsuche die Codebasis und brainstorme 10 Stellen, an denen wir eingreifen könnten, von der günstigsten bis zur ambitioniertesten. Ich sage dir, welche für mich in Frage kommen.“
Interviews
Sobald ich ausreichend gebrainstormt habe, habe ich wahrscheinlich immer noch Unbekannte.
In diesem Fall bitte ich Claude, mich zu etwaigen Unbekannten oder Unklarheiten zu interviewen. Wenn Sie Claude bitten, Sie zu interviewen, versuchen Sie, ihm Kontext zu Ihrem Problem zu geben, um seine Fragen zu leiten. Hier sind einige Beispiele.
Beispiel-Prompts:
- „Interviewe mich eine Frage nach der anderen zu allem, was mehrdeutig ist. Priorisiere Fragen, bei denen meine Antwort die Architektur ändern würde.“
Referenzen
Manchmal können Sie nicht im Detail beschreiben, was Sie wollen. Zum Beispiel haben Sie vielleicht nicht die Sprache dafür oder es ist so kompliziert, dass es eine ganze Weile dauern würde.
In diesem Fall ist die beste Antwort eine Referenz. Während Sie Diagramme, Dokumentationen oder Bilder einfügen können, ist die absolut beste Referenz Quellcode.
Wenn Sie eine Bibliothek haben, die etwas auf eine bestimmte Weise implementiert, oder eine Designkomponente, die Sie wirklich mögen, zeigen Sie Fable einfach auf den Ordner und sagen Sie ihm, wonach es suchen soll, selbst wenn es in einer anderen Sprache ist.
So funktioniert auch Claude Design. Sie müssen ihm keine Datei geben (obwohl Sie das auch tun können). Sie können es auf ein Modul einer Website zeigen, die Sie mögen, und es liest den zugrunde liegenden Code, nicht nur den Screenshot. Dies liefert viel detailliertere Informationen über das Markup, die Struktur und wie die Komponente tatsächlich aufgebaut ist.
Beispiel-Prompts:
- „Diese Rust-Crate in vendor/rate-limiter implementiert genau das Backoff-Verhalten, das ich möchte. Lies sie und implementiere die gleiche Semantik in unserem TypeScript-API-Client neu.“
Implementierungspläne
Wenn ich denke, dass ich bereit für die Implementierung bin, bitte ich Claude normalerweise, einen Implementierungsplan für mich zu erstellen, den ich überprüfen kann und der sich auf die Teile konzentriert, die sich am wahrscheinlichsten ändern werden, zum Beispiel um Datenmodelle, Typschnittstellen oder UX-Abläufe zu überprüfen. Dies ermöglicht Claude, Dinge an die Oberfläche zu bringen, die ich tatsächlich ändern muss.
Beispiel-Prompts:
- „Schreibe einen Implementierungsplan in HTML, aber beginne mit den Entscheidungen, die ich am wahrscheinlichsten anpassen werde: Datenmodelländerungen, neue Typschnittstellen und alles, was benutzerseitig ist. Vergrabe die mechanische Refaktorisierung am Ende, da vertraue ich dir.“
Während der Implementierung
Implementierungsnotizen
Sobald ich mit meinem Plan zufrieden bin, erstelle ich eine neue Sitzung und übergebe alle Artefakte an den Prompt. Zum Beispiel könnte ich eine Spezifikationsdatei und einen Prototypen übergeben und einen Agenten bitten, dies zu implementieren.
Aber die Wahrheit ist, dass, egal wie viel Sie planen, immer unbekannte Unbekannte lauern. Der Agent könnte während seiner Arbeit feststellen, dass er aufgrund eines Grenzfalls, den er im Code gefunden hat, einen anderen Ansatz verfolgen muss.
Ich bitte Claude Code, eine temporäre ‚implementation-notes.md‘ (oder .html) Datei zu führen, in der es die getroffenen Entscheidungen festhält, damit wir aus unserem nächsten Versuch lernen können.
Beispiel-Prompts:
- „Führe eine implementation-notes.md Datei. Wenn du auf einen Grenzfall stößt, der dich zwingt, vom Plan abzuweichen, wähle die konservative Option, protokolliere sie unter ‚Abweichungen‘ und mach weiter.“
Nach der Implementierung
Pitches und Erklärungen
Einer der wichtigsten Teile beim Ausliefern von etwas ist, Zustimmung und Genehmigungen zu erhalten. Das Erstellen von Pitch- und Erklärungs-Artefakten im endgültigen Dokument hilft:
- Das Verständnis zu beschleunigen, wenn Prüfer mit denselben Unbekannten beginnen wie Sie
- Genehmigungen zu beschleunigen, wenn Experten sehen möchten, dass Sie die Unbekannten und häufigen Fehlerpunkte berücksichtigt haben, die sie erwartet hätten
Beispiel-Prompts:
- „Packe den Prototypen, die Spezifikation und die Implementierungsnotizen in ein einzelnes Dokument, das ich in Slack posten kann, um Zustimmung zu erhalten. Beginne mit dem Demo-GIF.“
Tests
Nach einer langen Arbeitssitzung könnte Claude viel mehr erreicht haben, als mir bewusst ist. Das Lesen der Code-Diffs kann mir nur ein oberflächliches Verständnis davon geben, was passiert ist, da vieles vom Verhalten von den bestehenden Codepfaden abhängt.
Claude zu bitten, mich nach der Änderung zu testen, nachdem es mir eine Menge Kontext gegeben hat, hilft mir zu verstehen, was passiert ist. Ich merge nur, nachdem ich den Test perfekt bestanden habe.
Beispiel-Prompts:
- „Ich möchte sicherstellen, dass ich alles verstehe, was bei dieser Änderung passiert ist. Gib mir einen HTML-Bericht über die Änderungen, den ich lesen und mit Kontext, Intuition, was getan wurde usw. verstehen kann, und einen Test am Ende über die Änderungen, den ich bestehen muss.“
Wie das zusammenkommt: Der Start von Fable
Das Startvideo für Fable wurde vollständig von Claude Code bearbeitet. Dies war ein neues Gebiet für mich, und ich bin keineswegs ein Experte.
Also begann ich mit dem, was ich wusste. Ich wusste, dass Claude Code verwenden kann, um Videos zu bearbeiten und zu transkribieren, aber ich war mir nicht sicher, ob es genau genug war. Dann bat ich Claude, mir zu erklären, wie Transkription wie Whisper funktioniert und ob ich mit ffmpeg Dinge wie „Ähs“ oder große Pausen genau herausschneiden könnte.
Ich wollte, dass Claude eine Benutzeroberfläche erstellt, die zeitlich mit den Worten, die ich sagte, abgestimmt war, war mir aber nicht sicher, ob es dazu in der Lage wäre. Also bat ich Claude, ein Prototyp-Video mit Remotion und einer Transkription zu erstellen, um zu sehen, ob es funktionieren würde.
Schließlich sah das Video selbst etwas gedämpft aus, was meiner Meinung nach das Ergebnis von Color Grading war, aber ich wusste nicht wirklich, was Color Grading ist. Mein erster Versuch war, Claude zu bitten, ein paar Variationen zur Auswahl zu erstellen, aber mir wurde klar, dass ich nicht wusste, wie „gut“ in Bezug auf Color Grading aussieht. Also bat ich Claude stattdessen, mir etwas über Color Grading beizubringen, um meine Unbekannten zu entdecken.
Eine ausführlichere Erklärung dazu finden Sie [hier](https://x.com/trq212/status/2064826394589442448/video/1).
Karte und Gebiet in Einklang bringen
Je besser die Modelle werden, desto mehr können Sie mit dem richtigen Ansatz erreichen. Wenn eine langfristige Aufgabe falsch zurückkommt, müssen Sie wahrscheinlich mehr Zeit damit verbringen, Ihre Unbekannten zu definieren oder einen Implementierungsplan zu erstellen, der es Claude ermöglicht, sich durch sie hindurch zu improvisieren.
Jeder Erklärer, jedes Brainstorming, jedes Interview, jeder Prototyp und jede Referenz ist ein billiger Weg, um herauszufinden, was Sie nicht wussten, bevor es teuer wird, es zu beheben.
Beginnen Sie also Ihr nächstes Projekt, indem Sie Claude bitten, Ihnen zu helfen, Ihre Unbekannten zu finden.
