Research first – Erst recherchieren
Programmiere nicht basierend auf dem, was du glaubst, was die API ist. Überprüfe zuerst.
Du musst dies vor jeder nicht-trivialen edit- oder write-Aktion durchführen:
1. Recherche: research/findings/<thema>.md
- Überprüfe zuerst
research/findings/. Falls jemand das Thema bereits recherchiert hat, verwende die vorhandenen Erkenntnisse. - Durchsuche dann die Codebasis mit
grep. Führe eine Websuche durch, falls du externe Dokumentation benötigst. Verwende 2026 in deiner Suchanfrage, damit du aktuelle Dokumente erhältst. - Zitiere, was du gefunden hast. Falls keine Dokumentation existiert, schreibe ein kleines Repro, um die Hypothese zu überprüfen.
- Speichere die Ergebnisse in
research/findings/<slug>.md, damit die nächste Sitzung die Arbeit nicht wiederholen muss.
Vorlage:
# Erkenntnisse: <Thema>
Datum: 2026-09-04
Quellen: [URL, URL]
Vorhandener Code: `pfad:zeile`: was wir gefunden haben
## Bewertung
Empfohlener Ansatz: …
Alternativen: …
Risiken: …
2. Plan: research/plans/<aufgabe>.md
# Plan: <Aufgabe>
Recherche: research/findings/<thema>.md
Ansatz: …
Zu ändernde Dateien: [Liste]
Tests: …
Rollback: …
3. Freigabe
Zeige den Plan dem Benutzer. Beginne erst mit dem Programmieren, wenn der Benutzer zustimmt. Bei winzigen Einzeldatei-Änderungen kann die automatische Freigabeinstinkt dich durchlassen.
4. Implementieren und überprüfen
Setze den Plan um, führe Tests aus, harness bench --quick, dann harness memory sync, damit die nächste Sitzung sich merkt, was funktioniert hat.
Hinweise
- Falls bereits Erkenntnisse existieren, wiederhole sie nicht.
- Lies Dateien, um Fakten zu erhalten, rate nicht. Falls das, was du findest, deinen Erwartungen widerspricht, teile dies mit und vertraue der Datei.
- Nach Abschluss aktualisiere die Erkenntnisse mit dem, was tatsächlich funktioniert hat.
Nicht tun
editvorreadodergrep- Raten von API-Signaturen
- Überspringen des Plans, weil „es klein ist”, wenn du 3 oder mehr Dateien bearbeiten wirst