Was macht Find Your Knowns?
Nutzen Sie diesen routinierten Workflow, um die Kluft zwischen der „Karte“ des Benutzers und dem tatsächlichen „Territorium“ zu schließen, bevor Sie riskante Implementierungsentscheidungen treffen. Die Karte ist der Prompt, das Ticket, der Plan oder die Referenz, die der Benutzer gegeben hat. Das Territorium ist das tatsächliche Repository, das Produktverhalten, das Designsystem, die Daten, APIs, Produktionseinschränkungen und die stillschweigenden Benutzererwartungen.
Zuschreibung: Dies ist ein ursprünglicher Agenten-Workflow, inspiriert von Thariq Shihipars Artikel „A Field Guide to Fable: Finding Your Unknowns“ und den begleitenden Beispielen „Know your unknowns“. Geben Sie dem Framework Anerkennung, wenn Sie wiederverwendbare Artefakte erstellen, kopieren Sie jedoch keinen Quelltext.
Auslöserichtlinie
Verwenden Sie diesen Workflow, wenn die Aufgabe vage, ästhetisch, strategisch, risikoreich, unvertraut, langlebig, in einem ungeprüften Codebereich oder wahrscheinlich mit versteckten Produkt-, Design-, API-, Sicherheits-, Daten-, Migrations- oder Betriebsbeschränkungen behaftet ist.
Starke Auslösephrasen sind „besser“, „sauberer“, „schön“, „intuitiv“, „produktionsreif“, „entscheid du“ und „wie X“. Verwenden Sie es auch vor der Erstellung eines großen Implementierungsplans, wenn die Implementierungsrealität dem Plan widerspricht, oder nach der Implementierung zur Einholung von Feedback von Prüfern/Stakeholdern, zur Pre-Merge-Erklärung oder für Workflows zum Verständnis von Änderungen.
Verwenden Sie diesen Workflow nicht für gewöhnliche Code-Reviews, Bug-Reviews, Security-Reviews oder PR-Fehlererkennungsanfragen. Diese Aufgaben benötigen reviewspezifische Methoden, keine Routinen zur Entdeckung von Unbekanntem. Halten Sie diesen Workflow schlank oder überspringen Sie ihn ganz, wenn die Änderung winzig, offensichtlich, direkt spezifiziert, mit geringen Auswirkungen verbunden oder billiger zu beheben als zu erkunden ist.
Betriebsregeln
- Vermeiden Sie Zeremoniell für winzige, offensichtliche Arbeiten. Wenn die Änderung direkt, risikoarm und gut spezifiziert ist, sagen Sie, dass die Unbekannten geringe Auswirkungen haben, und fahren Sie fort.
- Bevorzugen Sie die Inspektion des Territoriums vor Spekulationen. Lesen Sie relevante Dateien, Tests, Dokumentationen, Konfigurationen, Schemata, Logs oder Produktreferenzen, bevor Sie Risiken als Tatsachen darstellen.
- Bevorzugen Sie günstige Sonden vor irreversiblen Implementierungen. Verwenden Sie Mocks, Grep-Durchläufe, kleine Tests, Wegwerfskripte oder Referenzkarten, bevor Sie sich für eine große Architektur entscheiden.
- Stellen Sie jeweils eine hochwirksame Frage, wenn Benutzereingaben erforderlich sind. Priorisieren Sie Fragen, die Architektur, Datenmodell, UX, Sicherheitslage, Migrationsstrategie, öffentliche API oder Veröffentlichungsrisiko verändern würden.
- Erstellen Sie konkrete Artefakte. Ein nützliches Artefakt kann eine Risikotabelle, eine Semantikkarte, ein Mock, ein Entscheidungsprotokoll, eine Implementierungsnotizdatei, ein Buy-In-Dokument oder ein Quiz sein. Vermeiden Sie generische „Überlege X“-Listen ohne nächste Aktionen.
- Arbeiten Sie weiter, es sei denn, Sie sind blockiert. Wenn der Benutzer nicht verfügbar ist und das Risiko nicht architektur-/API-/sicherheits-/datenkritisch ist, wählen Sie die konservativste reversible Voreinstellung, notieren Sie die Annahme und fahren Sie fort.
Schnelle Triage
Klassifizieren Sie die Aufgabe, bevor Sie ein Playbook auswählen:
- Bekannte Bekannte: Anforderungen, die der Benutzer explizit angegeben hat.
- Bekannte Unbekannte: Offene Fragen, die der Benutzer bereits genannt oder klar angedeutet hat.
- Unbekannte Bekannte: Geschmack, Konventionen, Qualitätsstandards und Domänenerwartungen, die der Benutzer erkennen würde, sobald sie gezeigt werden.
- Unbekannte Unbekannte: Versteckte Einschränkungen, Verhalten, Risiken oder fehlendes Domänenwissen, das keine der beiden Seiten bisher aufgedeckt hat.
Klassifizieren Sie dann die Unsicherheit:
- Niedrige Unsicherheit, geringe Auswirkung: Direkt implementieren. Optional die eine verwendete Annahme notieren.
- Mittlere Unsicherheit: Ein fokussiertes Playbook ausführen und fortfahren.
- Hohe Unsicherheit oder großer Schadensradius: Das Repo inspizieren, einen Blindspot-Pass durchführen, dann zu Interview, Referenzsuche, Mock oder anpassbarem Plan weiterleiten.
- Plan steht während der Arbeit im Widerspruch zur Realität: Implementierungsnotizen verwenden und den betroffenen Teil neu planen.
- Arbeit ist erledigt, aber Verständnis oder Zustimmung fehlen: Ein Buy-In-Dokument oder Änderungsquiz verwenden.
Routing-Tabelle
Laden Sie nur die Playbooks, die für die aktuelle Aufgabe benötigt werden:
- Unvertrautes Codebasismodul, versteckte Einschränkungen oder risikoreicher Bereich: Lesen Sie
references/blindspot-pass.md. - Dem Benutzer fehlen domänenspezifisches Vokabular oder Expertenqualitätsstandards: Lesen Sie
references/teach-me-my-unknowns.md. - Vages Design, UX-Geschmack, „mach es schöner“, „intuitiv“ oder „wie X“: Lesen Sie
references/design-directions.md. - UX/Produktform ist vor Backend-, API- oder Zustandsarbeit unklar: Lesen Sie
references/mock-before-wire.md. - Lösungsraum ist offen und Kosten-/Risikoabwägungen sind wichtig: Lesen Sie
references/effort-axis-brainstorm.md. - Bekannte Mehrdeutigkeit erfordert Benutzerentscheidungen: Lesen Sie
references/interview.md. - Vorhandenes Implementierungs-, Produkt- oder Wettbewerberverhalten sollte die Spezifikation sein: Lesen Sie
references/reference-hunt.md. - Ein großer Plan steht kurz vor der Erstellung: Lesen Sie
references/tweakable-plan.md. - Die Implementierung offenbart eine Überraschung oder macht den Plan ungültig: Lesen Sie
references/implementation-notes.md. - Abgeschlossene Arbeit benötigt Zustimmung von Prüfern oder Stakeholdern: Lesen Sie
references/buy-in-doc.md. - Der Benutzer möchte eine große Änderung vor dem Merge verstehen: Lesen Sie
references/change-quiz.md.
Standard-Workflow
- Karte kurz zusammenfassen: Was der Benutzer gefragt hat und was bereits bekannt ist.
- Territorium inspizieren: Beweise aus der relevanten Repo-/Produktoberfläche sammeln, bevor Risiken bewertet werden.
- Höchste Auswirkung durch Unbekannte benennen: Dies kurz halten, es sei denn, der Benutzer hat um Erkundung gebeten.
- Weiterleiten: Ein oder mehrere Referenz-Playbooks aus der Tabelle auswählen.
- Handeln: Das angeforderte Artefakt erstellen, eine hochwirksame Frage stellen oder mit dokumentierten Annahmen implementieren.
Verwenden Sie diese kompakte Ausgabe, wenn kein spezialisiertes Playbook benötigt wird:
Unbekannten-Check:
- Bekannte Bekannte: ...
- Höchstes Risiko durch Unbekannte: ...
- Durchgeführte günstige Sonde: ...
- Annahme oder Frage: ...
- Nächste Aktion: ...
Beispiel-Routing
- Unvertrautes Codebasismodul: „SSO zu diesem Auth-Paket hinzufügen; ich habe es noch nicht angefasst“ ->
blindspot-pass.md, danntweakable-plan.md, wenn das Risiko hoch ist. - Vage Designanfrage: „Das Review-Dashboard sauberer und hochwertiger machen“ ->
design-directions.md, optionalmock-before-wire.md. - Bekannte architektonische Mehrdeutigkeit: „Soll dies im API-Gateway oder Worker leben?“ ->
interview.md, danntweakable-plan.md. - Referenzbasierte Implementierung: „Das Wiederholungsverhalten aus dieser Rust-Crate in unseren TypeScript-Client portieren“ ->
reference-hunt.md. - Abweichung während der Implementierung: „Das Schema unterstützt die geplante Migration nicht“ ->
implementation-notes.md, dann nur fragen, wenn der neue Pfad den Daten-/API-Vertrag ändert. - Pre-Merge-Quiz: „Sicherstellen, dass ich diesen Branch verstehe, bevor ich merge“ ->
change-quiz.md.